TerritoryCore

Minecraft 版本： 1.20 1.20.1 1.20.2 1.20.3 1.20.4 1.20.5 1.20.6 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11 26.1 26.1.1 26.1.2 26.2

平台： bukkit folia paper purpur spigot

标签： game-mechanics management utility

🏰 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:

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:

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):

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)

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

📦 Requirements

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.