The nations system
Avatarverse has a unique system for handling its nation states, somewhat similar to plugins like Factions, Towny, or Kingdoms. Nations are complex objects containing provinces, settlements, resource nodes, citizens, and ranks.
Geofeatures
A geofeature is something with a geographical domain, an object that takes up space. The nation system has several types of geofeatures, the most fundamental being the chunk.
- Nations
- Provinces
- Settlements
- Nodes
- Chunks
Chunks
To understand nations, we must first understand chunks. A chunk is a rectangular prism of a width of 16 blocks and a height spanning from Minecraft's minimum to maximum height.
The chunk is the building block of the nation system's geofeatures.
Further reading
Provinces
A province is a group of chunks. Provinces have names and are always owned by a nation. They also have a color, which is a randomized derivation of their parent nation's color.
Nations
A nation, at its fundamental level, is a group of provinces. Nations also have a variety of settings that set them apart from other nations, such as a unique name, color, and banner. They also have a set of ranks, at the top of which is the nation leader, and a settlement they count as their capital. Nations have a population of citizens as well.
Settlements
A settlement is a protected group of chunks within a province. It is a subset of a province and is owned by whichever nation owns the province. Only members of a settlement's parent nation can build/destroy in the settlement, unless they are placed on that settlement's whitelist.
Nodes
A node is a protected group of chunks within a province that can overlap with settlements and has special properties that differentiate it from settlements. Nodes also have whitelists, although the members of the whitelists aren't individuals but whole nations who are permitted to use the node.
Ranks
Each nation has a rank system that is completely customizable according to the nation leader's needs. Each rank has a numerical priority from 1 to 100, with 1 denoting the lowest priority, a regular citizen, and 100 denoting the highest priority, the nation leader.
Ranks are displayed in front of a character's name in all chat channels and contain a set of nation permissions. The rank can either possess or lack access to a certain nation permission, allowing or prohibiting a certain nation action or command.
Nation permissions
| Name | Description |
|---|---|
| Interact | Ability to interact in settlements |
| Build | Ability to build in settlements and nodes |
| Open | Ability to open containers and doors in settlements |
| Settings | Ability to edit nation settings |
| Manage Provinces | Ability to manage provinces within the nation |
| Manage Ranks | Ability to edit rank settings |
| Edit Ranks | Ability to change the ranks of those lower than them |
| Banish | Ability to banish people |
| Invite | Ability to send and revoke invites |
| Mint | Ability to mint currency |
| Whitelist | Ability to whitelist others in settlements and nodes |
Commands
For an overview of nations commands, please see our commands article.