ItemSmith

0.1.0 — first release

Itemsmith is an in-game item editor for making unique rewards and handing them out after events. Everything is server-authoritative: the client draws the screens and proposes, the server decides what may change.

Editor

• Seven tabs: appearance, stats, components, abilities, aura, tooltip, raw NBT.
• Colour gradients across a name or a lore line.
• Twelve starting templates, so a reward can be one click from finished.
• Eight permission nodes, charged per edit. Somebody with itemsmith.appearance alone can rename an item and nothing else.
• LuckPerms when present, op levels as the fallback.

Visuals

• Auras: 17 patterns, 14 custom particles, 7 sound layers, shown when held, worn or dropped. Drawn client-side, so they cost the server nothing.
• Tooltips: nine panel presets plus vanilla, with an editor that reorders the rows they are built from. Panels are drawn from rectangles and the item's own accent colour, so nothing ships as a texture.
• Skins: ten original 3D weapon models and five flat trophies, each with an animated layer for the glow and the ornaments.

Library and moderation

• Save a finished item as a numbered limited edition and hand copies out by command or from the library screen.
• A journal records every edit and every handout, including which number went to whom. /itemsmith trace answers the same question for the item in your hand.
• Revoking an edition removes it from players who are online, from everyone else at their next login, and destroys any copy still sitting in a chest the next time someone opens it. A ledger records what the enforcement actually caught.

Commands

/itemsmith edit, journal, trace, library, give <player> <id>.

Requirements

Minecraft 1.21.1, NeoForge 21.1.0+, Java 21. Install on the server and on every client that should see the models, auras and tooltips.

Known limits

• Destruction on contact does not reach a shulker box sitting inside a chest. That copy dies when the box is placed and opened.
• There is no undo. The journal records what changed; putting it back is manual.
• A player who is already online and receives a revoked item by direct trade keeps it until their next reconnection.

151 automated tests. Every asset shipped is original. LGPL-3.0-or-later.