RepairShop 2.2.0

Released 27/09/2026. Built and verified against Paper 1.21.11, runs on Minecraft 1.9 → 26.2.

Pay with materials when money runs short

A player who cannot afford a repair used to be told so and that was the end of it. Now clicking the item opens a Pay with Materials screen with two ways to settle the bill, each showing exactly what it would take:

• Cash + Materials - every coin they have, materials for the rest. A player with 600 facing a 950 repair pays the 600 and hands over materials worth the other 350.
• Materials Only - no money at all.

Materials are drawn cheapest first, so a player keeps their diamonds if copper and iron will do, and any of them can be kept out of the payment with one click. When the last item overshoots, the overshoot comes off the cash; in materials-only there is no cash to take it from and the smith keeps it (giving change in money would make every blacksmith a place to sell materials). Nothing is taken until the player confirms, and if their money or inventory changed in the meantime the screen redraws instead of charging.

Only plain items count. Anything renamed, carrying lore, custom model data or a plugin tag is never offered and never taken, even if it is a diamond underneath.

Right-clicking an item opens the screen even when cash would cover it, and right-clicking Repair Everything pays for the whole lot the same way.

Material price groups

What each material covers is set in material-groups.yml, in named groups. default ships with 27 materials from charcoal (2) through iron (25), emerald (30) and diamond (120) up to netherite blocks; a worn-out diamond axe takes 9 diamonds to pay for, three times what the axe cost to craft. A new group starts as a copy of default and is then adjusted independently. Each shop can use its own group, follow the group assigned to its world, or take money only. Everything is managed in game with /repairshop materials (group list, per-material price editor, per-world assignment, and a new button in the shop editor) or by command.

The default group, cheapest first. "Covers" is what one item takes off a repair bill:

Blocks are worth exactly nine of their item. Materials a server version does not have (copper before 1.17, say) are skipped, and every value can be changed in game or in the file.

Update notifications

RepairShop now asks Modrinth, where it is published, whether a newer version is out: a few seconds after startup and then every 12 hours, entirely off the main thread. When there is one, the console is told once and admins are told when they join, with a clickable link. /repairshop version shows the running and latest versions; /repairshop version check asks again now. Configured under update-check in config.yml; any network failure logs one warning per session and is otherwise silent.

Fixed

• Repair log lines could be written out of order. Each line was appended by its own async task and the scheduler does not run those in sequence, so a "Repair All" line could land between the items it covered. Lines are now queued and written strictly in order.
• Chat prompts used a plain HashMap shared with the async chat thread; it is now concurrent.

Upgrading from 2.1.0

Delete the old jar. material-groups.yml is created on first start. The new config.yml sections (material-payment, update-check) work from the bundled defaults without editing your file, but add them by hand if you want to tune them. Existing shops follow their world's group until you pick one; a shop's file gains a material-group: key the next time it is saved.