Installation
Persyaratan server, cara memasang tema, dan langkah pertama setelah aktivasi.
On this page
This page walks you through installing NationCore on a Paper server.
| Requirement | Notes |
|---|---|
| Paper 1.21.4 | The plugin is built against paper-api 1.21.4 and declares api-version: 1.21. Spigot may work but is not what the plugin is compiled and tested against. |
| Java 21 | The jar is compiled with release 21. An older Java will refuse to load it. |
| Vault | Required. NationCore disables itself on startup if Vault is missing. |
| An economy plugin | Vault is only a bridge. You also need a real economy provider (EssentialsX Economy, CMI, etc.). Without a registered Economy service the plugin disables itself. |
These are soft depends. NationCore runs fine without them and picks them up automatically when they are present.
| Plugin | What it adds |
|---|---|
| PlaceholderAPI | %nation_...% placeholders for scoreboards, tab lists and holograms. |
| squaremap | Draws nation borders and capitals on a live web map. |
| FactoryCore | Routes factory taxes into nation treasuries and asks permission before building on national soil. |
| ApartmentCore | The same, for apartments. |
- Stop the server. Never drop a plugin jar into a running server.
- Install Vault and your economy plugin first, if they are not already there.
- Copy
NationCore-2.0.0.jarinto theplugins/folder. - Start the server. On the first start NationCore creates its data folder and writes the default configuration files.
- Check the console. A successful start prints the NationCore splash screen
ending with
Status: SUCCESSFULLY LOADED. - Stop the server again, edit the configuration to taste (see config.yml), and start it one more time.
After the first start your plugins/NationCore/ folder looks like this:
plugins/NationCore/
βββ config.yml Main settings: capital, territory, integrations, live map
βββ language.yml Every player-facing message
βββ order.yaml The executive-order catalogue (names, cost, cooldown, effects)
βββ research.yml Research projects and their tuning values
βββ nations/
β βββ republic.yaml Republic settings (elections, cabinet, recall, arenaβ¦)
β βββ comunist.yaml Communist settings (politburo, tax phase, free foodβ¦)
β βββ monarcy.yaml Monarchy settings (high council, salariesβ¦)
β βββ caliphate.yaml Caliphate settings (leader salary, Caliph ordersβ¦)
βββ squaremap/ Live-map popup templates (only used with squaremap)
β βββ nation-popup.html
β βββ nation-tooltip.html
β βββ capital-tooltip.html
β βββ icons/ Optional custom capital icons
βββ data/ Saved game state as JSON β do not edit by handThe two government file names contain historical typos: comunist.yaml (one m)
and monarcy.yaml (no h). These spellings are what the plugin looks for, so
keep them exactly as they are.
Run these in-game or from console:
/nc help # should print the help header
/nc hub # opens the Nation Hub menu (players only)
/nc admin map status # live-map health, if squaremap is installedIf /nc says the command is unknown, the plugin did not load. Check the console
for an error β the most common cause is a missing economy provider.
- Stop the server.
- Replace the jar.
- Start the server.
Your data/ folder and edited config files are kept. New message keys added by an
update automatically fall back to the English text bundled inside the jar, so an
older language.yml never shows Message not found.
Always back up plugins/NationCore/data/ before a major upgrade. That folder holds
every nation, treasury and player record.