Start

Installation

Drop the jar in and restart. The rest of this page covers what appears on disk and what to look at if the first boot does not go cleanly.

Before you start

The plugin needs Paper 26.1.2 or a compatible build, and Java 25. There are no other dependencies and nothing to install alongside it. Spigot and CraftBukkit will not work, because the plugin uses Paper APIs that those servers do not have.

Installing

Download the jar from the releases page.
Put it in your server's plugins folder.
Restart the server. A reload is not enough for a first install.

On first boot the plugin creates plugins/Trimbound/ and writes three files into it.

File	What it holds
`config.yml`	Every setting: the trim scaling rules, the per-trim numbers, permissions and per-world switches.
`menu.yml`	The in-game guide opened with `/trimguide`. Slots, names, lore, and what an item looks like when its trim is off.
`lang.yml`	Every message the plugin sends. Set any message to `""` to silence it.

Checking it came up

You want one line in the log and no warnings after it:

[Trimbound] Trimbound enabled (0.1.0)

Then put on a full set of armor trimmed with the same material and run /trimbound status. It lists which trims it can see, how many pieces of each, and what power that works out to. If the trim you are wearing is not listed, the same command tells you why.

If you see an NMS warning

Two features reach past the normal server API: the Gold trim clearing a piglin's memory of being angry, and the Amethyst trim's through-wall glow. If Paper has renamed something they need, the plugin logs one warning, switches off that one feature, and keeps everything else running. It will not spam the console and it will not crash. The fix is a plugin update rather than a config change.

Updating

Replace the jar and restart. Your config files are left alone. When a new version adds a setting, the plugin writes just that setting into your existing file on the next boot and logs that it did it. Anything you have already changed stays changed.

The one case where it will not touch your file is when the file does not parse. A stray tab or a missing quote means the plugin reports the error, leaves your file exactly as it is, and runs on built-in defaults until you fix it. Nothing you wrote gets overwritten because of a syntax error.

Removing it

Delete the jar. On shutdown the plugin hands back anything it was holding, so redstone it was powering goes back to whatever the real circuit says, and anyone stuck mid-grip from the Resin trim gets their gravity back. No blocks are left in a strange state for you to clean up.