Logo
DeltaSave
PluginLicenseRef-All-Rights-Reserved

DeltaSave

Simple Deltarune-style saving system plugin for a Minecraft server.

60
Downloads
1
Followers
1 weeks ago
Updated
📦
7
Versions
utilitybukkitpaperspigot
Download Latestv1.4View on Modrinth

📖About DeltaSave

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

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.

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.