Skip to content
Aithor Dev

Languange

On this page

language.yml

Every player-facing message lives in plugins/NationCore/language.yml. Edit it to translate the plugin, restyle its colours, or change its tone.

Reload with:

Text
/nc admin reload

Fallbacks

Your file is backed by the copy bundled inside the jar. If an update adds new message keys and your file is older, those keys resolve to their English default instead of rendering as Message not found. You never have to regenerate the file after an update β€” though adding the new keys lets you translate them.

Top-level sections

Section Contents
general Prefix, permission errors, player-only errors, unknown command, reload confirmation
commands One block per command: help, government, stats, admin, create, nation, leave, disband, confirm, capital, diplomacy
tax The global tax display: status, amounts, intervals, debts, admin confirmations
system Internal systems: research, nation, territory, landpermit, webmap, managers
republic Republic-specific text: register, endorse, executive_orders, arena

Formatting

MiniMessage

The modern tag syntax is fully supported:

YAML
success: "<green>Nation <gold>{name}</gold> created!</green>"
warning: "<red><bold>WARNING</bold></red> <yellow>This cannot be undone.</yellow>"

Legacy colour codes

&-prefixed codes also work:

YAML
prefix: "&6[NationCore]&r"

Do not mix an & code and MiniMessage tags in the same message. A message containing & is routed through the legacy parser. This matters for URLs β€” a map link containing & is deliberately sent through the Adventure API rather than a MiniMessage tag for exactly this reason.

Centering

Prefix a message with <centered> to have it padded to the middle of the chat window. The plugin measures real character pixel widths, so centering works with proportional fonts:

YAML
title: "<centered><yellow>βš– NationCore Help βš–"

A centered message is sent without the plugin prefix.

Placeholders

Curly-brace placeholders are substituted by the calling code. Which ones exist depends on the message β€” look at the default value to see what is available.

YAML
info_treasury: "<gray>Treasury Balance: <green>${balance}"
relocate_cooldown: "<red>Capital relocation is on cooldown. Remaining: {time}.</red>"
claim_success: "<green>Claimed chunk ({chunk_x}, {chunk_z}) for {name}{fee}.</green>"

Common placeholders: {name}, {nation}, {player}, {leader}, {amount}, {cost}, {balance}, {time}, {type}, {level}, {count}, {id}, {chunk_x}, {chunk_z}, {world}.

The prefix

YAML
general:
  prefix: "&6[NationCore]&r"

Most messages are sent with this prefix. Centered messages and messages sent "raw" (broadcasts, announcements) skip it.

Examples

Translate to another language

YAML
general:
  no_permission: "<red>Kamu tidak punya akses ke perintah admin!"
  player_only: "<red>Perintah ini hanya untuk pemain!"
  player_not_found: "<red>Pemain tidak ditemukan!"

Restyle without translating

YAML
general:
  prefix: "&8[&bNations&8]&r"
commands:
  help:
    title: "<centered><aqua>β—† Nations Help β—†"

Shorten a long warning

YAML
commands:
  disband:
    warning: "<red>Disband {name}? This cannot be undone."

Notable message groups

Group Used by
system.research.* Starting, cancelling and completing research
system.territory.* Every claim, release and relocation outcome
system.landpermit.* Permit applications, decisions and refusal reasons β€” including the text NationCore sends on behalf of partner plugins
system.webmap.* /nc map, /nc map color and /nc admin map status
system.nation.* Nation creation and membership
system.managers.* Salary, order, election and cabinet notifications
republic.arena.* Every Presidential Arena message

Tips

  • Keep {placeholders} intact β€” removing one means the value is simply not shown.
  • Keep YAML quoting: values containing : or starting with a special character must be quoted.
  • Test after editing with /nc admin reload β€” a YAML syntax error is logged to the console.
  • Back up your edited file before a major plugin upgrade.

Search documentation

    Type to start searching.