Tome of Echoes

Tome of Echoes is a Paper and Spigot plugin that lets players store building blocks outside normal inventory space inside a magical Tome. Stored blocks become Echoes in the Rift, where they can be bound to Pages, withdrawn later, auto-deposited on pickup, or placed directly back into the world.

Features

• Store placeable block materials inside a Tome instead of carrying them in your inventory
• Bind materials to Pages for quick access
• Withdraw stored blocks when needed
• Place blocks directly from the Tome with placement mode
• Auto-deposit tracked pickups into the Rift
• Upgrade Tome capacity through configurable progression paths
• Separate storage by realm/world grouping
• SQLite-backed persistence with admin audit logging
• Built-in leaderboard, cull mode, admin inspection, and realm controls
• Optional Modrinth update checks for stable releases

How It Works

Players receive or craft a Tome of Echoes, then use it to manage stored building materials through a custom GUI.

Upgrading in Player Mode

When the plugin is using player mode, each player manages their own bound Pages and unlocked capacity.

Upgrades in player mode work per player, which means:

• Each player's Tome progression is tracked separately
• Unlocking additional Pages only affects that player's Tome
• Bound materials remain tied to that player's own Pages
• Storage and Page unlocks can still be separated by realm if your server uses realm-based storage

This makes player mode a good fit for survival progression, since players expand their own Tome over time instead of sharing a single server-defined setup.

By default, Tome capacity can be expanded through the configured upgrade paths, such as:

• Diamond-block crafting upgrades
• Netherite smithing upgrades

Admins can control upgrade behavior, slot limits, and progression in the config.

With the Tome, players can:

• Open the Rift and view stored Echoes
• Bind materials to Pages
• Deposit tracked blocks into storage
• Withdraw stacks back into their inventory
• Activate placement mode to place stored blocks directly into the world

Placement Mode

Tome of Echoes includes a placement mode that lets players build directly from stored Echoes without repeatedly reopening the GUI.

Once a block is attuned, players can right-click in the world with the Tome to place that stored material directly from the Rift. Each successful placement consumes one stored Echo, making the Tome function as a building tool as well as a storage system.

Placement mode is designed to make large building sessions smoother by reducing inventory clutter and keeping commonly used blocks ready at hand.

Pick Block Support

On Paper servers, placement mode also supports pick block as a convenience feature.

While holding the Tome, a player can middle-click a block to quickly switch the Tome's active placement material to that block, as long as the Tome already contains stored Echoes of it. This makes it easy to swap between building materials on the fly without reopening the Tome interface.

On non-Paper servers, the Tome's normal placement mode still works, but pick block integration is not available.

Sound Volume

Tome of Echoes uses Minecraft's Player sound channel, so players can control the plugin's audio volume with their normal in-game settings.

If a player wants the Tome to be quieter or louder, they can adjust:

Options -> Music & Sounds -> Player

This means the plugin does not require a separate volume setting for basic sound control, and each player can tune the experience to their own preference.

Server Features

Tome of Echoes supports both player-driven and server-defined tracking setups.

• Player mode: each player binds their own Pages
• Server mode: admins define shared tracked materials in the config

It also includes realm-aware storage, so different worlds can share or separate stored materials depending on your setup.

Commands

Player Commands

• /tome give
• /tome give <player>
• /tome leaderboard
• /tome cull [on|off|status]

Admin Commands

• /tomeadmin reload
• /tomeadmin inspect <player|uuid>
• /tomeadmin set <player|uuid> <material> <amount>
• /tomeadmin add <player|uuid> <material> <delta>
• /tomeadmin reset <player|uuid>
• /tomeadmin merge <player|uuid>
• /tomeadmin realm ...

Permissions

Primary permission nodes use the tomeofechoes.* namespace.

Common examples:

• tomeofechoes.use
• tomeofechoes.place
• tomeofechoes.autodeposit
• tomeofechoes.upgrade
• tomeofechoes.leaderboard
• tomeofechoes.cull
• tomeofechoes.admin.*

Deprecated pocketdimension.* aliases are still available for transition compatibility.

Requirements

• Java 21 or newer
• Paper or Spigot for Minecraft 1.21.x

Installation

1. Download the latest release
2. Place the jar in your server's plugins folder
3. Start or restart the server
4. Edit the generated config files if needed
5. Use /tomeadmin reload after config changes

Notes

• Only placeable block materials can become Echoes
• Placement mode respects normal block placement behavior and protection plugins
• Stable release update notifications can be checked through Modrinth

License

This project is distributed under a proprietary redistribution-only license. Unmodified official releases may be redistributed, but forks, modified redistributions, and derivative versions are not allowed without permission.