ClaimBarter

ClaimBarter

Install

1. Drop the jar in plugins/ next to GriefPrevention.
2. Restart. Editing config.yml afterwards needs only /claimbarter reload.

Requires GriefPrevention 16.18.7+ and Paper 1.21+. Declared as a hard dependency, so the plugin will not load without it.

Commands

Aliases: /barter, /cbarter.

One rule for the argument: it is always what you hand over. You buy with items, so buy counts items. You sell claim blocks, so sell counts blocks. This avoids the rounding trap where asking for 150 blocks at 100-per-ingot silently charges two ingots and pockets the difference.

Configuration

currency:
  item: IRON_INGOT       # any obtainable Material
  blocks-per-item: 100   # 100 blocks is a 10x10 area

selling:
  enabled: true
  refund-ratio: 0.5      # 1.0 refunds fully; below 1.0 makes buy/sell loops a loss

limits:
  max-purchased-blocks: 0   # 0 means no ceiling

Every message is in config.yml under messages: and uses & colour codes.

Bad values are refused at load with a specific reason in the console, and the plugin disables itself rather than running on a configuration it cannot honour.

What it deliberately does not do

• Only plain items count. A renamed or enchanted ingot is skipped, not spent. Sharing a material with the currency should not cost a player a keepsake or a quest item.
• Only the main inventory is searched — not armor slots, not the offhand, not ender chests.
• Selling draws from GriefPrevention's bonus pool, which is the same pool /adjustbonusclaimblocks writes to. If operators hand out bonus blocks and you do not want those cashed out for items, set selling.enabled: false. Blocks a player accrued by playing are never sellable — that would turn idle time into an item faucet.
• Blocks committed to existing claims cannot be sold. You have to abandon a claim first.