✨ 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:

🔄 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

Example: /givesaveblock "Fortress - Entrance" 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

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

📂 Data Storage

🔗 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: 1.21.4
• Latest Plugin Version: 1.4.1

• Built with DETERMINATION.

Disclaimer: DeltaSave is an independent fan-made plugin. It is not affiliated, endorsed by, or associated with Toby Fox and the DELTARUNE team in any way.