# 🏰 Mine-Play: Lands & Nations System

Welcome to the official guide for the Lands plugin on Mine-Play! This page explains how land claiming, upkeep, taxes, teleportation, and PvP systems work on our server β€” tailored for our unique gameplay rules.

---

## 🌍 Land Creation & Management

### πŸ”¨ Creating a Land

* **Cost:** `$1000`
* Must be created **before** you can claim land.
* The first land creation automatically claims the chunk you are standing in.

### πŸ“› Land Naming Rules

* **No spaces**: Spaces will be replaced with `_`.
* **Max Length:** 24 characters.
* **Formatting:** Chat colors, formatting codes, and numbers are allowed.
* **Renaming a Land:** Costs `$2000`, and can only be done once every **24 hours**.
* **Transferring Ownership:** Costs `$5000`.

### 🌐 Buffer Zone

* Lands and Nations both have a **buffer zone of 3 chunks Euclidean** around them.

> πŸ“˜ *Euclidean* means the distance is calculated as a straight line (β€œas the crow flies”), not just along the X or Z axis. Diagonal chunks count toward this radius.

### πŸ“ Claiming Chunks

* Lands **can claim non-contiguous chunks** (they do not have to touch existing claims).
* **First Chunk Cost:** `$100`
* **Incremental Increase:** Each subsequent chunk costs 10% more than the last, capped at `$300`.
* **Refund on Unclaiming:** 50% of the chunk's original cost is returned to the land bank.

---

## πŸ•οΈ Camps

* Temporary 1-chunk claim called a **Camp**.
* **Cost:** `$300`
* **Expires:** After 24 hours.

---

## πŸ’΅ Economy: Upkeep & Taxes

### πŸ›οΈ Upkeep System

* **Upkeep Cycle:** Every 7 days.
* **Cost:** `$3 per claimed chunk`
* If a land can't afford the full upkeep, the **most recently claimed chunks are unclaimed first**.
* **Grace Period:** Lands are **exempt from upkeep** if it comes due within 2 days of creation.
* **Land Bank Fallback:** If the land bank lacks funds, the **owner's personal balance is used**.

### πŸ’Έ Taxes

* Paid by land members **every 7 days**.
* **Minimum:** `$0`
* **Maximum:** `$500 per area`
* If a member cannot pay, they are **automatically removed** from the land.

### ⚠️ Payment Warnings

* The server will issue a warning **2 days before** upkeep or taxes are due if the bank is underfunded.

---

## πŸš€ Teleportation & Movement

### 🧭 Land Spawn

* First use of `/lands setspawn` is **free**.
* Changing spawn after that costs `$150` per change.

### πŸ“¦ Teleport to Land

* **Cost:** `$150` (goes to land's bank).
* **Delay:** 3 seconds of no damage.
* **Who Pays:** Only **untrusted players** are charged.

### 🌲 Wilderness Teleport

* Use `/lands wild` to teleport to a random location.
* **Cost:** `$200`
* **Cooldown:** Once every 10 minutes.

---

## πŸ” Trust & Membership

* Players **must be invited** before they can be trusted.
* You **cannot directly trust** a player without inviting them first.

---

## πŸ›‘οΈ PvP & Combat

* If you're **attacked by another player**, you become **PvP-tagged** for **30 seconds**.
* While tagged, you can be damaged or killed even in safe lands.
* **Combat Logging:** Logging out while tagged **results in death**.
* This system prevents abuse of land protections during combat.

---

## βŒ› Inactivity & Land Expiry

Lands will be **transferred or deleted** based on the owner's **playtime** and **offline duration**:

| Playtime   | Offline Expiry |
| ---------- | -------------- |
| 15 minutes | 7 days         |
| 30 minutes | 14 days        |
| 12 hours   | 30 days        |
| 1 day      | 60 days        |
| 30 days    | 80 days        |

* Once the owner surpasses the threshold, the land is **transferred** to the next most active member.
* If no members remain, the land is **deleted** automatically.

---

## 🧠 Admin Notice

* **Admins can see land chat.** Avoid using it to share sensitive information (e.g. passwords, personal data).
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9