Skip to content
Aithor Dev

Nation Configs

On this page

Government Files

Each government type reads its own file from plugins/NationCore/nations/.

Type File
Republic republic.yaml
Communist comunist.yaml
Monarchy monarcy.yaml
Caliphate caliphate.yaml

comunist.yaml (one m) and monarcy.yaml (no h) are the real file names the plugin looks for. Do not "fix" the spelling β€” the files will stop being read.

Shared blocks

creation

Present in all four files.

YAML
creation:
  display: "&bRepublic"
  description:
    - "&7Democratic system: regular elections, transparent cabinet,"
    - ""
    - "&7β€’ Leader: &fPresident (elected)"
  cost: 100000
  min-playtime-hours: 0
  starting-treasury-percent: 100
Key Default Description
display per type Name shown in the government picker
description per type Lore lines on the picker icon
cost 100000 Founding cost, withdrawn from the founder's Vault balance
min-playtime-hours 0 Minimum playtime before a player may found this government. 0 disables the check
starting-treasury-percent 100 Percentage of cost placed into the new nation's treasury (0–100)

leader_salary

Present in all four files. See Salaries.

YAML
leader_salary:
  enable: true
  cooldown: 24
  vault-points: 50000
  items:
  - diamond_block: 5
  - netherite_ingot: 3
  - enchanted_golden_apple: 10
Key Default Description
enable true Whether the head of state can claim a salary
cooldown 24 Hours between claims
vault-points 50000 Money paid from the treasury
items see above Item rewards. Accepts material: amount entries, "material:amount" strings, or a plain map

executive_order

Present in all four files. Lists which order ids each office may issue.

YAML
executive_order:
  president:
    - golden_age
    - war_economy
  minister_of_defence:
    - declare_war

The order ids themselves are defined in order.yaml. Removing an id revokes that office's access. An order disabled globally in order.yaml never appears, regardless of these lists.

Government Leader key Office keys
Republic president minister_of_defence, minister_of_treasury, minister_of_health
Communist secretary_general minister_of_propaganda, minister_of_defence, minister_of_treasury, minister_of_health
Monarchy king herald, marshal, chancellor, saint
Caliphate caliph (none)

republic.yaml

recall

YAML
recall:
  cooldown-days: 15
  signature-deposit: 50000
  collection-days: 7
  voting-days: 3
  required-percentage: 60
  required-signature-percentage: 30

See Recall Petitions.

cabinet

YAML
cabinet:
  daily-salary: 20000
  defense:
    prefix: "&4[MoD]"
    daily-vault: 30000
    decision-cooldown-hours: 48
  treasury:
    prefix: "&2[MoT]"
    daily-vault: 50000
    decision-cooldown-hours: 48
  health:
    prefix: "&d[MoH]"
    daily-vault: 25000
    decision-cooldown-hours: 48
Key Description
daily-salary Base amount every minister receives on claim
<office>.prefix Chat prefix for that office
<office>.daily-vault Extra amount for that office, added to daily-salary
<office>.decision-cooldown-hours Fallback cooldown for that office's decisions

election

YAML
election:
  registration-days: 3
  max-candidates: 3
  campaign-days: 7
  voting-days: 3
  inauguration-days: 1
  registration-fee: 500000
  campaign-message:
    min-chars: 10
    max-chars: 256
  campaign:
    broadcast-cooldown-hours: 6
    broadcast-cost: 10000
    endorsement-points: 10
  vote-weights:
    base: 1.0
    playtime-bonus: 0.5
    playtime-threshold-hours: 200
    level-bonus: 0.5
    level-threshold: 75
    balance-bonus: 0.5
    balance-threshold: 1000000
    max-weight: 2.5
  voter-rewards:
    participation: 10000
    lottery-bonus: 50000
    lottery-winners: 10

See Elections.

Two notes on this block:

  • Registration fees are non-refundable β€” every candidate's fee is forfeit into the state treasury when the election ends, win or lose.
  • Registration auto-closes at 2 candidates, a fixed cap in code. max-candidates is also checked, so lowering it to 1 works, but raising it above 2 has no effect.

president

YAML
president:
  term-length-days: 30
  max-consecutive-terms: 2
  cooldown-after-max-terms: 1
  requirements:
    min-level: 100
    min-playtime-hours: 100
    min-vault-balance: 500000
    min-endorsements: 10
    no-punishment-days: 30

presidential-games

YAML
presidential-games:
  cost: 100000
  max-per-term: 2
  duration-days: 7
  death-penalty: 5000
  safe-zone-immunity-seconds: 10
  afk-kick-minutes: 3
  killstreak-rewards:
    5: 10000
    10: 25000
    25: 100000
    50: 250000

See Presidential Arena. The related kill-reward (5,000), radius (100) and grand-prize (1,000,000) keys are also read from the merged configuration.

approval

YAML
approval:
  rating-cooldown-days: 7
  high-approval-threshold: 4.0
  low-approval-threshold: 2.0

comunist.yaml

politbiro

YAML
politbiro:
  daily-salary: 20000
  propaganda:
    prefix: "&d[Propaganda]"
    daily-vault: 25000
    decision-cooldown-hours: 48
  defense:
    prefix: "&4[Defense]"
    daily-vault: 30000
    decision-cooldown-hours: 48
  treasury:
    prefix: "&6[Treasury]"
    daily-vault: 50000
    decision-cooldown-hours: 48
  health:
    prefix: "&a[Health]"
    daily-vault: 25000
    decision-cooldown-hours: 48

communist

YAML
communist:
  election-cycle-days: 7
  tax-phase-minutes: 140
  tax-amount: 50
  free-food-interval-hours: 24
  free-food-cost-per-player: 1000
  free-food-bread: 16
  minister-weekly-salary: 10000
  market-event-bonus: 25
Key Default Description
election-cycle-days 7 Length of one Secretary General election cycle
tax-phase-minutes 140 One tax phase (7 Minecraft days, since 1 MC day = 20 real minutes)
tax-amount 50 Charged per member per phase
free-food-interval-hours 24 Interval between bread distributions
free-food-cost-per-player 1000 Treasury cost per online player
free-food-bread 16 Loaves handed to each online member
minister-weekly-salary 10000 Weekly stipend per office holder
market-event-bonus 25 Money bonus per villager trade while Market Event is active

This block is shared. Monarchy and Caliphate nations read tax-phase-minutes, tax-amount, free-food-* and minister-weekly-salary from this file, not from their own. Changing a value here retunes the Communist tax, the Royal tax and the Jizya β€” and all three distributions β€” at once.


monarcy.yaml

cabinet

Same shape as the Republic cabinet block, mapping to the High Council:

Config key Council seat
cabinet.defense Marshal
cabinet.treasury Chancellor
cabinet.health Saint

The Herald has no salary entry of its own in the default file.

executive_order

king, herald, marshal, chancellor, saint. The King is exempt from executive-order cooldowns.


caliphate.yaml

The simplest file: creation, leader_salary and executive_order.caliph only. There is no cabinet block, because the Caliphate has no ministers.

Reloading

Text
/nc admin reload

reloads config.yml, language.yml, all four government files, order.yaml, research.yml and the live-map settings.

Search documentation

    Type to start searching.