Skip to content
Aithor Dev

Introduction

On this page

Integration Overview

NationCore is designed to sit at the centre of a server's plugin ecosystem. It talks to other plugins in three ways.

1. Hard requirement

Plugin Why
Vault Every money movement goes through Vault. NationCore disables itself on startup if Vault or an economy provider is missing.

2. Soft depends it consumes

These are declared in plugin.yml as softdepend, so NationCore loads after them when they are present, and runs fine when they are not.

Plugin What it adds Page
PlaceholderAPI ~90 %nation_...% placeholders PlaceholderAPI
squaremap Live web map of nation borders and capitals squaremap

3. Plugins that consume NationCore

These call into NationCore through the public API. They do not need to be on the classpath at build time β€” the API is built only from JDK and Bukkit types so partner plugins can bind to it reflectively.

Plugin What it does Page
FactoryCore Routes factory taxes into the owning nation's treasury, and asks permission before building on national soil FactoryCore
ApartmentCore The same, for apartments ApartmentCore
Anything else Territory lookups, tax routing and land permits Developer API

The two-key principle

Every cross-plugin money or land integration requires both sides to enable it. NationCore has its own switch in config.yml, and the partner plugin has a matching one. Nothing moves until both are on.

This is deliberate: neither server operator can be surprised by money appearing in a treasury or a build being blocked because the other plugin was updated.

YAML
# NationCore side
integration:
  factory-tax:
    enabled: true
  apartment-tax:
    enabled: true
  land-permit:
    enabled: true
YAML
# Partner plugin side
integration:
  nation-tax:
    enabled: true
  nation-land-permit:
    enabled: true

Where policy lives

All policy lives on the side that owns the resource:

  • Money policy (share percentage, per-payment cap, audit logging) lives in NationCore, because NationCore owns the treasury.
  • Land policy (who may build, rate limits, expiry, exemptions) lives in NationCore, because NationCore owns the territory.

A partner plugin that is outdated, buggy or hostile therefore cannot move more money than the operator authorised, and cannot grant itself territory.

Safety contract

The public API never throws and never returns null where a value is expected. If NationCore is mid-disable or not yet fully initialised, calls degrade to "no nation / nothing routed" rather than failing. Keeping that contract frozen is what lets the plugins version independently.

Search documentation

    Type to start searching.