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.

I am a solo developer on this project. Please report any bugs you find, or request features you'd like to see on my Discord

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 whenever needed
• Place blocks directly from the Tome with placement mode
• Auto-deposit tracked pickups into the Rift
• Share stored Echoes through Riftlinks, letting players build from a shared ledger
• 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.

Tome of Ehoes crafting recipe

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.

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

• Diamond-block crafting upgrades (disabled by default)
• Netherite smithing upgrades (enabled by default)

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

Riftlinking

Tome of Echoes also includes Riftlinking, a shared storage system for collaborative play.

A Riftlink allows multiple players to attune their Tomes to the same shared set of Echoes. Members of a Riftlink can deposit into the same ledger, withdraw from the same pool, and build from shared materials without having to pass blocks around manually.

This makes Riftlinking useful for:

• Group building projects
• Shared survival bases
• Community storage systems
• Cooperative progression with a single shared material pool

Riftlinks are designed to preserve the feel of the Tome while expanding it into a multiplayer-friendly system. Instead of every player managing only their own private Rift, trusted players can work from the same Echo ledger together.

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.

You can also turn all plugin sounds off using the /tome sound command

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]
• /tome sound [on|off|status]
• /tome riftlink create <name>
• /tome riftlink invite <player>
• /tome riftlink accept
• /tome riftlink info
• /tome riftlink members
• /tome riftlink leave
• /tome riftlink disband
• /tome riftlink kick <player>
• /tome riftlink transfer <player>
• /tome riftlink rename <name>

Admin Commands

• /tomeadmin reload
• /tomeadmin inspect <player|uuid>
• /tomeadmin inspect riftlink <name>
• /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.riftlink.use
• tomeofechoes.riftlink.place
• tomeofechoes.riftlink.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