Reorganize

Reorganize — a Minecraft Paper plugin that lets players upgrade their own character attributes through an in-game GUI.

Spend attribute points, economy money, or items to grow your stats: max health, movement speed, attack damage, and 30+ more attributes.

Highlights

Four upgrade modes (per attribute)

• POINTS — attribute points given by admins or future triggers
• ECONOMY — server money (VaultUnlocked / Vault + any economy plugin)
• ITEM — pay with items from your inventory; supports custom items from other plugins (CustomModelData / PDC tags)
• FREE — admins only

Flexible pricing

• Fixed, linear, or exponential cost formulas per attribute
• Multiple item types per upgrade, each with its own quantity formula

Fair refunds

• Every purchase is recorded with the exact price paid
• Refunds always use your purchase history — even if the admin changes prices later, you get back exactly what you spent

In-game GUI

• Paginated attribute panel with live cost & refund previews
• Left-click +1 / Shift+Left +10 / Right-click -1 (refund)
• Slot layout, button materials, and click mappings are all configurable

Compact health bar

• Max HP above 20 renders as a single row of 10 hearts — no more multi-row health bars blocking your screen

Fully translatable

• Built-in English / Chinese / Russian packs; drop a custom lang/*.yml and switch in config
• Every player-visible message uses MiniMessage formatting

Commands

Command	Description
/reorganize	Open the attribute GUI
/reorganize info [player]	View attributes
/reorganize set <player> <attr> <value>	Admin: set a FREE-mode attribute
/reorganize points give/take/set <player> <amount>	Admin: manage points (works offline)
/reorganize reset <player>	Admin: reset all investments
/reorganize reload	Admin: hot-reload configs

Requirements

• Paper 1.21.x / 26.x server, Java 21+
• Economy plugin only needed for ECONOMY mode

Data & Safety

• Player data: async YAML saves, sync save on shutdown
• Transient attribute modifiers — nothing is left behind if you uninstall the plugin

---

This plugin was designed and implemented with AI-assisted development.