A Paper/Folia plugin port of Racks that adds wooden display racks for tools and weapons. Rewritten with SQLite storage, native ItemStack serialization, permissions, and added features like WorldGuard/GriefPrevention integration and multi-language support.

Requriements

• Minecraft: 1.21.11+
• Server: Paper/Folia or compatible fork
• Java: 21

Features

12 wood variants	Oak, spruce, birch, jungle, acacia, dark oak, mangrove, cherry, pale oak, bamboo, crimson, warped
Floor and wall racks	Two slots on the floor, one on a wall, each with its own frame and click areas
Per-player language	Each player reads their own client language; fully translatable, see Language
Custom item NBT data	Enchantments, custom names, lore and other NBT data survive being placed on a rack
Data pack migration	Racks left standing by the original data pack can be imported on request
WorldGuard / GriefPrevention	Breaking a rack or swapping its item is checked against regions and claims, if either plugin is installed

Crafting

Three planks in a row, two sticks below the ends. Any of the twelve woods works. Put it on the floor or hang it on a wall, and display your gear on it. Right-click to swap an item in or out, sneak and right-click to change how the items are angled, left-click to take the rack back down.

What a rack will hold

Floor racks take axes, hoes, pickaxes, shovels, spears, swords, maces, carrots on a stick, warped fungus on a stick and fishing rods. Wall racks take all of those plus bows, crossbows, tridents, shields, shears and spyglasses. Holding anything else and right-clicking does nothing at all.

This goes by the item's actual type, not its name or texture, so a reskinned axe, sword, bow and so on from ItemsAdder, Oraxen, Nexo or similar plugins goes on a rack the same as a vanilla one.

Commands

Command	Permission
/racks give <variant> [player] [count]	racks.command.give	Hand out a rack
/racks reload	racks.command.reload	Re-read config.yml and the language files

/rack is an alias.

Permissions

Node	Default
racks.use	true	Place racks, swap items, change pose, break them
racks.command.give	op
racks.command.reload	op

racks.use defaults to true because the data pack gated nothing. Out of the box the plugin behaves identically. Negate it for a group to restrict racks.

Language

Every message and item name ships in English and Vietnamese, and each player automatically sees whichever one matches their own client language. Operators can add more: drop a language/<locale>/messages.yml file next to the bundled ones and translate it, then /racks reload picks it up.

Protection plugins

Breaking a rack, swapping its item or turning it is checked against WorldGuard regions and GriefPrevention claims. Nothing needs configuring beyond having the protection plugin itself running. Putting a rack down is a normal BlockPlaceEvent, so both plugins already cover it.

Rack action	WorldGuard flag	GriefPrevention trust
Break	block-break	Build (/trust)
Swap an item, or turn the rack	interact	Container (/containertrust)

Operators and worldguard.region.bypass skip WorldGuard's checks. A GriefPrevention claim owner, anyone trusted, admin claims and a player's /ignoreclaims toggle are all respected already, with no extra permission to grant. See Protection Plugins for the full breakdown.

Migrating from the data pack

Warning

Remove the data pack before starting the server with this plugin. If both are installed they will fight over the same entities.

Set adopt-datapack-racks: true in config.yml (it is false by default) and the plugin imports racks the data pack left standing. It reads each one off the entities that make it up: the wood from the block its frame displays, the direction from the yaw those displays were turned to, the contents from what the item displays are holding, and even the pose, by matching the display's transform against the same tables the data pack applied. The old entities are then removed and a plugin-owned rack is built in their place, holding the same items in the same pose.

This happens per chunk, as chunks load, so a large world migrates gradually rather than all at once.

Two things cannot be recovered, because they lived only in the data pack's command storage, which has no API:

• The recorded owner is lost. The data pack stored it but never used it, and neither does this plugin.
• The creation time becomes 0, meaning "old enough to drop", the same way the data pack treated racks placed before its own 3.0.0.

Rack items already in players' inventories keep working with no migration at all; they are recognised by the custom_model_data string that has been on every version of the item. They are quietly re-stamped into the plugin's own form the next time their owner logs in, which is what gives them a name in the player's language instead of the data pack's fixed English.

Coming from Racks V.2? Run the V.3 data pack's from_v2 upgrade first. The plugin can only read V.3 racks.

Building

./gradlew build

The shaded jar lands in build/libs/Racks-<version>.jar. HikariCP is the only bundled dependency and it is relocated under com.racks.libs; the SQLite driver comes from Paper's own classpath.

./gradlew runServer

starts a Paper 1.21.11 test server with the plugin installed.

Documentation site

cd docs
npm install
npm run docs:dev

Credits

The original Racks data pack is by KawaMood

The rack designs, item textures, display transformations, poses, and every screenshot and recipe image on this page are KawaMood's work, used under the terms of the original license. Its plaque is relabelled here to identify this Paper and Folia plugin.

License

CC BY-NC-SA 4.0, the same license as the original data pack. See LICENSE.