✨ DeltaSave

"The power of saving shines within you..."

DeltaSave is a DELTARUNE-inspired checkpoint save system for Minecraft servers. Place sacred save blocks across your world, let players preserve their progress, roll back mistakes, and carry their adventure forward — all wrapped in a sleek, themed GUI experience.

💾 Installation

1. Download the latest .jar file from the versions page
2. Drop the downloaded .jar into your server's plugins/ directory.
3. Restart your server to generate necessary configuration files. If you're updating from a previous version, delete the old config.yml to generate the fresh version with new options.
4. Customize config.yml to your liking and restart your server again.

🏃‍♂️ Quick Start

1. Install the plugin using the installation instructions.
2. Give yourself some save blocks using /givesaveblock "<Name>" <Chapter>.
3. Scatter the save blocks around your RPG map.
4. Ask your friends to play your RPG game!

🌟 Features

💾 Checkpoint Save System

The heart of DeltaSave — a full-state save and load system that captures everything:

• 📍 Location — World, coordinates, and rotation
• ❤️ Health & Food — Including max health and saturation
• 🎒 Full Inventory — All 36 slots plus armor
• 🧪 Potion Effects — Every active effect preserved
• 🎮 Gamemode — Saved and restored seamlessly
• ⏱️ Playtime — Accumulated across all sessions

🔮 Save Blocks

Admins can craft unique save blocks tied to a location name and chapter. Players interact with these beacons to open the Save Menu — no commands needed. Save blocks are automatically scanned and unregistered if ever destroyed, keeping your world clean.

Standing on a save block? You might receive a message from the save gods.

🧱 Block Change Rollback

DeltaSave tracks every block placed and broken since the last save — held in memory for zero-lag gameplay. On /load, those changes are non-destructively rolled back, undoing only what happened after the last checkpoint. Intentional world changes stay safe on disk.

📦 Chapter-Based Storage

Every save block is assigned a chapter. The higher the chapter, the more storage pages a player unlocks — 18 slots per chapter, scaling infinitely. Storage persists across sessions and server restarts.

🖥️ GUI Interface

A beautiful, DELTARUNE-styled inventory GUI accessible from any save block:

| Menu | Description |
|---|---|
| SAVE | Save your current state and close the menu |
| CHECK | View your health, location, playtime, and block stats |
| STORAGE | Access your chapter-scaled persistent storage |
| DELETE SAVE | Two-step deletion with timed confirmation |

🔄 Auto Join & Respawn

• Players who rejoin are automatically loaded to their last checkpoint
• On death, players respawn at their last save — no manual intervention needed
• New players with no save are teleported to the configurable default spawn

📜 Commands

| Command | Usage | Description |
|---|---|---|
| /save | /save [player] | 💾 Save your (or another player's) game state |
| /load | /load [player] | 📂 Load from last checkpoint and roll back unsaved changes |
| /deletesave | /deletesave [player] | 🗑️ Delete a save file (double-confirm for self) |
| /saveinfo | /saveinfo [player] | 🔍 View detailed save data — location, health, playtime, blocks |
| /storage | /storage [player] | 📦 Open a player's persistent storage inventory |
| /givesaveblock | /givesaveblock "<Name>" <Chapter> | 🔮 Create a named save block beacon item |
| /setdefaultspawn | /setdefaultspawn | 🌍 Set the server's default spawn from your current position |
| /togglebeacongui | /togglebeacongui | 🚫 Toggle blocking of the vanilla beacon GUI |
| /scannow | /scannow | 🔎 Instantly scan for and unregister missing save blocks |

Example: /givesaveblock "Card Castle - ??????" 1

⚙️ Configuration

config.yml gives you full control over DeltaSave's behavior:

prefix: "§6[SAVE] §r"               # Chat message prefix
block-beacon-gui: true              # Block vanilla beacon GUI on right-click
scan-interval: 1200                 # Save block integrity scan frequency (ticks)
beacon-message-cooldown: 140        # Cooldown between motivational messages (ticks)
delete-confirm-timeout-gui: 160     # GUI delete confirmation window (ticks)
delete-confirm-timeout-command: 160 # Command delete confirmation window (ticks)

Fully customize every message, sound effect, and beacon flavor text straight from the config.

🔐 Permissions

| Permission | Description |
|---|---|
| deltasave.admin | Allows DeltaSave commands to be used instead of just using save blocks. |

Server Operators will automatically get deltasave.admin permission until revoked.

📂 Data Storage

| File | Contents |
|---|---|
| saves/<uuid>.yml | Full player save state |
| storage/<uuid>.yml | Chapter-scaled persistent item storage |
| saveblocks.yml | Registry of all placed save block locations |

🔗 Dependencies

Nothing. DeltaSave is a standalone plugin.

However, for permissions control, it would be beneficial to add permissions plugins such as LuckPerms or UltraPermissions.

🛠️ Compatibility

• Minecraft API: 26.1
• Latest Plugin Version: 1.4

• Built with DETERMINATION.