Warlord

A faction / territory-warfare plugin for Paper (and forks like Leaves) servers — build a faction, claim land, go to war, and lay siege. All player-facing text is Traditional Chinese (繁體中文).

軍閥勢力割據系統：組勢力、佔地盤、宣戰、攻城，一套指令搞定。所有玩家看得到的訊息都是繁體中文。

需求 Requirements

• Paper / Leaves 1.21.x（或相容分支）
• 選用（Optional）：
  • Vault + 任一經濟插件——沒裝的話,所有花錢的功能（佔地、招兵、稅收……）都會被忽略,不會扣錢也不會擋你操作
  • Citizens——沒裝的話,/warlord recruit 招募士兵系列指令無法使用,其餘功能不受影響

安裝 Installation

1. 把 jar 丟進 plugins/ 資料夾,重啟伺服器
2. 第一次啟動會自動產生 plugins/Warlord/config.yml,裡面幾乎每個數值（花費、機率、時長、加成）都能調
3. 改完設定檔要重啟伺服器才會生效

功能總覽 Features

• 勢力管理：建立/邀請/踢除/晉升副手/解散,主/副手兩級權限
• 領地系統：單塊佔領或用框選工具（/warlord wand）一次圈一片地按面積收費、地盤升級解鎖士兵上限、傳送點網路、地盤保護模式（完全防護 / 僅顯示歸屬）、管理員可設永久中立區、太久沒人上線自動釋放地盤、靠近地盤邊界會有粒子特效
• 戰爭與攻城：宣戰/講和（結盟中的盟友會被拖下水一起參戰）、攻城（撐過時間才能佔地）、突襲（時間短、不佔地，直接搶國庫）、攻城武器加速、攻城獲勝機率俘虜對方士兵、講和自動結算戰爭賠款、停戰協議冷卻期
• 士兵系統（需要 Citizens）：5 種兵種（劍士/弓箭手/盾兵/騎兵/指揮官）、花錢升等級/升裝備、站崗或設定巡邏路線、血量低會自動回總部補給、指揮官會幫附近士兵加 buff
• 經濟：地盤稅收、國庫利息、盟友貿易紅利、國庫上限、破產懲罰（攻城時間縮短）、入會稅、懸賞金系統、每週勢力國庫排行榜獎勵
• 外交與進度：勢力公告欄、聲望系統、勢力等級/經驗值、成就系統、賽季重置（自動備份舊資料再清空重來）、勢力專屬聊天頻道（訊息開頭打 !）

指令 Commands

主指令：/warlord（別名 /w），不帶參數會開啟 GUI 選單。

指令	說明
create <名稱>	建立勢力
invite / accept / deny / leave / kick / disband	成員管理
promote / demote <玩家>	任命 / 撤除副手
claim / unclaim	佔領 / 放棄地盤（有框選就用框選範圍）
wand	拿框選工具（左鍵/右鍵方塊定角落）
upgradeclaim	花錢升級地盤等級
waypoint <set|tp|list|remove>	傳送點管理
protection <full|display>	切換地盤保護模式
declarewar / peace <勢力>	宣戰 / 講和
siege / raid	攻城 / 突襲目前站的地盤
siegeweapon	花錢加速進行中的攻城/突襲
wars	查看交戰中的勢力
recruit [數量] [兵種]	招募士兵（需要 Citizens）
soldiers	列出士兵編號/類型/等級
upgradesoldier / upgradeequipment <編號>	升級士兵等級 / 裝備
soldierstance <編號> <guard|patrol>	切換站崗 / 巡邏
soldierpatrol <編號> <add|clear>	設定巡邏路線點
sethome / home	設定 / 傳送到勢力總部
deposit / withdraw <金額>	國庫存 / 提款
bounty <玩家> <金額>	懸賞（賞金從個人錢包扣）
allianceoffer / allianceaccept / alliancedeny / allianceend / allies	結盟管理
announce [文字]	設定勢力公告
achievements [玩家]	查看成就
season reset	（管理員）賽季重置，先備份再清空
admin neutral <add|remove>	（管理員）設定永久中立區
info [勢力] / list	查詢勢力資訊 / 列出所有勢力

權限節點 Permissions

• warlord.bypass——略過地盤保護跟宣戰限制（給管理員用）
• warlord.admin——season reset、admin neutral 這類管理指令（預設只有 OP 有）

授權 License

MIT License，詳見 LICENSE。

開發狀態 Status

目前實作到「經濟／領地／士兵戰爭／外交進度」四大主題，介面優化（士兵狀態面板、邀請確認 GUI 等）跟特殊活動（世界 BOSS、隨機事件）還在規劃中，歡迎回報問題或提出想法。

---

English

A faction / territory-warfare plugin for Paper (and forks like Leaves) servers, running on the RPG server. Players can found factions, claim territory, declare war, besiege enemy claims, and manage a faction economy. Recruiting soldiers requires the Citizens plugin (soldiers are Citizens NPCs); Vault + any economy plugin is optional (money-related features are simply skipped if not installed).

Features

• Faction management: create/invite/kick/promote-demote/disband, two permission tiers (leader/officer)
• • Territory: claim single chunks or a selection (/warlord wand) at an area-based cost, claim-level upgrades raise your soldier cap, a network of custom waypoints, protection modes (full protection / ownership display only), admin-defined permanent neutral zones, auto-release of claims after long inactivity, particle effects near claim borders
• • War & sieges: declare war/request peace (allies are pulled into the war too), sieges (hold the claim long enough to capture it), raids (short, doesn't capture the claim, directly loots the treasury), paid siege-weapon speed-ups, a chance to capture enemy soldiers on a siege win, automatic war reparations on peace, a post-ceasefire cooldown
• • Soldiers (requires Citizens): 5 unit types (swordsman/archer/shield/cavalry/commander), paid level/gear upgrades, guard or patrol-route stances, auto-return to HQ to resupply at low health, commanders buff nearby soldiers
• • Economy: claim taxes, treasury interest, alliance trade bonuses, a treasury cap, bankruptcy penalties (shorter siege time), joining fees, a bounty system, weekly treasury leaderboard rewards
• • Diplomacy & progression: faction announcement board, reputation system, faction level/XP, achievements, season reset (auto-backs up old data before wiping), a faction-only chat channel (prefix messages with !)

Commands

Main command: /warlord (alias /w); running it with no arguments opens a GUI menu. Highlights: create, invite/accept/deny/leave/kick/disband, promote/demote, claim/unclaim, wand, upgradeclaim, waypoint <set|tp|list|remove>, protection <full|display>, declarewar/peace, siege/raid, siegeweapon, wars, recruit [count] [type], soldiers, upgradesoldier/upgradeequipment, soldierstance <id> <guard|patrol>, soldierpatrol <id> <add|clear>, sethome/home, deposit/withdraw, bounty, allianceoffer/allianceaccept/alliancedeny/allianceend/allies, announce, achievements, season reset (admin), admin neutral <add|remove> (admin), info/list.

Permissions

• warlord.bypass — bypass claim protection and war restrictions (for staff)
• • warlord.admin — admin commands like season reset, admin neutral (OP by default)

License

MIT License, see LICENSE.

Status

Currently implemented: economy, territory, soldier warfare, and diplomacy/progression. UI polish (a soldier status panel, an invite-confirmation GUI, etc.) and special events (a world boss, random events) are still planned. Bug reports and suggestions are welcome.