Lands and Nations: Difference between revisions

From
m (ToneXum moved page Lands and Nation to Lands and Nations without leaving a redirect: Damn typo)
(Add other section for nations)
Line 67: Line 67:


==== Other sub-commands ====
==== Other sub-commands ====
You can list all available sub-commands of <code>/lands</code> using <code>/lands help</code> or even <code>/lands help (sub-command)</code>. The latter will provide more specific information about a sub-command that may not be covered in this article.  
You can list all available sub-commands of <code>/lands</code> using <code>/lands help</code>. This will even list sub-commands not listed here.  


== Getting started with nations ==
== Getting started with nations ==
Line 90: Line 90:
==== Players ====
==== Players ====
Players that are trusted in a land that is part of a nation but not trusted in the underlying land are treated differently from players that are untrusted "normally". Namely these players may operate mechanisms in member lands, which includes interacting with doors, buttons and levers. They may also deposit money into the capital's bank, but not withdraw from it. They may however not place or break blocks and attack entities.
Players that are trusted in a land that is part of a nation but not trusted in the underlying land are treated differently from players that are untrusted "normally". Namely these players may operate mechanisms in member lands, which includes interacting with doors, buttons and levers. They may also deposit money into the capital's bank, but not withdraw from it. They may however not place or break blocks and attack entities.
==== Other sub-commands ====
You can list all available sub-commands of <code>/nations</code> using <code>/nations help</code>. This will even list sub-commands not listed here.

Revision as of 16:07, 20 September 2024

Admantum features the Lands plugin. It is both easy to use and well integrated onto our server. The plugin offers the creation and management of lands (also known as towns, claims or plots) and nations. The lands themselves offer grief protection and ways to manage the players in your land while nations offer the possibility of tying multiple lands together.

Getting started with lands

Creating a land

You can easily create a land using /lands create (name). Currently, a player is restricted to the creation of up to 3 lands

Managing your land

If you own multiple lands, it is important to know which one you are editing. Any command executed regarding a land will only affect the land you are editing. You can check which one it is via opening the land menu using /lands. This menu will show all lands that you either own or are trusted in. The land with the yellow player head and a white checkmark as its icon is the land you are currently editing.

Players

Use /lands trust (playername) to trust a player in your currently edited land. When a player is trusted in a land, they may place and destroy blocks, use doors, buttons, levers, bells and so on and attack and interact with entities in your land. To untrust a player in order to revoke these permissions, use /lands untrust (playername).

You can also ban players from your land using /lands ban (playername), which will prevent them entering your land. Likewise, you can execute /lands unban (playername) to undo this action.

Money

Money plays an important role in the economy. To check how much money your land currently has in its bank, execute /land balance. Players that are trusted in a land may also deposit money into its bank using /lands deposit (amount), however only the owner of the land may withdraw from it using /lands withdraw (amount).

Another notable feature of a land's economy are taxes. The owner of a land can set taxes using the land menu (/lands). When taxes are non-zero, the value at which they are set will be taken off of the balance of each member of a land every 24h[needs confirmation].

Claimed land must also pay upkeep to the server. You can view the upkeep of your land using the land menu (/lands). Note that the rate is calculated linearly on a per-chunk basis. When it is time to pay upkeep, the amount will be deducted from the bank of your land first. If the bank does not contain enough money to pay the upkeep, the server will try to deduct the amount from your own balance. If that fails as well due to lack of capital, portions of the land will be unclaimed until you can pay the upkeep.

Area

A land most notably consists of area which it spans across. The claim system on Adamantum is chunk-based which means that all lands have a claim resolution of one chunk. To claim a chunk for the land that is currently being edited, the owner of that land may use /lands claim. In order to claim for a specific land, the owner may use /lands claim (land name). Claiming is also possible automatically using /lands claim auto which will claim every chunk you walk into automatically for the edited land. The easiest method of claiming a certain area is to outline it using automatic claiming. When the area is then fully enclosed, you can use /lands claim fill to claim the entire area which your land encloses. (note that you will have to stand inside a wilderness chunk inside your enclosed area for this command to work)

Be aware that there is currently a bug in the map which will make an enclosed area appear as if it was fully claimed when it is not.

When claiming chunks, they are free up until 250 chunks. After that every claimed chunk will costs 0.5$. Any land may only claim up to 1250 chunks.

You can unclaim chunks using /lands unclaim which also supports the same arguments as claim which is most notably auto.

Lands for non-owners

A member of a land may invite you to it. When that happens you can either accept using /lands accept or deny using /lands deny. If you plan to accept the invite, note the taxes. When you become a member of a land, you will become "trusted". This will mean that will be able to place or break blocks, interact with doors and mechanisms such as buttons and bells and interact and attack entities within the land including players.

When you are a member of a land you may also:

  • deposit money into the lands bank
  • invite other players to a land

However, you may not:

  • claim or unclaim chunks
  • withdraw money from a land's bank

Restrictions

A summary of all restrictions regarding lands:

  • a player may only create 3 lands at a given time
  • a player may only be trusted in up to 10 lands
  • a land may only contain 1250 chunks

Other useful things

Quick travel

A member of a land may teleport to a land's spawn using /lands spawn (name). The owner of the land may set where the spawn point of a land is using /lands setspawn which will set the spawn point for the edited land to the current position of the player. Note that you may not quick travel to other lands.

Renaming a land

The owner of a land may rename it using /lands rename (new name). When renaming a land, you can add formatting and color codes to the name. This will influence the formatting and color of the land's name when it is rendered. This includes the banner that appears when entering a land and the text in the lands menu.

For formatting codes refer to this page from the old Minecraft wiki. Note that you will have to replace the "§" (paragraph) with an "&" (and) and that only codes with an ANSI escape equivalent are supported.

Deleting a land

The owner of a land may delete it using /lands delete (land name). The player will also be asked for confirmation. This can be avoided for convenience by adding confirm at the end of the command.

Regions

-> See main article Land Regions

Regions allow for more specific configuration of permissions and settings within a land. They are most commonly used to grant or revoke permissions in certain areas inside a specific land. To get started with Regions, open the land menu (using /lands) and select "Regions".

Being stuck inside a land

It is possible that one gets stuck in a foreign land. This can happen when you fall into a hole for example and are unable to get out due to lack of permissions. In this case, you can use /lands unstuck to immediately teleport to the nearest chunk of wilderness.

Other sub-commands

You can list all available sub-commands of /lands using /lands help. This will even list sub-commands not listed here.

Getting started with nations

The Lands plugins also offers the formation of nations. Nation can be used to bundle multiple lands together under one name and change the color of the lands on the map.

Creating a nation

To create a nation, one can simply execute /nations create (name). This will also assign your currently edited land to your newly created nation.

Managing your nation

If you are part of multiple nations, which is possible by being trusted in multiple lands not belonging to the same nation, it is important to know with what land you are editing the nation with. You can check by opening the lands menu (using /lands) and searching for the land with a yellow playerhead with a white checkmark on it as the icon. When editing a nation, it is recommended to use the capital as the editing nation.

The capital

Every nation has a land set as its capital, which will initially be the land the nation was created on. The capital land does not have special benefits but is treated differently when paying upkeep. Namely, that is it the primary source of money. When paying upkeep the amount of it is deducted from the capital land. If the capital does not have enough money in its bank, the server will try to deduct the amount from the balance of the nation's creator. If that player does not have enough money as well, the nation will be deleted.

A nation's capital can be changed by the creator of the nation using /nations setcapital (land name).

Lands

Land can be invited into a nation much like player are invited to lands. To invite a land into a nation, its creator must execute /nations trust (land name). To remove a land from a nation, its creator may execute /nations untrust (land name). Note that the nation will have to pay upkeep for all lands that are part of it and also note that, that upkeep is much higher than it would be without a nation. The upkeep of a nation is payed every 48h[needs confirmation].

Another feature of nations are taxes. The nation's creator may set a tax that will be deducted from the bank of each member land every 24h[needs confirmation].

Players

Players that are trusted in a land that is part of a nation but not trusted in the underlying land are treated differently from players that are untrusted "normally". Namely these players may operate mechanisms in member lands, which includes interacting with doors, buttons and levers. They may also deposit money into the capital's bank, but not withdraw from it. They may however not place or break blocks and attack entities.

Other sub-commands

You can list all available sub-commands of /nations using /nations help. This will even list sub-commands not listed here.