🏰 TerritoryCore

Protect your land. Build your empire. Run your entire survival server from one plugin.

TerritoryCore is a full survival core for Paper: chunk claims, anti-grief, sieges, alliances, economy, shops, auctions, teleports, kits, moderation, scoreboard, tab list, and quality-of-life tools — designed as one coherent system, not a pile of disconnected plugins.

Supported: Minecraft 1.20 → 1.21+ and year-based Paper versions (26.x) · Java 17+

---

Why TerritoryCore?

Most servers stitch together five or ten plugins that fight over commands, permissions, and configs. TerritoryCore keeps claims, economy, player tools, and staff tools in one place — shared config style, shared permissions, shared GUIs, and one place to update.

Whether you run a small friends world or a public claim/siege survival server, you get land control, progression, and server management without juggling incompatible addons.

---

🗺️ Chunk Claiming

Claim the chunk you stand in and grow your territory one chunk at a time.

• Adjacency rules — expand only next to land you already own (no random skips)
• BossBar when you enter a claim — see who owns the land
• Particle borders — green for friendly / trusted, red for enemy territory
• Rename, transfer, list, map, info — full control over your land
• Claim home — set a home inside your claim and return anytime
• Welcome & farewell messages — greet visitors when they enter or leave
• Visitor log — see who has been on your land
• Likes & claim top — community ranking for the best bases

Claiming is the foundation: everything else (shields, sieges, upgrades, sub-claims) builds on top of a clear, protected territory.

---

🔒 Protection & Anti-Grief

Inside a claim, your base is protected by a dedicated protection engine:

Protection	What it does
Blocks	Only owner & trusted members can break/place
Containers & doors	Configurable outsider interaction
TNT & explosions	Toggle per claim
Creeper / Wither	Block explosion damage to blocks
Pistons	Block cross-border piston grief
Liquids	Stop water/lava flowing in from outside
Projectiles & potions	Limit combat exploits in safe claims
PvP	Off by default, toggleable per claim
Mob spawn	Optional natural spawn disable

Trusted players, alliances, and admin override permissions integrate cleanly with LuckPerms.

---

⚙️ Claim Settings GUI

Open /claim settings and toggle flags without editing files:

• TNT · PvP · Mob spawn
• Always day · Clear weather
• Fly for trusted members
• Outsider interact (chests, doors, …)
• Creeper / Wither block damage

Every serious claim owner gets a clear UI instead of cryptic commands.

---

🛡️ Claim Shield

Buy temporary immunity from sieges: /claim shield text- Paid from the claim wallet

• Hours stack if you extend early
• Max duration and cost are configurable in config.yml

Perfect before a big build session or when the owner has to log off.

---

🤝 Alliances

Team up with other claim owners: /claim alliance /claim alliance accept /claim alliance break /claim alliancelist textAllied players do not PvP each other across claims. Requests always need confirmation — no accidental alliances.

---

⚔️ Siege System

Take over enemy land in a structured fight — not a random spawn-kill.

• Start with /claim attack while standing in enemy territory
• Owner or a trusted member must be online
• Multiple waves of defenders with scaling strength
• BossBar progress for attacker and defenders
• Optional Discord webhook when a siege starts
• Attacker dies or leaves → siege fails
• All waves cleared → ownership transfers to the attacker

Sieges turn claims into something you can earn, not only buy.

---

📈 Claim Upgrades

Spend claim-wallet balance on permanent buffs in your territory: /claim upgrades textExamples:

• Haste for faster mining inside the claim
• Regeneration for trusted members
• Flight upgrades in claim borders
• Alliance slots for larger teams

Progression stays tied to the land you built.

---

⛺ Sub-Claims & Renting

Carve out areas inside your claim and rent them: /claim subclaim create
/claim subclaim rent
/claim subclaim rentclaim
/claim subclaim list textTenants get build/interact rights only in their sub-claim. Landlords earn passive income. Ideal for towns, malls, and shared bases.

---

🗺️ Live Map Overlays

Show claim borders on web maps:

• Dynmap
• BlueMap
• Squaremap

Players see territory online without being in-game — great for diplomacy and town planning.

---

🪙 Economy

Powered by Vault (works with common economy plugins):

• Chunk costs can scale as you expand
• Claim wallet — deposit / withdraw for shields & upgrades
• Siege costs from personal balance
• /baltop — richest players leaderboard
• /bal · /pay — everyday payments

Without Vault, claim and combat features still work; coin features simply stay inactive.

---

🛒 Server Shop

A full GUI shop with categories:

• Blocks · Resources · Weapons · Tools · Food · Redstone · Misc
• Seeds all usable items for your server version (safe material matching)
• Buy & sell with fair buy/sell ratios
• Admin tools: add items, reseed catalog, inspect size /shop /sellgui /sellhand /worth /shop reseed (admin) text---

📦 Auction House

Player-to-player trading without trusting strangers in a dark alley: /ah → open GUI /ah sell → list held item /ah buy /ah cancel text- Browse listings in a chest GUI

• My listings tab to cancel
• Click to buy · money and items handled by the plugin
• Max listings per player configurable

---

🧭 Teleportation

Everything players expect on a survival network:

Feature	Commands
Player TPA	/tpa /tpahere /tpaccept /tpdeny
Homes	/sethome /home /delhome /homes
Spawn	/spawn /setspawn
Utility	/back /rtp
Warps	/warp /warps /setwarp /delwarp
Player warps	/pwarp set|del|list|go
GUIs	/warpgui

Warmup, move-cancel, and safe RTP checks reduce exploits and deaths in lava.

---

🎁 Kits, Daily & Playtime

• /kit · /kitgui — starter, food, miner, and more from kits.yml
• /daily — daily login reward with streak bonus
• Playtime tracking — optional hourly pay so active players are rewarded

Keep retention high without a separate rewards plugin.

---

💬 Social

• Private messages: /msg /r
• Offline mail: /mail
• Trade GUI: /trade <player>
• Ignore list
• Near / seen / list
• Nicknames
• Claim member chat & claim social commands

---

🛠️ Player & Staff Tools

Quality-of-life and moderation helpers built in:

Players (many default-true):
workbench, anvil, disposal, hat, AFK, coordinates, MOTD, rules, scoreboard toggle, tab list presence

Staff:
heal, feed, fly, god, vanish, gamemode, speed, clear inventory, time, weather, broadcast, invsee, enderchest (others), teleport, repair, more, jump, top, …

Permissions are granular for LuckPerms — give mods only what they need.

---

🔨 Moderation Suite

Reason-based punishments defined in moderation.yml: /ban Steve 1 textExample reasons (fully editable):

ID	Reason	Default duration
1	Hacking	30 days
2	Harassment	7 days
3	Griefing	14 days
…	…	…

Also: /mute /unmute /kick /warn /warnings /clearwarns /banlist /checkban /checkmute /reasons /modreload

Auto-ban after too many warnings is configurable. Staff permissions use the territory.mod.* tree.

---

📋 Scoreboard & Tab List

Make the server feel branded and informative:

Scoreboard (config.yml):

• Toggle with /scoreboard
• Custom title
• Custom lines with placeholders:
  %balance% %claim% %online% %playtime% %mail% %player% %world%

Tab list:

• Header & footer (multi-line)
• Name format with prefix/suffix
• AFK / vanish suffixes
• Update interval configurable

No extra TAB plugin required for a clean, consistent look.

---

📋 Command Overview (highlights)

/claim … Land, settings, siege, shield, alliance, subclaim, upgrades /shop /sellgui Server shop /ah Auction house GUI /bal /pay /baltop Economy /tpa /home /warp Teleport /kit /daily Rewards /msg /mail /trade Social /ban /mute /warn Moderation /help Full in-game help text---

🔐 Permissions (summary)

Node	Role
claims.use	Normal players (default true)
claims.admin	Full admin + many staff children
claims.shop.*	Shop buy/sell/admin
claims.teleport.*	TPA, homes, warps, RTP, …
territory.mod.*	Ban, mute, kick, warn, reload
territory.admin	Everything

Fine-grained nodes exist for heal, fly, invsee, gamemode, and more — ideal for LuckPerms groups (default, vip, mod, admin).

---

📦 Requirements

Requirement	Details
Server	Paper recommended (Bukkit/Spigot APIs supported where applicable)
Minecraft	1.20 → 1.21+ · 26.x year versions
Java	17 or higher
Optional	Vault + any economy plugin for money features
Optional	Dynmap / BlueMap / Squaremap for map overlays

Without Vault, TerritoryCore still runs — economy-related actions are skipped safely.

---

⚙️ Configuration

Everything important lives under plugins/TerritoryCore/:

• config.yml — limits, economy, siege, RTP, scoreboard, tab list, features
• messages.yml — player-facing text
• moderation.yml — ban reasons & durations
• kits.yml · warps · shop data · claims data

Reload claim config with /claim reload (admin). Reload moderation reasons with /modreload.

---

🚀 Getting Started

1. Drop the JAR into plugins/
2. Install Vault + an economy plugin if you want shops and wallets
3. Start the server once to generate configs
4. Adjust config.yml and moderation.yml
5. If the shop is empty or outdated: /shop reseed (admin)
6. Set spawn: /setspawn
7. Claim your first chunk: /claim claim

---

🎯 Who is this for?

• Survival servers that want real land ownership
• Claim/siege communities
• Servers that want shop + auctions + teleports + mod tools without ten overlapping plugins
• Admins who want LuckPerms-friendly permission trees and YAML they can actually read

---

📝 Notes

• Built for Paper; Folia-oriented scheduling is used where integrated
• Shop materials are resolved per server version (missing items on old versions are skipped, not crashed)
• Offline inventory viewing is limited by the API (online invsee / enderchest tools for staff)

---

TerritoryCore — one plugin to claim the world, fund the economy, and keep the server under control.