✯Kumandra's Economy[1.16-26.2]✯

WHY THIS PLUGIN EXISTS

Most economy plugins give you a number attached to a player name. That is the easy part. The hard
part is giving that number somewhere to come from and somewhere to go.

Kumandra's Economy was built for my own survival server, where the currency needed to actually
circulate. Players needed to earn without grinding a command, spend without a shop plugin bolted on
the side, and move goods to each other without meeting up in person. So the plugin does the
banking, and it also does the seven jobs that pay into it, the public shops that take payment out
of it, the player-to-player trading that moves it sideways, the courier system that ships goods
across worlds, and the quest system that gives new players a reason to leave spawn.

It is one plugin, one config, one data file. Not an economy suite with six add-ons to keep
version-matched.


WHAT YOU GET

Economy that works as primary, secondary, or standalone

Run it as your server's main currency and every Vault-aware plugin sees it as the money. Or run it
alongside an existing economy as a second currency, with an in-game exchange screen that converts
between the two at a rate you set. Or run it with no Vault at all. That last one is new in 2.0, and
everything except cross-economy exchange works exactly the same.

Accounts create themselves on first join. Balances survive restarts. Admins adjust them from a
command that now works from the console too.

Seven jobs that pay for playing normally

• Farmer: harvesting crops, breeding livestock
• Lumberjack: chopping logs including nether stems, planting saplings
• Miner: mining blocks and ores, at separate configurable rates
• Hunter: slaying hostile mobs
• Guardian: killing mobs near villagers, within a radius you set
• Builder: placing the blocks you decide count
• Fisherman: fishing, with a bonus for rare catches

Income shows on the action bar as it is earned. Players join and leave jobs from a GUI, and you
decide how many they can hold at once. Anti-farming guards stop the same block being cycled for
repeat pay.



Public shops built in the world, not in a config file

Staff place a shop, stock it by arranging an ordinary chest and cloning it in, then set prices item
by item in-game. Players click to buy with their balance. Stock and prices persist across restarts.
No separate shop plugin, no sign syntax to memorise.

Live player trading

Send a trade request, both players get a shared window, items go in, either side sets a price, both
confirm. Requests expire on a timer you set. The window blocks the slots it should block, and
closing it returns every item to its owner.



Courier delivery, across worlds

Four service tiers, Cheap, Regular, Fast and Priority, each with its own price and delivery time.
Pick a recipient, pick a tier, load the goods. A courier animal spawns, lifts off, and travels to
the recipient with a particle trail behind it. Works between players in different dimensions.

Quests that give the money somewhere to start

Quest givers appear near players on a chance and interval you configure. Right-click one and it
opens as a written book you accept with a click. Tasks cover killing, mining, chopping, placing,
crafting and feeding. Rewards are experience, money, or an item. Progress reports on the action bar
as it happens.

(Quests need Minecraft 1.17 or newer.)



Storage that suits your setup

Local YAML by default, with nothing to configure. Or turn on MySQL in one file and get server-wide
storage with the driver already bundled inside the jar. If the database is unreachable, the plugin
says so and falls back to local storage instead of silently losing the write.

Translatable

Every message comes from a language file. Turkish ships with the plugin. A key you have not
translated falls back to English rather than printing an error.


WHY 2.0 IS WORTH THE UPDATE



It actually knows what server it is on now

The old version identified your server by checking whether the version text contained "1.16",
"1.17" or "1.18". A 1.19 server matches none of those. Neither does 1.20, 1.21 or 26.2. So on any
server newer than 1.18, the plugin decided it was older than 1.16 and quietly switched off the
entire quest system, nether logs for the Lumberjack, and the Fisherman's rare catches, with nothing
in the console to tell you.

2.0 parses the version as numbers and compares them. That is what makes one jar cover 1.16 through
26.2, and it is what will keep it covering whatever ships next.

Vault is optional

You no longer install a second plugin just to use this one. With Vault it behaves exactly as
before. Without it, everything works except cross-economy exchange, which needs a second economy to
exchange with anyway.

The Vault side was badly broken, and is fixed

If you ran this as your primary economy, other plugins were getting some genuinely bad answers out
of it. format() returned null, so shop plugins printed prices as the word "null".
createPlayerAccount() always returned false, so plugins that create an account and then pay
concluded the economy had refused the player. Balance lookups by world returned zero when the
player stood somewhere else, so money appeared to vanish through a nether portal. All rewritten.

Three job settings that were costing you money

Ore income never worked, because the ore list was being filled into the wrong list, so ores paid at
the plain-block rate. Builder income read the wrong config key and could silently be zero.
VillagerRadius was in the config and never read at all.

Custom Enchantments 3 integration

Running my Custom Enchantments 3 plugin? Kumandra now detects it, lists it as an integration, and
loads the bundled CE quest pack so quests can reward CE gear. Without CE the pack stays unloaded on
purpose.

And a long list of fixes



COMPATIBILITY

• Servers: Spigot and Paper, 1.16 through 26.2, one jar, no per-version builds
• Java: 8 and up, so a 1.16 server on Java 8 and a 26.2 server on Java 25 both load it
• Dependencies: none required
• Optional: Vault, Custom Enchantments 3, MySQL
• No NMS, no packet manipulation, no reflection into server internals, no obfuscation

It is pure Spigot API on purpose. That is what makes a ten-year version range possible from one
file, and it is why a Minecraft update does not mean waiting on me before your server can start.


COMMANDS

/kd is an alias for /kumandra. Both commands tab-complete.

PERMISSIONS


INSTALLING

1. Drop KumandrasEconomy.jar into your plugins folder
2. Restart the server
3. Open plugins/KumandrasEconomy/config.yml and set Separate_Economy. Use false to make Kumandra your main currency, or true to run it alongside an existing economy
4. Restart once more

That is the whole setup. Everything else has working defaults.

Upgrading from 1.x: replace the jar and restart. Your config is upgraded in place and backed
up as old_config.yml first, so your settings are kept and new settings arrive with their
defaults. Player and shop data are unchanged in format. If you were running on 1.19 or newer,
expect quests to start appearing. They were switched off before.


FOR DEVELOPERS

There is a small, stable API for reading and moving Kumandra balances from your own plugin.

Add softdepend: [KumandrasEconomy] to your plugin.yml. Every 1.x method keeps its exact
signature and return values, so existing integrations keep working unchanged.

There is a full guide in the repository at docs/developer-api-guide.md. It covers getting
the API, every method, what the return values mean, threading, worked examples, and
troubleshooting.


SUPPORT

Bug reports and feature requests are welcome. Please include your server version, the plugin
version, and the console output if something threw.

I also make Custom Enchantments 3, which this plugin integrates with. If you run both, the
quest system can hand out CE gear.