Skip to content
Aithor Dev

Installation

Persyaratan server, cara memasang tema, dan langkah pertama setelah aktivasi.

On this page

Installation

This page walks you through installing NationCore on a Paper server.

Requirements

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.

Optional plugins

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.

Steps

  1. Stop the server. Never drop a plugin jar into a running server.
  2. Install Vault and your economy plugin first, if they are not already there.
  3. Copy NationCore-2.0.0.jar into the plugins/ folder.
  4. Start the server. On the first start NationCore creates its data folder and writes the default configuration files.
  5. Check the console. A successful start prints the NationCore splash screen ending with Status: SUCCESSFULLY LOADED.
  6. Stop the server again, edit the configuration to taste (see config.yml), and start it one more time.

What gets created

After the first start your plugins/NationCore/ folder looks like this:

Text
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 hand

The 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.

Verifying the install

Run these in-game or from console:

Text
/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 installed

If /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.

Upgrading

  1. Stop the server.
  2. Replace the jar.
  3. 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.

Search documentation

    Type to start searching.