Show off your tools. Adds wooden display racks for tools and weapons. No resource pack required.

A Paper and Folia plugin port of Racks, the Minecraft data pack by KawaMood.

Documentation · Original data pack · Changelog

---

Craft a wooden rack, 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.

It's a port of the original data pack, so the item, the recipe and the poses all look the same. What's different is underneath: racks and everything on them save automatically to their own database, so nothing is lost across a Minecraft version upgrade.

• Minecraft: 1.21.11
• Server: Paper (and forks) or Folia
• 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
Poses	Six arrangements on the floor, four on a wall, cycled with sneak + right-click
Persistent storage	Placed racks and their contents live in plugins/Racks/racks.db, and survive a restart
Per-player language	English and Vietnamese included; each player reads their own client language
Folia support	A rack is only ever touched from the thread that owns its block
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

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.

Installing

1. Drop Racks-<version>.jar into plugins/.
2. Remove the Racks data pack first if you were using it. See Migrating.
3. Start the server.

No resource pack is required. The rack item is a player head with a custom skin and the rack itself is built from vanilla fences and buttons, so it looks right on a vanilla client. The item still carries the data pack's custom_model_data strings, so an existing Racks resource pack keeps working if you have one.

Crafting

Three planks in a row, two sticks below the ends. Any of the twelve woods works.

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.

Configuration

plugins/Racks/config.yml:

language: en_US
language-auto-detect: true

database:
  file: racks.db

settings:
  ignore-wall-rack-support: false
  wall-support-check-interval: 10

protection:
  worldguard: true
  griefprevention: true

adopt-datapack-racks: false
recipes-enabled: true
update-checker: true

ignore-wall-rack-support is off by default, matching the data pack: a wall rack drops itself when the block it hangs on is removed. Turn it on and wall racks stay put with no support, and the periodic check stops running.

wall-support-check-interval is how often, in ticks, hanging racks re-check their support. The data pack scheduled this every 10 ticks. The plugin runs one task per chunk that actually holds a wall rack, so a server with none schedules nothing.

recipes-enabled turns the twelve crafting recipes off, leaving /racks give and your own loot tables.

update-checker looks up the newest release once at startup and tells operators when there is one, in chat and in the console. Nothing is downloaded. Modrinth is asked first, with the GitHub releases page as a fallback. Needs a restart to take effect.

worldguard and griefprevention, under protection, each check their matching plugin before a player breaks a rack or swaps its item. See Protection plugins below. Either can be turned off without touching the other, and both are ignored when that plugin is not installed. Putting a rack down is a normal block placement, which both plugins already cover.

Languages

plugins/Racks/language/en_US/messages.yml and vi_VN/messages.yml ship with the plugin. Add your own by creating language/<locale>/messages.yml. It is picked up on the next /racks reload, no plugin update needed.

With language-auto-detect: true each player sees messages in their own client language, falling back to language: and then to en_US. Set it to false to put everyone on one language, which is how the data pack behaved.

Note

Item names are baked into the item rather than re-rendered per viewer, so a rack is named in the language of whoever received it. On a mixed-language server that means racks named in different languages will not stack with each other. Set language-auto-detect: false if you would rather they always did.

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: Modrinth · YouTube · Discord · kawamood.com

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

Plugin port by Nighter.

License

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