Govern • Trade • Thrive
A next-gen civilization & geopolitics layer for Minecraft
Warning
This README is for version 1.0-ARGON which is currently unreleased. Versions pre 1.0 are unstable and there will be NO SUPPORT for them. Do not bother opening issues for them, just wait for 1.0!
- Nation & province system built on chunk claims
- Legislative workflow: propose → debate → vote → enact
- Dynamic economy with item-backed currency and inflation controls
- Diplomacy: treaties, embargoes, alliances, wars
- Eco-simulation (pollution, resource depletion, climate events)
- EventBus & API for addon modules
Status: Rewrite in progress (
v1.x/ codename Argon).
Watch this space for new releases!
- Download the latest WorldDynamicsEngine jar from the releases page.
- Drop it into the
/pluginsfolder of a Paper/Spigot 1.21.x server. - Start the server once to generate default configs.
- Edit
plugins/WorldDynamics/config.ymlas needed. /wde reloadto apply changes.
Everything lives in plugins/WorldDynamics/config.yml.
Below is a cheat-sheet of the keys you’ll touch most often.
WDE currently piggy-backs on Towny for land and Vault for economy, keep those hooks enabled unless you know what you’re doing.
| Section / Key | Default | Purpose / Notes |
|---|---|---|
general.language |
en |
Locale for all messages. |
general.autosave-interval |
600 |
Ticks between automatic DB flushes (30 s). |
integration.towny-hook |
true |
Required until WDE has its own claiming; false = plugin aborts. |
integration.vault-hook |
true |
Enables Vault API for currency balance & formatting. |
integration.towny-events-cache |
100 |
Recent Towny events held in RAM for quick look-ups. |
legislature.vote-duration |
180 |
Seconds players have to vote on a bill. |
economy.currency-item |
EMERALD |
Physical item backing WDE’s internal currency. Ignored if vault-hook is true. |
debug.log-level |
INFO |
INFO, DEBUG, or TRACE for extra console detail. |
After editing, run /wde reload or restart the server to apply changes.
Full command & node reference will live in the wiki; below is just the “starter kit.”
All commands use /wde as the root alias.
| Command (short form) | Permission | What it does |
|---|---|---|
/wde (no args) |
wde.use |
Shows help / version banner. |
/wde reload |
wde.admin.reload |
Reloads config files without restart. |
/wde nation create <name> |
wde.nation.create |
Founds a new nation (Towny-backed). |
/wde nation disband |
wde.nation.disband |
Disbands the player’s nation. |
/wde bill propose "<title>" |
wde.legislature.propose |
Starts a vote. |
/wde treasury deposit <amount> |
wde.economy.treasury |
Deposit to nation treasury. |
/wde debug perf |
wde.debug |
Shows per-module TPS impact. |
Wildcard nodes
wde.*– everythingwde.admin.*– reload, migrate, debugwde.nation.*– create, manage, disbandwde.legislature.*– propose, vote, cancelwde.economy.*– treasury, tax, trade
Towny interaction
- Land claiming remains Towny commands / nodes (
/town claim, etc.). - WDE only checks Towny’s ownership data; no extra perms needed there.
Tip
Give staff wde.admin.* + the usual Towny admin nodes, and fine-tune later.
Note
Moved to the Projects tab.
- Fork the repo and create a feature branch (
feature/my-cool-thing). - Make sure
mvn clean packagepasses with no warnings. - Follow Google Java style; run IntelliJ’s auto-formatter before committing.
- Submit a PR and fill out the template—screenshots/logs help reviews.
- Docs PRs are welcome too (typos, examples, new pages).
Tip
Open a Draft PR early if you want feedback while you code.
| Need help with… | Where to go |
|---|---|
| Bugs / crashes | Open a GitHub Issue with full stack-trace & steps. |
| Feature ideas | Issue tracker or start a Discussion thread. |
| Quick questions | Search existing issues first, then start a discussion! |
Please avoid private DMs; public threads keep info searchable for everyone.
WorldDynamics Engine is released under the GNU General Public License v3.0.
See LICENSE for the legalese.
TL;DR: free to use, modify, and redistribute, just keep the source open and credit the project.