5 Worth System

5 - Worth System

Main file: plugins/Divinity/worth.yml

Worth is the base value used by economy-facing features. worth.yml owns the number; the Sell module owns the selling GUI and flow.

Files and relationships

• worth.yml — material/item value rules.
• modules/sell/settings.yml — selling GUI.
• modules/drops/ and modules/loot/ — reward sources that can feed the economy.
• Items can also expose SALE_PRICE through their stats.

The bundled default is intentionally empty:

worth.yml — bundled default

worth-calculator: {}

Start with common drops and custom items, then test the Sell GUI. If a module applies a multiplier, adjust the base value before changing the multiplier.

Administrator notes

• The bundled worth.yml is empty, so economy features require server-specific prices before they are useful.
• Back up the file and spreadsheet-test representative item values before importing a large price table.
• Verify Vault and exactly one supported economy provider before enabling money-based repair, merchant, or selling features.
• Test stack sizes, custom items, damaged items, generated items, and items with SALE_PRICE to prevent duplication or unintended payouts.
• Review Drops, Loot, Money, Repair, and Sell together; they form one economy loop.

See 08 - Modules and Sell.