OD's Economy

A comprehensive Paper economy plugin with land claims, dealerships, interest, lottery, gambling, bounties, banknotes, and transaction logging.

Author: OD Plugins
Supported MC versions: 1.21 – 26.1.2 (Paper)
API: Paper 1.21+

Features

Feature	Description	Config Section
Economy	Balance, pay, top balances, give/take/set (admin)	`settings`
Sell	Sell items from your hand for configured prices	`sell-prices`
Land Claims	Register chunks to players, query ownership	`mregister` / `mcertification`
Dealerships	Player-owned shops with bulk ordering	`dealerships`
Interest	Periodic interest on player balances (disabled by default)	`interest`
Lottery	Ticket-based lottery with auto-draw and house cut	`lottery`
Gambling	Dice-style double-or-nothing, location-restrictable, command-block support	`gambling`
Bounties	Place bounties on players; killer collects on death	`bounties`
Banknotes	Physical money items (PersistentDataContainer-backed)	`banknotes`
Transaction Log	Logs all balance changes to file (PLAIN or CSV)	`transaction-log`
Dynamic Help	`/ecohelp` only shows commands the player can use	—

Commands

Player Commands

Command	Permission	Description
`/balance [player]`	`odseconomy.balance`	Check your or another player's balance
`/baltop`	`odseconomy.baltop`	Show richest players
`/mtransfer <player> <amount>`	`odseconomy.pay`	Send money
`/sell`	`odseconomy.sell`	Sell the item in your hand
`/worth`	`odseconomy.worth`	Check sell value of held item
`/mcertification <x> <z>`	`odseconomy.certification`	Check chunk owner
`/mcertification <player>`	`odseconomy.certification`	List player's chunks
`/dorder <item> <amount>`	`odseconomy.order`	Place a dealership order
`/dorder confirm`	`odseconomy.order`	Confirm pending order
`/dinquire <player\\|dept>`	`odseconomy.inquire`	Check dealership info
`/dice <amount>`	`odseconomy.dice`	Gamble on a dice roll
`/lottery buy [tickets]`	`odseconomy.lottery`	Buy lottery tickets
`/lottery info`	`odseconomy.lottery`	Check lottery details
`/bounty set <player> <amount>`	`odseconomy.bounty`	Place a bounty
`/bounty list [player]`	`odseconomy.bounty`	List active bounties
`/mnote <amount>`	`odseconomy.banknote`	Create a physical banknote

Admin Commands

Command	Permission	Description
`/mgive <player> <amount>`	`odseconomy.admin`	Grant money
`/mset <player> <amount>`	`odseconomy.admin`	Set balance
`/mtake <player> <amount>`	`odseconomy.admin`	Remove money
`/mregister <x> <z> <player>`	`odseconomy.admin`	Register a chunk
`/dgive <dept> <player>`	`odseconomy.admin`	Grant a dealership
`/mreload`	`odseconomy.admin`	Reload config

Permissions

Node	Default	Description
`odseconomy.*`	op	All permissions
`odseconomy.admin`	op	Admin commands
`odseconomy.balance`	true	/balance
`odseconomy.baltop`	true	/baltop
`odseconomy.pay`	true	/mtransfer
`odseconomy.sell`	true	/sell
`odseconomy.worth`	true	/worth
`odseconomy.certification`	true	/mcertification
`odseconomy.order`	true	/dorder
`odseconomy.inquire`	true	/dinquire
`odseconomy.dice`	true	/dice
`odseconomy.lottery`	true	/lottery
`odseconomy.bounty`	true	/bounty
`odseconomy.banknote`	true	/mnote

Configuration

After editing config.yml, run /mreload to apply changes without restarting.

Key config sections:

settings:
  starting-balance: 0.0
  currency-symbol: "$"
  tablist-balance: true

interest:
  enabled: false
  rate: 0.01
  interval-seconds: 3600

lottery:
  enabled: true
  ticket-price: 100.0
  draw-interval-seconds: 86400
  house-cut-percent: 10

gambling:
  enabled: true
  dice-multiplier: 2.0
  require-location: false
  locations: []

bounties:
  enabled: true
  min-amount: 1.0
  max-amount: 100000.0

banknotes:
  enabled: true
  item-material: PAPER
  item-name: "&6Bank Note &7(%amount%)"

transaction-log:
  enabled: false
  format: PLAIN

Installation

Drop OdsEconomy.jar into your server's plugins/ folder
Restart the server (or use /reload)
Edit plugins/OdsEconomy/config.yml to your liking
Run /mreload to apply changes

Building from Source

git clone <repo-url>
cd OdsEconomy
mvn clean package

Output: target/OdsEconomy-1.0.0.jar