Enigma Storage

A powerful Minecraft storage plugin for Paper servers. Store millions of items in a single block, connect them with a wireless mesh network, and access your storage from anywhere inside its mesh. No mods or client installation required; an optional resource pack is offered automatically on join.

Built for Paper servers. Inspired by Applied Energistics 2.

enigmanorth.ltht.app · Modrinth

---

Storage items carry their data in NBT, while placed Server Rack inventories are saved to racks.yml. Automatic backups and scheduled restoration provide an extra recovery option. Build a Server Rack, drop in a Wireless Router or two, mount (or just slap) a terminal on the wall - and your entire base storage becomes one, sortable, hopper-automatable grid.

---

The Hardware

Enigma Storage is built around a handful of physical blocks you place, link, and grow into a network. Here’s what you get.

Server Rack

Your storage core. Slot in storage cells, add trusted players, and hook up hoppers for fully automated I/O. Each rack projects a mesh zone with a 16-block radius on each axis around itself - the foundation of your network.

Wireless Router

Need more reach? Drop a Wireless Router. It extends the mesh with a coverage cube with a 64-block radius on each axis and chains off your existing network - bind it to your rack and place it so its zone overlaps the existing network, and your range grows organically across the base. Link enough of them and scale it across your entire base.

Wall Terminal

A flush terminal that mounts right on the wall. Walk up, open it, and browse your linked rack's contents in-place - perfect for a clean, panel-lined storage room.

Wireless Terminal

The same storage grid, in your hotbar. Bind it with a Link Module and access your Server Rack from anywhere inside the mesh - mine, fight, build, and deposit loot without ever walking home.

---

Features

Storage

• 6 storage cell tiers: 1K / 4K / 16K / 64K / 256K / 1M, with configurable capacity limits
• Sort by name, count, container order, or ID
• Lock a rack to its owner and add trusted players; locks stay active when the server language changes
• Hopper I/O with adjustable speed and Speed Upgrades

Automation

• Feed a sorter input buffer with hoppers and route items to linked racks
• Breaking a sorter drops its buffered items

Mesh Network

• Coverage is a real, in-world cube around every node - no abstract “range numbers” to guess
• Server Racks anchor the network (16-block radius); Wireless Routers extend it (64-block radius)
• Routers must be linked to a rack and overlap an existing zone to connect
• Tune both radii in the config (rack-range, router-range)

Terminals

• Wall Terminal - mounted, in-place access for storage rooms
• Wireless Terminal - bind with a Link Module and reach your storage from anywhere in the mesh

Custom Recipes

• Craft Enigma gear at a special workbench (dispenser)
• Browse every recipe in an in-game recipe book with page navigation
• Create custom recipes through the recipe editor; deposited ingredients and result items are returned when you close it

Backups & Restore

• Automatic ZIP backups on startup and every 6 hours by default; keep the latest 3 regular backups
• Create a backup with /es backup, or browse copies with /es backup list
• Archives contain racks.yml, RecipeData.yml, and a reference copy of config.yml
• /es backup restore <name> schedules restoration for the next server start, restoring racks and recipes while leaving the current config unchanged
• Current data is saved to a separate pre-restore_*.zip before restoration
• Cancel a pending restore with /es backup cancel
• Automatic backups skip unchanged data and include a guard against suspicious drops in rack count
• Backups live in plugins/EnigmaStorage/backups/; these are plugin-data backups, not full world backups

Languages

• Ships with: ru, en, de, fr, es, pl, cn, ja, hi, ko, ar
• Drop a .json into languages/ and point the config at it to add your own

WorldGuard integration (optional)

• Soft-dependency - works fine without it, no errors if WorldGuard isn't installed
• Blocks placement, break, terminal linking, and storage access inside protected regions
• Storage access follows the explicit enigma-storage-use flag; when unset, region membership/build checks apply
• Custom region flag enigma-storage-use for fine-grained per-region control
• Fails closed by default - a broken WorldGuard check denies access rather than silently letting griefers through

Lands integration (optional)

• Soft-dependency - works fine without it, no errors if Lands isn't installed
• Land owners decide who may use the storage system on their claim
• Custom role flag enigma_storage_use, toggleable per role in the Lands flag menu
• Falls back to the native INTERACT_CONTAINER flag if the custom flag is unavailable
• Hopper automation is checked against the rack owner's role, so your own automation
  follows the land permissions of the rack owner
• Fails closed by default, same as the WorldGuard integration
• With both plugins installed, an action needs approval from both - enabling Lands
  can never weaken an existing WorldGuard setup

---

Installation

1. Drop EnigmaStorage.jar into plugins/.
2. Start the server.
3. Tweak plugins/EnigmaStorage/config.yml to taste.

The optional resource pack is offered on join when loadresourcepack is enabled. If a player declines it or the download fails, resourcepackmessage controls the fallback message and download link.

---

Commands

All commands use /es - aliases /enigmastorage and /dsu work too.

Item keys for /es give include: server_rack, router, wall_terminal, terminal, link_module, receiver, sorter_wrench, speed_upgrade, creative_storage_container, and the storage_cell_* / storage_container_* families.

---

Permissions

The player-facing permissions below default to everyone so people can build out of the box; the rest default to op.

---

Config

loadresourcepack: true   # offer the resource pack on join
resourcepackmessage: true # show a fallback link if declined or download fails
prefix: "&f&l[&9&lEnigmaStorage&f&l]"

# Mesh network coverage (cube radius per axis, in blocks)
rack-range: 16           # Server Rack base zone
router-range: 64         # Wireless Router zone (must overlap an existing zone to link)

# Resource pack download URL
resourcepack:
  url: "https://cdn.ltht.app/EnigmaNorth/EnigmaStorage-v1010.zip"

# Optional update notifications from Modrinth
update-checker:
  enabled: true
  notify-ops: true
  modrinth-slug: "enigma-storage"

language: "en"           # en, ru, de, fr, es, pl, cn, ja, hi, ko, ar - or a custom file in languages/

# WorldGuard anti-grief (optional)
worldguard:
  enabled: true
  protect-build: true    # protect placing/breaking Enigma blocks
  protect-access: true   # protect opening GUIs, upgrades, terminal linking, hopper I/O
  fail-open: false       # false = deny on internal WG error (recommended)

# Rotating ZIP backups in plugins/EnigmaStorage/backups/ (racks.yml, RecipeData.yml, config.yml).
# Automatic backups run on startup and every interval-hours, skipping unchanged data.
# /es backup forces a manual copy, even if automatic backups are disabled.
# /es backup restore <name> applies on the next start (config.yml is not restored).
backup:
  enabled: true
  interval-hours: 6
  keep: 3               # how many backups to keep

# Lands anti-grief (optional). Combined with WorldGuard via AND: a deny from either wins.
lands:
  enabled: true
  protect-build: true    # protect placing/breaking Enigma blocks
  protect-access: true   # protect opening GUIs, upgrades, terminal linking, hopper I/O
  fail-open: false       # false = deny on internal Lands error (recommended)

# Storage limits (applied at craft time)
countinstacks: false     # count limits in stacks instead of single items
1kmax: 1
4kmax: 4
16kmax: 16
64kmax: 64
256kmax: 256
1mmax: 1024

---

Join us ❤️ - we build plugin ports and share them (and yes, there are 🍪)

Made by the Enigma North team. Based on DeepStoragePlus by Darkolythe. Licensed under GNU GPL v3.