Skip to content
Aithor Dev

Permissions

On this page

Permissions

NationCore declares the following permissions in plugin.yml.

Full list

Permission Default What it allows
nation.vote true Voting in elections
nation.register true Registering as an election candidate
nation.endorse true Endorsing candidates
nation.donate true Donating to a treasury
nation.president false President-only commands
nation.cabinet false Cabinet member commands
nation.tax true Viewing tax information
nation.tax.exempt false Exemption from global taxes
nation.create true Founding a new nation
nation.join true Joining an existing nation
nation.capital true Managing the nation capital (claim, teleport)
nation.landpermit.bypass op Building factories and apartments inside any nation's territory without asking its head of state
nation.map true Getting a clickable live-map link with /nc map
nation.map.color true Choosing the nation's colour on the live map (heads of state)
nation.admin op All admin commands and every in-game override

Defaults explained

Default Meaning
true Everyone has it
false Nobody has it until it is granted
op Only server operators have it

nation.admin β€” the master override

nation.admin does much more than unlock /nc admin. Throughout the plugin it also bypasses in-game authority checks. A holder can:

  • Disband any nation
  • Claim, release and relocate territory in their own nation, bypassing the leader-only check
  • Open any nation's Settings menu
  • Approve or deny any nation's land-use permits
  • Start and cancel any nation's research
  • Set any nation's map colour
  • Build inside protected territory
  • Appoint and dismiss Shura Council members and State Scholars
  • Bypass Communist Media Censorship

Grant it carefully.

nation.landpermit.bypass

Intended for staff and build teams. A holder skips the entire land-use permit gate β€” factories and apartments can be raised on any nation's soil without an application.

The permission node is configurable:

YAML
integration:
  land-permit:
    bypass-permission: "nation.landpermit.bypass"

Which nodes are actually checked

Only four permissions gate behaviour in the current build:

Node Where it is checked
nation.admin Everywhere β€” admin commands and every authority override
nation.map /nc map and its subcommands
nation.map.color /nc map color
nation.landpermit.bypass The land-use permit gate (the node name is configurable)

The remaining nodes are declared but not enforced. They describe intent, and their features are gated by menu access and by who holds which office rather than by a permission check:

Node What actually gates the feature
nation.create Nothing β€” any player may open /nc create. The real gate is cost and playtime
nation.join Nation Hub access
nation.capital Leadership β€” only the nation leader may claim or relocate
nation.vote Election phase and nation membership
nation.register The registration requirements in republic.yaml
nation.endorse Election phase and nation membership
nation.donate Treasury menu access
nation.president / nation.cabinet Actually holding the office
nation.tax / nation.tax.exempt Nation membership and the nation's tax switch

Setting one of the unenforced nodes to false will not block the matching feature. If you need to restrict those, use the configuration values that do gate them β€” founding cost, playtime requirements, election requirements, and the per-nation tax toggle.

Leave them at their defaults unless you have a specific reason to change them.

A typical permission plugin setup:

YAML
# Default group β€” everything players need
default:
  permissions:
    - nation.create
    - nation.join
    - nation.capital
    - nation.vote
    - nation.register
    - nation.endorse
    - nation.donate
    - nation.tax
    - nation.map
    - nation.map.color

# Build team
builder:
  permissions:
    - nation.landpermit.bypass

# Staff
admin:
  permissions:
    - nation.admin

Search documentation

    Type to start searching.