?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacksServers
Settings
DeltaSave

DeltaSave

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

53
1
53
1

Compatibility

Minecraft: Java Edition

26.1.x
1.21.x
1.20.x

Platforms

Links

Report issues View source

Tags

Creators

Details

Licensed ARR
Published 3 months ago

โœจ 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.