NationsX 1.0.0 · Paper 1.21.8 to 1.21.10

The Lands commands, on NationsX

Claiming, trust, areas, rentals, nations, wars and the full staff toolset. Everything below is generated from the plugin's own command list, so the syntax and permission nodes are the ones the server accepts.

162Commands

119For players

43For staff

157Permission nodes

Overview

Everything a Lands server is used to typing, running on the NationsX territory engine. The old /nation command still works exactly as before. The names end in X so they never collide with the Lands plugin.

Command	Used for
`/landsx`, `/lx`	Your land: claims, members, areas, rentals, travel, bank, camps, wars and every staff tool.
`/nationsx`, `/lxn`	Groups of lands: founding, capital, chat, diplomacy and nation wars.
`/lxclaim` `/lxunclaim` `/lxview` `/lxtrust` `/lxuntrust` `/lxassign`	Short forms of the commands you use most.
`/nation`, `/n`, `/nations`, `/nx`	The original NationsX command. Unchanged.

Land and nation are the other way round from what you might expect. A land here is a NationsX nation: it owns chunks, has members, a bank and a spawn. A nation is a group of lands. If you only ever used the old command, nothing about your nation changed.

How to read this page#

<value> is required, [value] is optional, and a value ending in dots takes the rest of the line.
Click a command to copy it. Click a permission to copy the node.
Press Ctrl K or / to search every command, description and permission.
Players only means the console cannot run it. Console too means it can.

Quick start

From nothing to a protected, shared, teleport-ready home in six commands.

Found your land and claim the first chunkStand where you want to build. This creates a land named after you; if founding costs money you are asked to run it again to confirm.
Grow itClaim a square around you. Several chunks show the price first; run the same command again to pay.
Let a friend buildTrust a player for a week. Leave the time off for permanent.
Mark out a shop and rent itStand in two corners, then name the area. Offer it for a price and a number of days.
Set a home pointAnyone with the right can then travel to it.
Check your bordersParticles trace your chunk edges until you turn them off.

Concepts

A handful of ideas explain every command on this page.

Term	What it means
Land	A NationsX nation. Owns chunks, members, a bank, a spawn and areas.
Nation	A group of lands under one capital land. Stored by the Lands layer in `lands.yml`.
Edit land	The land your commands act on. It is your own land unless you switched with `/landsx edit`. Staff with `lands.admin.command.edit` can edit any land.
Member and role	Members hold a NationsX rank (leader, officer, citizen, resident by default). A rank decides what the member may do in the land.
Trusted player	A non-member who can build, open containers and interact in the whole land, or in one area. Can expire.
Visitor	Everyone else. Visitors can only do what the land's flags and the global protection settings allow.
Flags	Natural flags (`explosions`, `fire_spread`, `pvp`, `mob_griefing`) override the global protection setting for one land. Role flags (`build`, `container`, `interact`) can grant a role more than its rank gives. They never take rights away.
`<target>`	A land name or tag, or a nation name. Where the syntax says `<land-or-all>`, `*` means every land.
Confirmation	Costly or destructive commands print what will happen and wait. Run the same command again within the confirm timeout (30 seconds by default).

Land basics

Creating a land, switching which land you are editing, and looking things up.

Menus and help#

Open the main Lands menu.

Console too

Show command help.

Console too

Create and manage#

Create a land.

Players only

Choose which land your commands apply to.

Players only

Delete your edit land.

Players only

Leave your edit land.

Players only

Rename your edit land.

Players only

Look things up#

Show player information.

Console too

Show land information.

Console too

List all lands.

Console too

Show the chunk map.

Players only

Claiming

Claim, unclaim, see your borders and draw selections. Anything that touches more than one chunk shows the price and waits for you to run it again.

Claim#

Claim here, founding a land named after you if needed. Shortcut: /lxclaim.

Players only

Merge another land into your edit land.

Players only

Toggle auto-claim while walking.

Players only

Claim empty chunks surrounded by your land.

Players only

Claim chunks around you.

Players only

Expand your border where you face.

Players only

Unclaim#

Unclaim this chunk. Shortcut: /lxunclaim.

Players only

Toggle auto-unclaim while walking.

Players only

Unclaim chunks around you.

Players only

Unclaim all chunks (needs confirmation).

Players only

Your chunks#

List claimed chunks.

Players only

Teleport to a claimed chunk.

Players only

Borders#

Show borders. Shortcut: /lxview.

Players only

Show borders at your location.

Players only

Keep border visualization on.

Players only

Turn border visualization off.

Players only

Selections#

Show your selection.

Players only

Set the first corner here.

Players only

Set the second corner here.

Players only

Clear the selection.

Players only

Expand the selection vertically.

Players only

Members and trust

Trust gives a non-member build, container and interact rights, optionally for a limited time. Roles are the NationsX ranks from config.yml.

Trust#

Trust a player land-wide.

Players only

Remove a player's trust.

Players only

Shortcut for member trust. Shortcut: /lxtrust <player> [duration].

Players only

Shortcut for member untrust. Shortcut: /lxuntrust <player>.

Players only

Trust a player in one area.

Players only

Remove trust in one area.

Players only

Roles and ownership#

Set a player's role.

Players only

Transfer ownership.

Players only

Bans#

Ban a player land-wide.

Players only

Unban a player land-wide.

Players only

Areas

An area is a named part of your land with its own members, bans and spawn. Areas are NationsX towns, so they also show on the map.

Create and shape#

Create an empty area.

Players only

Set your selection as the area's geometry.

Players only

Shortcut for area assign. Shortcut: /lxassign <area>.

Players only

Area members#

Trust a player in one area.

Players only

Remove trust in one area.

Players only

Set a role in one area.

Players only

Ban a player from one area.

Players only

Unban a player from one area.

Players only

Area spawn#

Teleport to the area's spawn.

Players only

Set the area's spawn here.

Players only

Rentals

Offer an area for rent and a tenant can build in it until the time runs out. Rent is paid into the land bank.

Landlord#

Show the area's rental information.

Players only

Offer the area for rent.

Players only

Rent an area of your edit land.

Players only

Remove a rental or sale offer.

Players only

Forcibly remove the tenant.

Players only

Tenant#

Cancel your rental as a tenant.

Players only

Show your rental.

Players only

List areas for rent.

Players only

Travel

Spawns, random teleport and the way out of a bad spot. Teleports use the NationsX warm-up and cooldown.

Teleports#

Confirm a teleport to an unsafe destination.

Players only

Teleport to a random place.

Players only

Teleport to a land spawn.

Players only

Set your edit land's spawn here.

Players only

Teleport out of an unsafe position.

Players only

Staff teleport#

Random-teleport another player.

Console too

Bank, chat and camps

The everyday things a land does besides owning chunks.

Bank#

Show the land bank balance.

Players only

Deposit into the land bank.

Players only

Withdraw from the land bank.

Players only

Taxes and upkeep#

Manage taxes.

Players only

Show upkeep.

Players only

Storage#

Open the land storage.

Players only

Chat#

Send a land chat message or toggle land chat.

Players only

Invites#

Accept a land invite.

Players only

Decline a land invite.

Players only

Relations#

Manage land relations.

Players only

Camps#

Open your camp, or create one.

Players only

Trust a player in your camp.

Players only

Remove a player from your camp.

Players only

Take your camp down.

Players only

Nations

A nation is a group of lands with one capital. It has its own chat, spawn and diplomacy, and it goes to war as one.

From /landsx#

Accept a nation invite for your edit land.

Players only

Decline a nation invite for your edit land.

Players only

Leave your edit land's nation.

Players only

Delete the nation (capital land only).

Players only

Found and find#

Create a nation.

Players only

List all nations.

Console too

Teleport to a nation's capital spawn.

Players only

Show your nation.

Players only

Show nation information.

Players only

Show command help.

Console too

Run the nation#

Delete the nation.

Players only

Rename the nation.

Players only

Set the capital land.

Players only

Invite a land to the nation.

Players only

Remove a land from the nation.

Players only

Shortcut for member trust.

Players only

Shortcut for member untrust.

Players only

Talk and diplomacy#

Send a nation chat message or toggle nation chat.

Players only

Manage nation relations.

Players only

War

Declaring, capture flags, KoTH and shields. The same commands exist under /landsx war for a single land and /nationsx war for a whole nation.

How a war plays out. Declaring puts the two sides at war through the normal NationsX diplomacy rules, so chunks can then be captured with sieges or with a capture flag item. If the defender set a KoTH point with war koth set, or an admin made an arena with a control point, a King of the Hill match starts: stand on the point with no enemy near it for 120 seconds and your side wins and the war ends. war spawn sends you to your team's arena spawn during a match, otherwise to your land spawn.

Under /landsx war#

Declare war on a land or nation.

Players only

Show war information.

Players only

Show capture flag information.

Players only

Teleport to the war spawn.

Players only

Place or move your KoTH point.

Players only

Decline a mutual war declaration.

Players only

Declare an independence war on your nation.

Players only

Under /nationsx war#

Declare war on a land or nation.

Players only

Show war information.

Players only

Show capture flag information.

Players only

Teleport to the war spawn.

Players only

Place or move your KoTH point.

Players only

Decline a mutual war declaration.

Players only

Server

Everything lives under /landsx admin. These need the matching lands.admin.command.* node and most work from the console.

Housekeeping#

Reload config, messages, menus and limit packs.

Console too

Delete lands whose members have all been inactive.

Console too

Dismiss new-flag notices.

Console too

Print debug information.

Console too

Print task debug information.

Console too

Import claims from a file.

Console too

List permissions detected for a player.

Console too

Chat spy#

Toggle chat spy for a land, a nation, or everything.

Players only

Limit packs#

Show the limit packs.

Console too

Refresh player limit packs.

Console too

Move numbered limit permissions into player-limits.yml.

Console too

Lands

Act on one land, or on every land with * where the syntax allows it.

Land tools#

Show limits for a land.

Console too

Add a custom role to a land or all lands.

Console too

Set a role or natural flag.

Console too

Reset one flag or all flags.

Console too

Remove the spawn from a land or all lands.

Console too

Set the war shield time.

Console too

Add or remove war shield time.

Console too

Set the land bank balance.

Console too

Add or remove land bank balance.

Console too

Players and items

Look at a player, clean up after one, or hand out the claim items.

Players#

Show all limits that apply to a player.

Console too

Delete stored Lands data for a player.

Console too

Give items#

Give claim block items.

Console too

Give camp items.

Console too

Give war capture flag items.

Console too

Give all enabled first-join items.

Console too

Data and world

Backups, moving databases, resetting a world, leaderboards and KoTH arenas.

Database#

Migrate data to another database type.

Console too

Run a database backup now.

Console too

Restore the database from a backup.

Console too

World#

Delete all claims and land spawns in a world.

Console too

Holograms#

Create a leaderboard hologram here.

Players only

List leaderboard holograms.

Console too

Delete a nearby leaderboard hologram.

Players only

War tools#

Force-end an upcoming or active war.

Console too

Designate your current area as a KoTH arena.

Players only

Place the arena's control point here.

Players only

Set a team's arena spawn here.

Players only

Remove the arena you are standing in.

Players only

List KoTH arenas.

Console too

Permissions

Every command lists its node. These are the groups they fall into.

Node	Default	Covers
`lands.command.*`	Everyone	Every `/landsx` player command.
`nations.command.*`	Everyone	Every `/nationsx` command.
`lands.admin.command.*`	Operators	Every `/landsx admin` command.
`lands.admin.command.edit`	Operators	Not a command. Lets staff manage any land or nation with the normal player commands after `/landsx edit`.
`lands.teleport.chunk`	Everyone	Teleporting to a claimed chunk from the chunk list.
`lands.teleport.land_spawn`	Everyone	`/landsx spawn` and `/nationsx spawn`.
`lands.teleport.random_teleport`	Everyone	`/landsx rtp`.
`lands.teleport.war`	Everyone	The war spawn.
`lands.teleport.sub_area`	Everyone	Area spawns.
`lands.teleport.unstuck`	Everyone	`/landsx unstuck`.
`lands.teleport.rentable`	Everyone	Registered for permission plugins. No command uses it yet.

Player nodes default to everyone and staff nodes to operators. Set a node to false in your permission plugin to take a command away. The NationsX bypass nodes (nationsx.bypass.build, nationsx.bypass.border) still apply to trust, bans and camps.

Configuration and files

Settings live in the lands section of config.yml. Reload with /landsx admin reload.

config.yml#

Key under `lands:`	Default	Meaning
`claim-radius-max`	5	Largest radius for claim radius, claim expand and unclaim radius.
`selection-max-chunks`	64	Largest selection an area can be assigned from.
`inactive-days`	60	Days every member must be away before `deleteinactive` proposes a land.
`nation-create-cost`	0.0	Charged from the capital land's bank when a nation is founded.
`rtp.radius`	5000	How far from the world centre a random teleport may land.
`rtp.cooldown-seconds`	60	Wait between random teleports.
`camp.minutes`	1440	How long a camp lasts.
`camp.radius`	0	Chunks around you a new camp covers. 0 is only your chunk.
`first-join-items`	[]	Items for new players. Forms: `claimblock:radius:amount`, `camp:radius:amount`, `captureflag:amount`, `MATERIAL:amount`.

Limit packs#

A pack gives bonus chunks to every member who holds its permission. Each member counts their best pack, and the land's limit is still capped by claims.hard-cap.

packs:
  vip:
    permission: nationsx.limit.vip
    chunks: 10
  elite:
    permission: nationsx.limit.elite
    chunks: 25

Files#

File	Holds
`plugins/NationsX/lands.yml`	Trust, bans, flags, spawns, nations, rentals, camps, holograms, KoTH arenas and land storage.
`plugins/NationsX/player-limits.yml`	Limit packs.
`plugins/NationsX/backups/`	Database backups written by `/landsx admin database backup`.

Differences from Lands

NationsX is not the Lands plugin, so a few things work differently. This list is complete.

Selections have no wand. Use /landsx selection pos1 and pos2.
Imports. /landsx admin import reads the NationsX JSON file format. It does not read other claim plugins.
Backups. Backup and restore need the embedded H2 database, and a restore needs a restart. On MySQL or MariaDB use your database's own dump tool. Migrate copies the data into an empty database of another type.
Admin menu. /landsx admin menu lists the staff commands in chat instead of opening a chest menu.
Role flags can only grant rights, not remove them.
Rentals. Ending a tenancy early gives no refund.
Limit packs add bonus chunks by counting as extra members, so the exact limit moves in steps of the per-member limit.
Rentable teleports. The lands.teleport.rentable node exists but no command uses it yet.

Added beyond the Lands list: selection pos1, pos2 and clear, claim tp, camp trust, camp untrust, camp remove, area rental offer, area rental rent and nations help.