TerritoryPvP is a Paper plugin for chunk-based territory control on a PvP-focused server. Players own axis-aligned rectangles of full chunk columns (16×16 × world height); overlapping claims, a spawn-shield ring around world spawn, and min/max claim sizes are enforced in config.
Claiming & progression — Starting claims can be placed automatically on first join; territory can grow or shrink via kills (killer expands, victim shrinks, configurable) and optionally via golden hoe + territory points. Claims can be persisted with Postgres/JDBC (e.g. Supabase) or kept in memory only.
World rules — Gameplay applies only to configured game worlds (or all worlds if the allowlist is empty). New players without a claim can get a random spawn inside the world border, with extra rolls to avoid unsafe columns (lava, water, hazards, waterlogged blocks).
Inside claimed chunk columns — Foreigners generally can't break, place, or interact with blocks; PvP is cancelled if either side is standing in any claim column (wilderness-only fights). Explosions remove blocks from foreign claims unless primed TNT is attributed to that claim's owner; fire spread and ender pearls / chorus into someone else's column can be blocked via config.
Fairness & UX — Optional territory gear tiers cap golden apples and armor/weapon enchant levels by claim footprint size, with /claim tier and /claim chunks plus combat-cap hints on /claim info. /claim boundary shows a live outline at eye height and vertical markers on outer chunk corners.
Combat tag — After actual player-vs-player damage in game worlds (wilderness hits; cancelled safe-zone hits don't tag), both fighters get a timer (default 45 s): they can't enter their own claim while tagged. Optional combat logging: disconnect while tagged applies lethal damage and credits the online opponent like a normal kill for territory/points logic.
Ops — /tpvp reload reloads gameplay/config caches (not the DB pool). Admin commands handle expand/shrink, points, chunk info, teleport to a player's claim, etc.
Overall it's a "Claim & Conquer" style loop: fight in the open, hold ground in chunks you own, with config-driven limits so large empires and combat escapes stay manageable.
(This plugin was Produced and Developed by Cursor, Composer 2 AI)
