WorldBox Modding
You do not need to know WorldBox internals before you begin. Pick what you want to do, follow the shortest useful route, and only open deeper API or research when you actually need it.
One fact, four useful layers
Section titled “One fact, four useful layers”The WBML knowledge base is now published as one connected chain. Use only as much depth as you need:
Quick Docs may simplify the route, but they never override Detailed Docs or canonical machine evidence. The current integrated batch covers WBML 0.2.0 through 0.9.0; WBML 1.0 freezes the current-runtime baseline.
Where do you want to start?
Section titled “Where do you want to start?”
Interactive checklist: NeoModLoader → minimal mod → Player.log → first feature. No giant architecture first.
Start from a task such as save data, UI, events, Political World or world generation.
Start from the symptom. Do the short checks first, then inspect the log or relevant guide.
Common tasks
Section titled “Common tasks”
Generate the smallest useful skeleton and understand what every file is for.
Store values on kingdoms and understand save, reload and restart boundaries.
Use the API surface already tested by WorldBox Modding Lab instead of guessing from stale source.
Start from a real crash and the safer cloning order that actually worked.
Use verified terrain-height findings and follow world-generation research as it expands.
Start with Actor, City, Kingdom, Building or WorldTile Quick Docs, then drill into the evidence only if needed.
Use Recipes or Quick Docs. Both are organized around tasks/entities instead of requiring exact API names first.
Use these when checking something directly is faster than reading three more pages.
Extract versions, loaded mods and known error signatures locally in the browser.
MODMod GeneratorGenerate a minimal NeoModLoader or Political World addon skeleton.
APIAPI ExplorerSearch PoliticalWorldAPI plus selected canonical WorldBox/WBML behavior by task or subsystem.
VERCompatibilitySee exactly which versions and branches the evidence covers.
Your first successful mod
Section titled “Your first successful mod”Do not add systems until the basic mod actually appears in the log.
Use a minimal mod.json + Main.cs skeleton.
Check Player.log before debugging any game mechanic.
Pick one recipe and only then grow the mod.
What can I trust?
Section titled “What can I trust?”Current main research baseline: WorldBox 0.51.2 build 719 · NeoModLoader 1.2.0.1 · PoliticalWorldAPI 1.14.0 where applicable. Canonical WorldBox atlases are integrated through WBML 0.9.0; the 1.0 baseline is frozen. See the compatibility matrix →
Open final matrices, rejected harness assumptions, canonical machine data and the exact runtime evidence behind the quick answer.
If the docs or tools save you time, you can support continued research, testing and site development. Everything here stays free and open.