? PeaTowny
现代化的领地宣称与城镇管理插件。
Towny 和 Lands 的无缝替代品——熟悉的 /lands 命令,零学习成本。
? Discord ·
? 免费版 ·
⭐ 高级版 ·
⚙️ 配置

?️ 选择你的版本
? 免费版
运行领地服务器所需的一切。
完整的保护、战争、图形界面(GUI)、经济和工具功能。
跳转至免费功能 ↓
|
⭐ 高级版
完整体验——国家、征服战争、
等级、子区域、租赁、飞行等更多功能。
跳转至高级功能 ↓
|
? 免费版
零成本。完全可用。 创建领地、邀请成员、管理权限、发动战争并保护你的建筑——开箱即用,满足一切需求。
? 领地管理
| 功能 |
详情 |
| ?️ 创建与删除 |
玩家最多可拥有 3 块领地(可配置) |
| ? 区块宣称 |
使用 /lands claim 进行宣称——创建时自动宣称一个 3x3 的区域 |
| ? 自动宣称 |
使用 /lands autoclaim 边走边自动宣称区块 |
| ? 宣称方块 |
放置一个实体方块即可立即创建一块领地(3x3 区域) |
| ? 选择工具 |
首次加入时给予可视化工具,用于选择区域 |
| ? 领地出生点 |
设置并在你的领地内传送至出生点 |
| ✏️ 重命名 |
随时通过 GUI 或命令更改领地名称 |
| ? 领地浏览器 |
通过 GUI 浏览服务器上的所有领地 |
| ? 扩展 |
向指定方向扩展领地边界 |
? 公共传送门系统
| 功能 |
详情 |
| ? 信标传送 |
站在任何领地的信标上即可打开公共传送门浏览器 |
| ?️ 传送门浏览器 |
分页 GUI 显示所有公共领地——点击即可传送 |
| ? 搜索 |
点击标志图标可按名称搜索特定领地 |
| ? 传送门管理器 |
领地所有者可以切换公开/私有状态并设置自定义图标 |
| ? 自定义图标 |
从 56 多种方块/物品图标中选择代表你的领地 |
? 成员与角色
| 功能 |
详情 |
| ? 邀请系统 |
邀请玩家加入你的领地 |
| ?️ 4 种默认角色 |
所有者、官员、成员、访客(内置且不可删除) |
| ?️ 自定义角色 |
创建具有自定义名称和颜色的额外角色 |
| ? 角色权限标记 |
精细控制:建造、破坏、交互、容器、门、PvP 等 |
| ✅ 信任 / 取消信任 |
快速添加或移除领地成员 |
?️ 保护
| 功能 |
详情 |
| ? 基于区块 |
已宣称的区块受到完全保护,防止外人进入 |
| ? 自然标记 |
切换爆炸、火灾蔓延、生物生成、PvP、活塞、液体流动等 |
| ? 荒野规则 |
未宣称土地的 configurable 保护规则 |
| ⚔️ 战斗标签 |
可配置的持续时间、Boss 栏倒计时、死亡后移除选项 |
? 经济 (Vault)
| 功能 |
详情 |
| ? 领地银行 |
从你领地的金库中存款和取款 |
| ? 区块费用 |
每个区块的可配置价格,支持阶梯定价 |
| ? 传送费用 |
可选的经济费用用于出生点传送 |
⚔️ 战争系统 (击杀点数模式)
| 功能 |
详情 |
| ? 宣战 |
挑战另一块领地发起击杀计数战争 |
| ? 击杀追踪 |
记录并显示每位玩家的击杀数 |
| ? 战争记分板 |
/wars status 显示包含双方、击杀数、进度条的详细记分板 |
| ? 操作栏 |
战争期间在操作栏实时更新击杀点数 |
| ? 胜利 |
率先达到击杀阈值的队伍获胜 |
| ?️ 移交 |
获胜者获得失败者的领地——24小时内移交,否则归还 |
| ⏱️ 超时 |
战争在可配置时长后自动结束 |
| ? 战争标记 |
战争中可配置破坏/放置权限,支持方块白名单 |
| ? 战争 GUI |
从领地菜单查看活跃战争及其状态 |
? 视觉与用户界面
| 功能 |
详情 |
| ?️ 完整 GUI |
通过整洁的库存菜单管理所有内容 |
| ✨ 边界可视化 |
通过粒子或发光实体看到领地边界 |
| ? 进入/离开 |
跨越领地边界时在操作栏显示通知 |
| ? 信标 |
每块领地在其主区块获得一个信标 |
| ? 信标颜色 |
通过 GUI 自定义信标颜色 |
? 管理员工具
| 功能 |
详情 |
?️ /landadmin |
完整的管理套件 |
| ?️ 绕过模式 |
管理员绕过所有领地保护 |
| ? 管理员领地 |
创建受服务器保护的区域(出生点、竞技场) |
| ⚔️ 强制战争 |
/landadmin forcewar — 宣布任意两块领地之间的战争 |
| ? 结束战争 |
/landadmin endwar — 强制结束任何活跃战争 |
| ⚙️ 限制 |
通过权限控制区块、领地和成员数量上限 |
| ? 权限 |
peatowny.chunks.<n>, peatowny.lands.<n>, peatowny.members.<n> |
? 数据与存储
| 功能 |
详情 |
| ? YAML |
简单的基于文件的数据,无需设置 |
| ?️ SQLite |
轻量级数据库以提升性能 |
| ? 自动保存 |
数据每 5 分钟自动保存一次 |
? 集成
| 功能 |
详情 |
| ? Vault |
完整经济支持 |
| ?️ Dynmap & BlueMap |
领地主张渲染在您的网络地图上 |
| ? Land Chat |
成员私聊频道 |
⭐ 高级版
一次性购买。解锁所有功能。 只需替换 JAR 文件——所有数据即刻无缝迁移。高级版包含免费版的所有内容以及以下额外功能。
? 获取高级版 → discord.gg/Y8QhgYaq6K
?️ 国家
将多个领地组合成一个强大的国家,实现共享治理、税收和外交。
| 功能 |
详情 |
| ? 创建国家 |
从您的 5 级首都领地组建一个国家 |
| ?️ 成员领地 |
邀请其他领地加入您的国家 |
| ? 国家税收 |
从成员领地收取税收 |
| ?️ 国家维护 |
国家领土按区块收取维护费 |
| ? 国家聊天 |
所有国家领地共享的专用聊天频道 |
| ? 外交 |
国家层面的关系与宣战声明 |
⚔️ 全面征服战争(占领模式)
将战斗转化为大规模的领土战争:
| 功能 |
详情 |
| ? 区块占领 |
在敌方领土放置占领栅栏并控制该区块 |
| ? Boss Bar 进度条 |
双方可见的实时占领进度 |
| ?️ 争夺状态 |
防守者进入已占领区块会暂停计时器 |
| ? 信标胜利 |
占领敌方的家园信标即可立即获胜 |
| ?️ 投降与贡品 |
败方可以投降并支付高达 75% 的贡品 |
| ?️ 战争护盾 |
创建后、投降后及战争结束后的保护期 |
| ? 抢劫 |
胜方获得败方银行一定比例的份额 |
| ? 领土转移 |
被占领的土地将在 24 小时期限前转移给胜方 |
? 领地等级
领地在成长过程中经历 5 个阶段:
| 等级 |
称号 |
所需成员数 |
所需余额 |
额外区块 |
| ⭐ 1 |
定居点 |
— |
— |
— |
| ⭐ 2 |
村庄 |
4 |
$7,500 |
+1 |
| ⭐ 3 |
城镇 |
8 |
$17,000 |
+2 |
| ⭐ 4 |
省份 |
14 |
$30,000 |
+4 |
| ⭐ 5 |
城市 |
24 |
$55,000 |
+8 |
? 关系
| 功能 |
详情 |
| ? 盟友 |
盟军领地间共享保护 |
| ⚪ 中立 |
默认关系 |
| ? 敌人 |
敌对关系,开启 PvP |
| ?️ 国家自动结盟 |
同一国家内的领地自动成为盟友 |
? 资源节点
每个领地都会分配一种随机资源类型,并提供掉落加成:
| 资源 |
加成效果 |
| ⛏️ 钻石 |
挖掘石头/深板岩时增加钻石掉落 |
| ? 铁 |
挖掘时增加原铁掉落 |
| ? 金 |
挖掘时增加原金掉落 |
| ? 小麦 |
收获时增加作物产量 |
| ? 鱼 |
钓鱼时增加捕获量 |
| ? 生物 |
繁殖时增加生物生成数量 |
| ⛽ 燃料 |
可收集燃料存入您的燃料箱 |
?️ 子区域
将您的领地划分为具有独立权限集的子区域。非常适合在单个领地内设置公共市场、成员住宅、限制区域或访客区。
? 租赁与销售
在市场中出租或出售领地。玩家可以浏览可用列表,以循环周期进行租赁,或直接购买。
? 领地存储
通过 GUI 访问的按领地共享存储空间——供您的领地成员使用的公共箱子。
?️ 飞行
成员可以在自己的领地内自由飞行。离开领土或进入战斗时自动禁用。
? 维护与税收
| 功能 |
详情 |
| ?️ 维护费 |
领地按可配置周期按区块支付维护费 |
| ? 税收 |
领地所有者设定成员税率——未按时缴税将自动取消信任 |
?️ MySQL 存储
连接 MySQL 数据库,适用于大型网络和多人服务器设置。
✍️ 自定义消息
编辑 messages.yml 中的每一条消息——更改措辞、颜色和占位符以匹配您的服务器品牌。
? GUI 文本样式
在普通文本和Unicode 小型大写字母之间切换,打造精致的高级 GUI 外观。
? 迁移
使用一条命令从 Lands 和 Towny 导入数据。切换插件而不丢失任何内容。
?️ 小地图
游戏内区块小地图,直接在屏幕上显示附近的领地、荒野和资源类型。
? 免费版与高级版一览
| 功能 |
? 免费版 |
⭐ 高级版 |
| ? 领地主张与保护 |
✅ |
✅ |
| ?️ 角色与权限 |
✅ |
✅ |
| ? 经济与领地银行 |
✅ |
✅ |
| ?️ GUI 菜单 |
✅ |
✅ |
| ✨ 边界可视化 |
✅ |
✅ |
| ? 信标标记与颜色 |
✅ |
✅ |
| ? 公共传送系统 |
✅ |
✅ |
| ? 领地聊天 |
✅ |
✅ |
| ?️ Dynmap / BlueMap |
✅ |
✅ |
| ? YAML 与 SQLite 存储 |
✅ |
✅ |
| ? 管理工具与 bypass |
✅ |
✅ |
| ⚔️ 战争(击杀积分模式) |
✅ |
✅ |
| ? 战争领地转移 |
✅ |
✅ |
| ? 战争记分牌与动作栏 |
✅ |
✅ |
| ? 战争旗帜(破坏/放置方块) |
✅ |
✅ |
| ⚔️ 战斗标签与 Boss Bar |
✅ |
✅ |
|
|
|
| ? 战争(区块占领与征服) |
❌ |
✅ |
| ?️ 国家与国家聊天 |
❌ |
✅ |
| ? 领地等级(5 个阶段) |
❌ |
✅ |
| ? 关系(盟友/敌人) |
❌ |
✅ |
| ? 资源节点 |
❌ |
✅ |
| ?️ 子区域 |
❌ |
✅ |
| ? 租赁与销售 |
❌ |
✅ |
| ? 领地存储 |
❌ |
✅ |
| ?️ 领地内飞行 |
❌ |
✅ |
| ? 维护与税收 |
❌ |
✅ |
| ?️ MySQL 支持 |
❌ |
✅ |
| ✍️ 自定义消息 |
❌ |
✅ |
| ? GUI 小型大写字母样式 |
❌ |
✅ |
| ? 插件数据迁移 |
❌ |
✅ |
| ?️ 小地图 |
❌ |
✅ |
? 命令
主要命令(多种别名)
所有主要命令都会打开相同的领地 GUI。使用您觉得自然的那个即可。
| 命令 |
别名 |
描述 |
/lands |
/land, /l |
主要领地命令与 GUI |
/pea |
/p, /peatowny, /pt |
同 /lands |
/town |
/t |
同 /lands |
/nations |
/nation, /n |
国家管理 (高级版) |
/wars |
/war, /defeated |
战争命令 |
/landadmin |
/la, /ladmin |
管理命令 |
领地子命令
| 命令 |
描述 |
/lands create <name> |
?️ 创建新领地(占据 3x3 区域) |
/lands claim |
? 占领你所在的区块 |
/lands unclaim |
↩️ 取消当前区块的占领 |
/lands autoclaim |
? 切换自动占领模式 |
/lands expand |
? 扩展你的领地边界 |
/lands invite <player> |
? 邀请一名玩家 |
/lands trust <player> |
✅ 信任一名玩家 |
/lands untrust <player> |
❌ 移除一名玩家 |
/lands setrole <player> <role> |
?️ 为成员分配角色 |
/lands spawn [name] |
? 传送至领地出生点 |
/lands setspawn |
? 设置你的领地出生点 |
/lands movebeacon |
? 移动你的领地信标 |
/lands fly |
?️ 切换飞行 (高级版) |
/lands chat |
? 切换领地聊天 |
/lands map |
?️ 切换小地图 (高级版) |
/lands menu |
?️ 打开领地管理 GUI |
/lands info [name] |
ℹ️ 查看领地信息 |
/lands list |
? 列出所有领地 |
/lands top |
? 查看顶级领地 |
/lands deposit <amount> |
? 向领地银行存款 |
/lands withdraw <amount> |
? 从领地银行取款 |
/lands balance |
? 检查领地余额 |
/lands rename <name> |
✏️ 重命名你的领地 |
/lands delete |
?️ 删除你的领地 |
/lands view |
?️ 切换边界可视化 |
/lands buy |
? 购买领地挂牌 (高级版) |
/lands storage |
? 访问领地仓库 (高级版) |
战争子命令
| 命令 |
描述 |
/wars declare <land> |
? 对某领地宣战 |
/wars surrender |
?️ 投降当前战争 |
/wars status |
? 查看详细战争记分板 |
/wars info |
ℹ️ 查看战争信息 |
/wars list |
? 列出活跃战争 |
/wars transfer <land> |
? 转移被占领的领地 |
国家子命令 (高级版)
| 命令 |
描述 |
/nations create <name> |
? 创建国家 |
/nations invite <land> |
? 邀请领地加入你的国家 |
/nations kick <land> |
❌ 将领地移出你的国家 |
/nations leave |
? 离开你的国家 |
/nations info [name] |
ℹ️ 查看国家信息 |
/nations list |
? 列出所有国家 |
管理员子命令
| 命令 |
描述 |
/landadmin bypass |
?️ 切换管理员绕过模式 |
/landadmin unclaim |
↩️ 强制取消区块占领 |
/landadmin delete <land> |
?️ 强制删除领地 |
/landadmin give <player> <amount> |
? 给予玩家占领区块数量 |
/landadmin setowner <land> <player> |
? 更改领地所有者 |
/landadmin setresource <land> <type> |
? 设置领地资源类型 |
/landadmin forcewar <land1> <land2> |
⚔️ 强制宣战 |
/landadmin endwar <land> [winner] |
? 强制结束活跃战争 |
/landadmin migrate <plugin> |
? 从 Lands/Towny 导入 (高级版) |
/landadmin reload |
? 重载插件配置 |
⚙️ 配置参考
config.yml 中每个选项的详细分解。标记为 ⭐ 的行表示 仅限高级版。
? 核心设置
basic-mode: false # 简化模式 — 禁用高级功能,提供更简单的体验
?️ 功能开关
features:
upkeep: true # ⭐ 启用按区块维护费用(领地需支付区块维护费)
taxes: true # ⭐ 启用领地所有者对成员的税收
relations: true # ⭐ 启用领地之间的盟友/敌对关系
wars: true # 启用战争系统(击杀点数和占领模式)
nations: true # ⭐ 启用国家系统(将多个领地组合在一起)
levels: true # ⭐ 启用领地等级进阶(定居点 → 领地)
? 常规设置
general:
claim-worlds: # 允许占领的世界列表 (* = 所有世界)
- '*'
language: 'en-US' # 消息的语言环境
edit-by-loc: false # 允许根据位置编辑领地设置
first-join-items: # 玩家首次加入时获得的物品
selection:
enabled: true # 给予选择法杖工具
slot: 1 # 选择工具的背包栏位
info:
enabled: true # 给予信息工具(右键点击以检查区块)
slot: 2 # 信息工具的背包栏位
camp:
enabled: false # 给予营地物品(便携式基地)
claim-block:
enabled: true # 给予占领块(放置即可立即创建领地)
slot: 3 # 占领块的背包栏位
date-format: 'MM/dd/yyyy hh:mm a' # 插件中日期显示格式
eco-format: '$#,##0.00' # 经济数字格式(货币显示)
? 经济周期
economic:
interval:
days: 7 # 每次经济周期(维护/税收收取)之间的天数
time: '23:00:00' # 周期运行的时间(HH:mm:ss)
?️ 维护费用 (⭐ 高级版)
upkeep:
per-chunk: 3.0 # 每次经济周期每个区块的费用
unclaim-on-fail: false # 当领地无法支付维护费时,自动取消区块占领
no-pay-period: 2d # 领地创建后开始维护费用前的宽限期
? 税收 (⭐ 高级版)
taxes:
min: 0 # 领地所有者可设置的最低税率
max: 10.0 # 领地所有者可设置的最高税率
untrust-on-fail: true # 自动移除未能缴税的成员
? 传送
teleport:
cost: 0 # 传送到领地出生点的经济费用
delay: 3 # 传送前的等待秒数(预热时间)
cancel-on-move: true # 如果玩家在预热期间移动,则取消传送
cooldown: 30 # 使用传送之间的冷却时间(秒)
⚔️ 战斗标签
combat:
enabled: true # 启用战斗标记系统
duration: 15 # 受到最后一次攻击后的战斗标记持续时间(秒)
boss-bar: true # 在战斗标记期间显示 Boss 栏倒计时
remove-on-death: true # 当被标记的玩家死亡时清除战斗标记
? 领地设置
land:
creation:
force: false # 强制玩家在认领前创建领地
cost: 0.0 # 创建新领地的经济费用
claim-radius: 1 # 创建时的初始认领半径(1 = 3x3 区域)
name:
spaces: false # 允许领地名称中包含空格
max-length: 24 # 领地名称的最大字符数
color: true # 允许名称中使用颜色代码(&a, &b 等)
numbers: true # 允许名称中包含数字
chunk-distance:
mode: EUCLIDEAN # 距离计算模式(EUCLIDEAN 欧几里得距离 或 MANHATTAN 曼哈顿距离)
land: 1 # 不同领地之间的最小区块距离
nation: 3 # 不同国家之间的最小区块距离
force-near:
enabled: true # 新的认领必须与现有认领相邻
treat-as-new: true # 将第一次认领视为“新领地”(无需相邻)
spawn:
auto-set: true # 自动在创建领地时设置出生点
cost:
set: 0.0 # 设置领地出生点的费用
change: 0.0 # 更改现有出生点的费用
teleport:
cost: 0.0 # 传送至出生点的费用(覆盖全局 teleport.cost)
cooldown: 0 # 特定于出生点的传送冷却时间(秒)
re-spawn: true # 死亡时在领地出生点重生
invite:
enabled: true # 启用邀请系统
invite-owner: true # 允许邀请已经拥有领地的玩家
broadcast:
create: true # 创建领地时广播消息
delete: true # 删除领地时广播消息
chat:
forward-to-console: false # 将领地聊天消息转发到服务器控制台
mute-global: false # 当领地聊天激活时静音全局聊天
fly: # ⭐ 仅限高级版
enabled: true # 启用 /lands fly 命令
disable-delay: 3 # 离开领地后,悬停多少秒飞行才会禁用
setowner:
enabled: true # 允许转移领地所有权
cost: 5000.0 # 转移所有权的费用
rent: # ⭐ 仅限高级版
rent: true # 启用领地租赁
sell: true # 启用领地出售
expiration:
owner-offline: 60d # 所有者离线超过此时长后删除领地
delete-land: true # 到期时实际删除领地(而非仅标记)
storage: true # ⭐ 启用每个领地的共享存储箱子
? 区块设置
chunk:
cost:
buy: 0.0 # 每个认领区块的费用
refund: 0 # 取消认领时的退款百分比(0-100)
increase: 0.0 # 每增加一个区块的累加价格增幅
max-claims: 0 # 每个领地的硬性最大区块数(0 = 使用基于权限的限制)
initial-claims: 10 # 新领地的默认最大区块数(无权限组时)
scaling:
enabled: true # 根据成员数量缩放最大区块数
base-chunks: 10 # 起始区块限制
per-member: 5 # 每加入一名成员增加的额外区块数
? 限制
limits:
default-chunks: 10 # 未设置权限节点时的默认最大区块数
default-lands: 3 # 每个玩家的默认最大领地数
default-members: 10 # 每个领地的默认最大成员数
permission-stacking: false # 多个权限节点叠加(相加)vs 取最高值
权限节点: peatowny.chunks.<n>、peatowny.lands.<n>、peatowny.members.<n>
✨ 可视化
visualization:
type: ENTITY # 边界显示类型:ENTITY(发光方块)或 PARTICLE(粒子)
duration: 15 # 边界可见时长(秒)
show-on-enter: true # 进入领地时自动显示边界
particle: FLAME # PARTICLE 模式下的粒子类型
border-block: GLOWSTONE # ENTITY 模式下用于边界显示的方块类型
⚔️ 战争设置
war:
enabled: true # 启用战争系统
mode: killpoint # 战争模式:'killpoint'(免费+高级)或 'capture'(⭐ 仅高级)
# killpoint = 击杀数决定胜负
# capture = 区块占领决定胜负
only-nations: false # 仅允许国家之间进行战争(不允许个人领地间作战)
declaration:
min-players:
attacker: 0 # 攻击方所需的最少在线成员数
defender: 0 # 防守方所需的最少在线成员数
preparation-time: 1d # 宣战到战争开始之间的时间间隔
mutual: false # 要求双方同意后才能开始战争
min-balance:
attacker: 5000 # 宣战所需的最低土地银行余额
defender: 0 # 防守方所需的最低余额
points:
kill: 1 # 每击杀一名玩家获得的积分
capture: 5 # 每占领一个区块获得的积分(⭐ capture 模式下)
to-win-per-player: 5 # 每方在线玩家对应的获胜所需积分
min-to-win: 100 # 无论玩家数量多少,获胜所需的最低总积分
timeout: 36h # 超过此持续时间后自动结束战争(支持 d、h、m)
surrender:
tribute-max: 75% # 投降时胜方可索取的银行资金最高百分比
shield:
creation: 1d # 新建土地后的战争保护期(在此期间无法被攻击)
surrender: 4d # 投降后的战争保护期
end: 7d # 战争结束后的战争保护期
end:
robbery: 75% # 胜方可从败方银行中掠夺的比例
transfer:
timeout: 24 # 胜方转移占领土地前的小时数,超时后将归还
keep-inventory: false # 战争期间死亡时保留物品栏
capture: # ⭐ 仅高级功能 — 区块占领设置
enabled: true # 启用区块占领机制
hold-time: 600 # 占领围栏必须保持占领状态的秒数才能完成区块占领
max-active: 3 # 每场战争中同时进行的最大占领尝试次数
fence-block: OAK_FENCE # 用作占领围栏的方块类型
boss-bar-color: GREEN # 活跃占领期间的 Boss 条颜色
pause-bar-color: RED # 占领处于争夺/暂停状态时的 Boss 条颜色
flags: # 战争标志 — 交战领地的权限绕过设置
enabled: [] # 启用的标志:BLOCK_BREAK, BLOCK_PLACE, INTERACT,
# CONTAINER_ACCESS, DOOR_USE, EXPLOSIONS
block-whitelist: # 各标志的方块白名单(为空 = 允许所有方块)
BLOCK_BREAK: [] # 战争期间可破坏的方块仅限这些
BLOCK_PLACE: [] # 战争期间可放置的方块仅限这些
?️ 国家设置 (⭐ Premium)
nation:
enabled: true # 启用国家功能
creation:
cost: 20000.0 # 创建国家的经济成本
capital-level: 5 # 首都所需的最低土地等级
name:
max-length: 24 # 国家名称的最大长度
spaces: false # 允许在国家名称中使用空格
color: true # 允许在国家名称中使用颜色代码
taxes:
min: 0 # 国家税率的最小值
max: 5.0 # 国家税率的最大值
remove-on-fail: true # 删除未能缴纳国家税的土地
upkeep:
enabled: true # 启用国家级别的维护费用
per-chunk: 3.0 # 国家领土每个区块的维护费用
delete-on-fail: true # 如果国家无法支付维护费则删除该国家
? 土地等级 (⭐ Premium)
levels:
enabled: true # 启用等级进阶系统
keep-level: false # 成员离开时保留当前等级(false = 自动降级)
land:
1:
title: 'Settlement' # 1 级显示标题
attributes:
bonus-chunks: 0 # 该等级下的额外区块槽位
2:
title: 'Village'
requirements:
members: 4 # 达到 2 级所需的成员数
balance: 7500 # 达到 2 级所需的土地银行余额
attributes:
bonus-chunks: 1
3:
title: 'Town'
requirements:
members: 8
balance: 17000
attributes:
bonus-chunks: 2
4:
title: 'Province'
requirements:
members: 14
balance: 30000
attributes:
bonus-chunks: 4
5:
title: 'Land'
requirements:
members: 24
balance: 55000
attributes:
bonus-chunks: 8
? 自然标志
natural-flags: # 全地块标志的默认值(在 GUI 中针对每个地块切换)
EXPLOSIONS: false # 允许在地块内发生爆炸
FIRE_SPREAD: false # 允许火势蔓延
MOB_SPAWNING: true # 允许被动生物生成
HOSTILE_SPAWNING: true # 允许敌对生物生成
LEAF_DECAY: true # 允许树叶方块衰变
PISTON: true # 允许活塞推拉方块
LIQUID_FLOW: false # 允许水/岩浆流动
SNOW_MELT: true # 允许积雪融化
PVP: false # 允许成员之间的 PvP
ENTRY: true # 允许非成员进入该地块
ENTER_NOTIFY: true # 进入时显示操作栏通知
? Resources (⭐ Premium)
resources:
enabled: true # 启用资源节点系统
types:
DIAMOND:
chance: 0.005 # 每挖掘一个符合条件的方块有 0.5% 的几率
blocks: [STONE, DEEPSLATE, COBBLED_DEEPSLATE] # 触发奖励的方块
drop: DIAMOND # 作为奖励掉落的物品
IRON:
chance: 0.02 # 2% 几率
blocks: [STONE, DEEPSLATE, COBBLED_DEEPSLATE]
drop: RAW_IRON
GOLD:
chance: 0.01 # 1% 几率
blocks: [STONE, DEEPSLATE, COBBLED_DEEPSLATE]
drop: RAW_GOLD
WHEAT:
chance: 0.15 # 作物收获时有 15% 几率
bonus-amount: 2 # 额外掉落的小麦数量
FISH:
chance: 0.25 # 额外捕获的概率为 25%
MOB:
chance: 0.20 # 繁殖时额外获得生物的几率为 20%
FUEL:
chance: 0.03 # 每挖掘一个符合条件的方块有 3% 的几率
blocks: [STONE, DEEPSLATE, COBBLED_DEEPSLATE, NETHERRACK]
? Wilderness Flags
wilderness: # 未占领(荒野)地块的全局规则
block-break: true # 允许在荒野中破坏方块
block-place: true # 允许在荒野中放置方块
pvp: true # 允许在荒野中进行 PvP
mob-spawning: true # 允许在荒野中生成生物
hostile-spawning: true # 允许在荒野中生成敌对生物
explosions: true # 允许在荒野中发生爆炸
fire-spread: true # 允许在荒野中火势蔓延
ender-pearl: true # 允许在荒野中使用末影珍珠传送
chorus-fruit: true # 允许在荒野中使用紫颂果传送
? Storage Backend
storage:
type: sqlite # 存储类型:yaml、sqlite 或 mysql (⭐ mysql = premium)
mysql: # ⭐ 仅限高级版 — MySQL 连接设置
host: localhost # 数据库服务器主机名
port: 3306 # 数据库服务器端口
database: peatowny # 数据库名称
username: root # 数据库用户名
password: '' # 数据库密码
?️ Nation Claims
nation-claims:
max-claims: 3 # 国家级别的地块占用上限
transfer-hours: 24 # 完成地块转移所需的小时数
? Relations (⭐ Premium)
relations:
enabled: true # 启用关系系统
cost: 0.0 # 更改关系的经济成本
nation-auto-ally: true # 同一国家内的地块自动结盟
? GUI & Messages
command-aliases: # 定义自定义子命令别名
lands: {} # 示例: claim: ["takechunk", "grabland"]
nations: {} # 示例: create: ["nationmake"]
gui:
text-style: normal # ⭐ 文本样式:'normal' 或 'smallcaps'(Unicode 小型大写字母)
messages:
prefix: "&8[&aPeaTowny&8] &7" # 所有插件聊天消息的前缀
? Getting Started
- ? Download PeaTowny from our Discord
- ? Drop the JAR into your server's
plugins/ folder
- ? Restart your server
- ? Players automatically receive a selection tool and claim block on first join
- ✨ Use
/lands, /pea, or /town to open the GUI
? Upgrading to Premium
- ? Purchase from our Discord
- ? Replace
PeaTowny-Free.jar with the premium JAR
- ? Restart — all existing data is preserved
- ? Premium features unlock automatically, zero migration needed
? Support & Community
Need help? Have a suggestion? Want to grab Premium?
? Discord: discord.gg/Y8QhgYaq6K
? Made with love by Pea Studios
? PeaTowny
The modern land-claiming & town management plugin.
Drop-in replacement for Towny & Lands — familiar /lands commands, zero learning curve.
? Discord ·
? Free Edition ·
⭐ Premium Edition ·
⚙️ Config

?️ Choose Your Edition
? Free Edition
Everything you need to run a land-claiming server.
Full protection, wars, GUI, economy, and admin tools.
Jump to Free Features ↓
|
⭐ Premium Edition
The complete experience — nations, conquest wars,
levels, sub-areas, rent, fly, and much more.
Jump to Premium Features ↓
|
? Free Edition
Zero cost. Fully functional. Create lands, invite members, manage permissions, wage wars, and protect your builds — everything you need out of the box.
? Land Management
| Feature |
Details |
| ?️ Create & Delete |
Players can own up to 3 lands (configurable) |
| ? Chunk Claiming |
Claim with /lands claim — creation auto-claims a 3x3 area |
| ? Auto-Claim |
Walk to claim chunks automatically with /lands autoclaim |
| ? Claim Block |
Place a physical block to instantly create a land (3x3 area) |
| ? Selection Tool |
Visual tool given on first join for selecting areas |
| ? Land Spawn |
Set and teleport to a spawn point within your land |
| ✏️ Rename |
Change your land's name anytime through GUI or command |
| ? Land Browser |
Browse all server lands via the GUI |
| ? Expand |
Expand your land's borders in a direction |
? Public Warp System
| Feature |
Details |
| ? Beacon Warps |
Step on any land beacon to open the public warp browser |
| ?️ Warp Browser |
Paginated GUI showing all public lands — click to teleport |
| ? Search |
Click the sign icon to search for a specific land by name |
| ? Warp Manager |
Land owners can toggle public/private and set a custom icon |
| ? Custom Icons |
Choose from 56+ block/item icons to represent your land |
? Members & Roles
| Feature |
Details |
| ? Invite System |
Invite players to join your land |
| ?️ 4 Default Roles |
Owner, Officer, Member, Visitor (built-in & undeletable) |
| ?️ Custom Roles |
Create additional roles with custom names & colors |
| ? Role Flags |
Fine-grained control: build, break, interact, containers, doors, PvP, etc. |
| ✅ Trust / Untrust |
Quickly add or remove members from your land |
?️ Protection
| Feature |
Details |
| ? Chunk-Based |
Claimed chunks are fully protected from outsiders |
| ? Natural Flags |
Toggle explosions, fire spread, mob spawning, PvP, pistons, liquid flow, etc. |
| ? Wilderness Rules |
Configurable protection rules for unclaimed land |
| ⚔️ Combat Tag |
Configurable duration, boss bar countdown, remove-on-death option |
? Economy (Vault)
| Feature |
Details |
| ? Land Bank |
Deposit and withdraw funds from your land's treasury |
| ? Chunk Costs |
Configurable price per chunk with scaling options |
| ? Teleport Costs |
Optional economy cost for spawn teleportation |
⚔️ War System (Kill Point Mode)
| Feature |
Details |
| ? Declare War |
Challenge another land to a kill-count war |
| ? Kill Tracking |
Per-player kill counts tracked and displayed |
| ? War Scoreboard |
/wars status shows detailed scoreboard with sides, kills, progress bars |
| ? Action Bar |
Live kill-point updates on your action bar during war |
| ? Victory |
First side to reach the kill threshold wins |
| ?️ Transfer |
Winner receives the loser's land — transfer within 24hrs or it reverts |
| ⏱️ Timeout |
Wars auto-end after a configurable duration |
| ? War Flags |
Configurable block break/place permissions during war with block whitelists |
| ? War GUI |
View active wars and status from the land menu |
? Visual & UI
| Feature |
Details |
| ?️ Full GUI |
Manage everything through clean inventory menus |
| ✨ Border Viz |
See land borders with particles or glowing block entities |
| ? Enter/Leave |
Action bar notifications when crossing land borders |
| ? Beacons |
Each land gets a beacon at its home chunk |
| ? Beacon Color |
Customize your beacon's color through the GUI |
? Admin Tools
| Feature |
Details |
?️ /landadmin |
Full admin management suite |
| ?️ Bypass Mode |
Admins bypass all land protections |
| ? Admin Lands |
Create server-protected areas (spawn, arenas) |
| ⚔️ Force War |
/landadmin forcewar — declare war between any two lands |
| ? End War |
/landadmin endwar — force-end any active war |
| ⚙️ Limits |
Chunk, land, and member limits via permissions |
| ? Permissions |
peatowny.chunks.<n>, peatowny.lands.<n>, peatowny.members.<n> |
? Data & Storage
| Feature |
Details |
| ? YAML |
Simple file-based data, no setup required |
| ?️ SQLite |
Lightweight database for better performance |
| ? Auto-Save |
Data saved every 5 minutes automatically |
? Integration
| Feature |
Details |
| ? Vault |
Full economy support |
| ?️ Dynmap & BlueMap |
Land claims rendered on your web map |
| ? Land Chat |
Private chat channel for land members |
⭐ Premium Edition
One-time purchase. Every feature unlocked. Just swap the JAR — all your data carries over instantly. Premium includes everything in Free plus the features below.
? Get Premium → discord.gg/Y8QhgYaq6K
?️ Nations
Group multiple lands into a powerful nation with shared governance, taxes, and diplomacy.
| Feature |
Details |
| ? Create Nations |
Form a nation from your level-5 capital land |
| ?️ Member Lands |
Invite other lands to join your nation |
| ? Nation Taxes |
Collect taxes from member lands |
| ?️ Nation Upkeep |
Per-chunk upkeep for national territory |
| ? Nation Chat |
Dedicated chat channel shared across all nation lands |
| ? Diplomacy |
Nation-level relations and war declarations |
⚔️ Full Conquest War (Capture Mode)
Transform combat into full-scale territorial warfare:
| Feature |
Details |
| ? Chunk Capturing |
Place a capture fence in enemy territory and hold the chunk |
| ? Boss Bar Progress |
Real-time capture progress visible to both sides |
| ?️ Contestation |
Defenders entering a captured chunk pause the timer |
| ? Beacon Win |
Capture the enemy's home beacon to win instantly |
| ?️ Surrender & Tribute |
Losing side can surrender and pay up to 75% tribute |
| ?️ War Shields |
Protection periods after creation, surrender, and war end |
| ? Robbery |
Winners claim a percentage of the loser's bank |
| ? Territory Transfer |
Captured land transferred to the winner with 24hr deadline |
? Land Levels
Lands progress through 5 tiers as they grow:
| Level |
Title |
Members Required |
Balance Required |
Bonus Chunks |
| ⭐ 1 |
Settlement |
— |
— |
— |
| ⭐ 2 |
Village |
4 |
$7,500 |
+1 |
| ⭐ 3 |
Town |
8 |
$17,000 |
+2 |
| ⭐ 4 |
Province |
14 |
$30,000 |
+4 |
| ⭐ 5 |
Land |
24 |
$55,000 |
+8 |
? Relations
| Feature |
Details |
| ? Ally |
Shared protections between allied lands |
| ⚪ Neutral |
Default relation |
| ? Enemy |
Hostile relation with PvP enabled |
| ?️ Nation Auto-Ally |
Lands in the same nation are automatically allied |
? Resource Nodes
Each land is assigned a random resource type with bonus drops:
| Resource |
Bonus |
| ⛏️ Diamond |
Bonus diamond drops while mining stone/deepslate |
| ? Iron |
Bonus raw iron drops while mining |
| ? Gold |
Bonus raw gold drops while mining |
| ? Wheat |
Bonus crop yields on harvest |
| ? Fish |
Bonus catches while fishing |
| ? Mob |
Bonus spawns from breeding |
| ⛽ Fuel |
Collectible fuel sent to your fuel chest |
?️ Sub-Areas
Divide your land into sub-areas with independent permission sets. Perfect for public markets, member housing, restricted zones, or visitor areas within a single land.
? Rent & Sell
List lands for rent or sale on the marketplace. Players browse available listings, rent on a recurring cycle, or purchase outright.
? Land Storage
Per-land shared storage accessible through the GUI — a communal chest for your land members.
?️ Fly
Members can fly freely within their own land. Automatically disabled when leaving territory or entering combat.
? Upkeep & Taxes
| Feature |
Details |
| ?️ Upkeep |
Lands pay per-chunk upkeep on a configurable cycle |
| ? Taxes |
Land owners set a member tax rate — auto-untrust on failure to pay |
?️ MySQL Storage
Connect to a MySQL database for large networks and multi-server setups.
✍️ Custom Messages
Edit every single message in messages.yml — change wording, colors, and placeholders to match your server brand.
? GUI Text Style
Toggle between normal text and Unicode small-caps for a sleek, premium GUI look.
? Migration
Import data from Lands and Towny with a single command. Switch without losing anything.
?️ Minimap
In-game chunk minimap showing nearby claims, wilderness, and resource types right on your screen.
? Free vs Premium at a Glance
| Feature |
? Free |
⭐ Premium |
| ? Land claiming & protection |
✅ |
✅ |
| ?️ Roles & permissions |
✅ |
✅ |
| ? Economy & land bank |
✅ |
✅ |
| ?️ GUI menus |
✅ |
✅ |
| ✨ Border visualization |
✅ |
✅ |
| ? Beacon markers & color |
✅ |
✅ |
| ? Public warp system |
✅ |
✅ |
| ? Land chat |
✅ |
✅ |
| ?️ Dynmap / BlueMap |
✅ |
✅ |
| ? YAML & SQLite storage |
✅ |
✅ |
| ? Admin tools & bypass |
✅ |
✅ |
| ⚔️ War (kill-point mode) |
✅ |
✅ |
| ? War land transfer |
✅ |
✅ |
| ? War scoreboard & action bar |
✅ |
✅ |
| ? War flags (block break/place) |
✅ |
✅ |
| ⚔️ Combat tag with boss bar |
✅ |
✅ |
|
|
|
| ? War (chunk capture & conquest) |
❌ |
✅ |
| ?️ Nations & nation chat |
❌ |
✅ |
| ? Land levels (5 tiers) |
❌ |
✅ |
| ? Relations (ally/enemy) |
❌ |
✅ |
| ? Resource nodes |
❌ |
✅ |
| ?️ Sub-areas |
❌ |
✅ |
| ? Rent & sell |
❌ |
✅ |
| ? Land storage |
❌ |
✅ |
| ?️ Fly in land |
❌ |
✅ |
| ? Upkeep & taxes |
❌ |
✅ |
| ?️ MySQL support |
❌ |
✅ |
| ✍️ Custom messages |
❌ |
✅ |
| ? GUI small-caps style |
❌ |
✅ |
| ? Plugin migration |
❌ |
✅ |
| ?️ Minimap |
❌ |
✅ |
? Commands
Main Commands (Multiple Aliases)
All main commands open the same land GUI. Use whichever feels natural.
| Command |
Aliases |
Description |
/lands |
/land, /l |
Main land command & GUI |
/pea |
/p, /peatowny, /pt |
Same as /lands |
/town |
/t |
Same as /lands |
/nations |
/nation, /n |
Nation management (Premium) |
/wars |
/war, /defeated |
War commands |
/landadmin |
/la, /ladmin |
Admin commands |
Land Subcommands
| Command |
Description |
/lands create <name> |
?️ Create a new land (claims 3x3 area) |
/lands claim |
? Claim the chunk you're in |
/lands unclaim |
↩️ Unclaim the current chunk |
/lands autoclaim |
? Toggle auto-claim mode |
/lands expand |
? Expand your land borders |
/lands invite <player> |
? Invite a player |
/lands trust <player> |
✅ Trust a player |
/lands untrust <player> |
❌ Remove a player |
/lands setrole <player> <role> |
?️ Assign a role to a member |
/lands spawn [name] |
? Teleport to land spawn |
/lands setspawn |
? Set your land's spawn point |
/lands movebeacon |
? Move your land's beacon |
/lands fly |
?️ Toggle flight (Premium) |
/lands chat |
? Toggle land chat |
/lands map |
?️ Toggle minimap (Premium) |
/lands menu |
?️ Open land management GUI |
/lands info [name] |
ℹ️ View land info |
/lands list |
? List all lands |
/lands top |
? View top lands |
/lands deposit <amount> |
? Deposit to land bank |
/lands withdraw <amount> |
? Withdraw from land bank |
/lands balance |
? Check land balance |
/lands rename <name> |
✏️ Rename your land |
/lands delete |
?️ Delete your land |
/lands view |
?️ Toggle border visualization |
/lands buy |
? Buy a land listing (Premium) |
/lands storage |
? Access land storage (Premium) |
War Subcommands
| Command |
Description |
/wars declare <land> |
? Declare war on a land |
/wars surrender |
?️ Surrender the current war |
/wars status |
? View detailed war scoreboard |
/wars info |
ℹ️ View war info |
/wars list |
? List active wars |
/wars transfer <land> |
? Transfer captured land |
Nation Subcommands (Premium)
| Command |
Description |
/nations create <name> |
? Create a nation |
/nations invite <land> |
? Invite a land to your nation |
/nations kick <land> |
❌ Remove a land from your nation |
/nations leave |
? Leave your nation |
/nations info [name] |
ℹ️ View nation info |
/nations list |
? List all nations |
Admin Subcommands
| Command |
Description |
/landadmin bypass |
?️ Toggle admin bypass mode |
/landadmin unclaim |
↩️ Force unclaim a chunk |
/landadmin delete <land> |
?️ Force delete a land |
/landadmin give <player> <amount> |
? Give claim chunks to a player |
/landadmin setowner <land> <player> |
? Change land owner |
/landadmin setresource <land> <type> |
? Set land resource type |
/landadmin forcewar <land1> <land2> |
⚔️ Force declare a war |
/landadmin endwar <land> [winner] |
? Force end an active war |
/landadmin migrate <plugin> |
? Import from Lands/Towny (Premium) |
/landadmin reload |
? Reload plugin config |
⚙️ Configuration Reference
Full breakdown of every option in config.yml. Lines marked with ⭐ are Premium Only.
? Core Settings
basic-mode: false # Simplified mode — disables advanced features for a simpler experience
?️ Feature Toggles
features:
upkeep: true # ⭐ Enable per-chunk upkeep costs (lands pay to maintain chunks)
taxes: true # ⭐ Enable land owner taxation of members
relations: true # ⭐ Enable ally/enemy relations between lands
wars: true # Enable the war system (kill-point and capture modes)
nations: true # ⭐ Enable the nations system (group lands together)
levels: true # ⭐ Enable land leveling progression (Settlement → Land)
? General Settings
general:
claim-worlds: # Which worlds allow claiming (* = all worlds)
- '*'
language: 'en-US' # Language locale for messages
edit-by-loc: false # Allow editing land settings based on location
first-join-items: # Items given to players on their first join
selection:
enabled: true # Give the selection wand tool
slot: 1 # Inventory slot for the selection tool
info:
enabled: true # Give the info tool (right-click to inspect chunks)
slot: 2 # Inventory slot for the info tool
camp:
enabled: false # Give the camp item (portable base)
claim-block:
enabled: true # Give a claim block (place to create a land instantly)
slot: 3 # Inventory slot for the claim block
date-format: 'MM/dd/yyyy hh:mm a' # Date display format throughout the plugin
eco-format: '$#,##0.00' # Economy number format (currency display)
? Economy Cycle
economic:
interval:
days: 7 # Days between each economy cycle (upkeep/tax collection)
time: '23:00:00' # Time of day when the cycle runs (HH:mm:ss)
?️ Upkeep (⭐ Premium)
upkeep:
per-chunk: 3.0 # Cost per chunk each economy cycle
unclaim-on-fail: false # Auto-unclaim chunks when a land can't pay upkeep
no-pay-period: 2d # Grace period after land creation before upkeep starts
? Taxes (⭐ Premium)
taxes:
min: 0 # Minimum tax rate a land owner can set
max: 10.0 # Maximum tax rate a land owner can set
untrust-on-fail: true # Auto-remove members who fail to pay taxes
? Teleportation
teleport:
cost: 0 # Economy cost to teleport to a land spawn
delay: 3 # Seconds to wait before teleporting (warmup)
cancel-on-move: true # Cancel teleport if the player moves during warmup
cooldown: 30 # Seconds between teleport uses
⚔️ Combat Tag
combat:
enabled: true # Enable the combat tag system
duration: 15 # Combat tag duration in seconds after last hit
boss-bar: true # Show a boss bar countdown during combat tag
remove-on-death: true # Clear combat tag when the tagged player dies
? Land Settings
land:
creation:
force: false # Force players to create a land before claiming
cost: 0.0 # Economy cost to create a new land
claim-radius: 1 # Initial claim radius on creation (1 = 3x3 area)
name:
spaces: false # Allow spaces in land names
max-length: 24 # Maximum characters in a land name
color: true # Allow color codes (&a, &b, etc.) in names
numbers: true # Allow numbers in land names
chunk-distance:
mode: EUCLIDEAN # Distance calculation mode (EUCLIDEAN or MANHATTAN)
land: 1 # Minimum chunk distance between different lands
nation: 3 # Minimum chunk distance between different nations
force-near:
enabled: true # New claims must be adjacent to existing claims
treat-as-new: true # Treat first claim as a "new land" (no adjacency needed)
spawn:
auto-set: true # Automatically set spawn when a land is created
cost:
set: 0.0 # Cost to set a land spawn
change: 0.0 # Cost to change an existing spawn
teleport:
cost: 0.0 # Cost to teleport to spawn (overrides global teleport.cost)
cooldown: 0 # Spawn-specific teleport cooldown in seconds
re-spawn: true # Respawn at land spawn on death
invite:
enabled: true # Enable the invite system
invite-owner: true # Allow inviting players who already own a land
broadcast:
create: true # Broadcast a message when a land is created
delete: true # Broadcast a message when a land is deleted
chat:
forward-to-console: false # Forward land chat messages to the server console
mute-global: false # Mute global chat when land chat is active
fly: # ⭐ Premium Only
enabled: true # Enable /lands fly command
disable-delay: 3 # Seconds of hover time before fly disables on leaving land
setowner:
enabled: true # Allow transferring land ownership
cost: 5000.0 # Cost to transfer ownership
rent: # ⭐ Premium Only
rent: true # Enable renting lands
sell: true # Enable selling lands
expiration:
owner-offline: 60d # Delete land after owner is offline for this duration
delete-land: true # Actually delete the land on expiration (vs just flagging)
storage: true # ⭐ Enable per-land shared storage chests
? Chunk Settings
chunk:
cost:
buy: 0.0 # Cost per chunk claimed
refund: 0 # Refund percentage when unclaiming (0-100)
increase: 0.0 # Additive price increase for each additional chunk
max-claims: 0 # Hard max chunks per land (0 = use permission-based limits)
initial-claims: 10 # Default max chunks for new lands (no permission set)
scaling:
enabled: true # Scale max chunks based on member count
base-chunks: 10 # Starting chunk limit
per-member: 5 # Additional chunks per member joined
? Limits
limits:
default-chunks: 10 # Default max chunks if no permission node set
default-lands: 3 # Default max lands per player
default-members: 10 # Default max members per land
permission-stacking: false # Stack multiple permission nodes (add) vs take highest
Permission nodes: peatowny.chunks.<n>, peatowny.lands.<n>, peatowny.members.<n>
✨ Visualization
visualization:
type: ENTITY # Border display type: ENTITY (glowing blocks) or PARTICLE
duration: 15 # How long borders stay visible (seconds)
show-on-enter: true # Auto-show borders when entering a land
particle: FLAME # Particle type for PARTICLE mode
border-block: GLOWSTONE # Block type for ENTITY mode border display
⚔️ War Settings
war:
enabled: true # Enable the war system
mode: killpoint # War mode: 'killpoint' (free+premium) or 'capture' (⭐ premium only)
# killpoint = kills determine the winner
# capture = chunk capturing determines the winner
only-nations: false # Only allow war between nations (not individual lands)
declaration:
min-players:
attacker: 0 # Minimum online members required for the attacking side
defender: 0 # Minimum online members required for the defending side
preparation-time: 1d # Time between declaration and war start
mutual: false # Require both sides to agree before war starts
min-balance:
attacker: 5000 # Minimum land bank balance to declare war
defender: 0 # Minimum defender balance required
points:
kill: 1 # Points awarded per player kill
capture: 5 # Points awarded per chunk captured (⭐ capture mode)
to-win-per-player: 5 # Points-to-win calculated per online player on each side
min-to-win: 100 # Minimum total points needed to win regardless of player count
timeout: 36h # Auto-end war after this duration (supports d, h, m)
surrender:
tribute-max: 75% # Maximum bank percentage the winner can demand on surrender
shield:
creation: 1d # War shield after land creation (can't be attacked)
surrender: 4d # War shield after surrendering
end: 7d # War shield after a war ends
end:
robbery: 75% # Percentage of loser's bank the winner takes
transfer:
timeout: 24 # Hours the winner has to transfer captured land before it reverts
keep-inventory: false # Keep inventory on death during war
capture: # ⭐ Premium Only — chunk capture settings
enabled: true # Enable chunk capturing mechanic
hold-time: 600 # Seconds a capture fence must be held to capture a chunk
max-active: 3 # Maximum simultaneous capture attempts per war
fence-block: OAK_FENCE # Block type used as the capture fence
boss-bar-color: GREEN # Boss bar color during active capture
pause-bar-color: RED # Boss bar color when capture is contested/paused
flags: # War flags — permissions bypassed between warring lands
enabled: [] # Flags to enable: BLOCK_BREAK, BLOCK_PLACE, INTERACT,
# CONTAINER_ACCESS, DOOR_USE, EXPLOSIONS
block-whitelist: # Per-flag block whitelists (empty = all blocks allowed)
BLOCK_BREAK: [] # Only these blocks can be broken during war
BLOCK_PLACE: [] # Only these blocks can be placed during war
?️ Nation Settings (⭐ Premium)
nation:
enabled: true # Enable nations
creation:
cost: 20000.0 # Economy cost to create a nation
capital-level: 5 # Minimum land level required for the capital
name:
max-length: 24 # Maximum nation name length
spaces: false # Allow spaces in nation names
color: true # Allow color codes in nation names
taxes:
min: 0 # Minimum nation tax rate
max: 5.0 # Maximum nation tax rate
remove-on-fail: true # Remove lands that fail to pay nation taxes
upkeep:
enabled: true # Enable nation-level upkeep
per-chunk: 3.0 # Per-chunk upkeep cost for nation territory
delete-on-fail: true # Delete nation if it can't pay upkeep
? Land Levels (⭐ Premium)
levels:
enabled: true # Enable the level progression system
keep-level: false # Keep level when members leave (false = auto-downgrade)
land:
1:
title: 'Settlement' # Display title for level 1
attributes:
bonus-chunks: 0 # Extra chunk slots at this level
2:
title: 'Village'
requirements:
members: 4 # Members needed to reach level 2
balance: 7500 # Land bank balance needed for level 2
attributes:
bonus-chunks: 1
3:
title: 'Town'
requirements:
members: 8
balance: 17000
attributes:
bonus-chunks: 2
4:
title: 'Province'
requirements:
members: 14
balance: 30000
attributes:
bonus-chunks: 4
5:
title: 'Land'
requirements:
members: 24
balance: 55000
attributes:
bonus-chunks: 8
? Natural Flags
natural-flags: # Default values for land-wide flags (toggled per-land in GUI)
EXPLOSIONS: false # Allow explosions within the land
FIRE_SPREAD: false # Allow fire to spread
MOB_SPAWNING: true # Allow passive mob spawning
HOSTILE_SPAWNING: true # Allow hostile mob spawning
LEAF_DECAY: true # Allow leaf block decay
PISTON: true # Allow pistons to push/pull blocks
LIQUID_FLOW: false # Allow water/lava flow
SNOW_MELT: true # Allow snow to melt
PVP: false # Allow PvP between members
ENTRY: true # Allow non-members to enter the land
ENTER_NOTIFY: true # Show action bar notification when entering
? Resources (⭐ Premium)
resources:
enabled: true # Enable the resource node system
types:
DIAMOND:
chance: 0.005 # 0.5% chance per qualifying block mined
blocks: [STONE, DEEPSLATE, COBBLED_DEEPSLATE] # Blocks that trigger the bonus
drop: DIAMOND # Item dropped as bonus
IRON:
chance: 0.02 # 2% chance
blocks: [STONE, DEEPSLATE, COBBLED_DEEPSLATE]
drop: RAW_IRON
GOLD:
chance: 0.01 # 1% chance
blocks: [STONE, DEEPSLATE, COBBLED_DEEPSLATE]
drop: RAW_GOLD
WHEAT:
chance: 0.15 # 15% chance on crop harvest
bonus-amount: 2 # Extra wheat dropped
FISH:
chance: 0.25 # 25% chance for bonus catch
MOB:
chance: 0.20 # 20% chance for extra mob from breeding
FUEL:
chance: 0.03 # 3% chance per qualifying block
blocks: [STONE, DEEPSLATE, COBBLED_DEEPSLATE, NETHERRACK]
? Wilderness Flags
wilderness: # Global rules for unclaimed (wilderness) land
block-break: true # Allow block breaking in wilderness
block-place: true # Allow block placing in wilderness
pvp: true # Allow PvP in wilderness
mob-spawning: true # Allow mob spawning in wilderness
hostile-spawning: true # Allow hostile mob spawning in wilderness
explosions: true # Allow explosions in wilderness
fire-spread: true # Allow fire spread in wilderness
ender-pearl: true # Allow ender pearl teleportation in wilderness
chorus-fruit: true # Allow chorus fruit teleportation in wilderness
? Storage Backend
storage:
type: sqlite # Storage type: yaml, sqlite, or mysql (⭐ mysql = premium)
mysql: # ⭐ Premium Only — MySQL connection settings
host: localhost # Database server hostname
port: 3306 # Database server port
database: peatowny # Database name
username: root # Database username
password: '' # Database password
?️ Nation Claims
nation-claims:
max-claims: 3 # Maximum nation-level claim slots
transfer-hours: 24 # Hours to complete a claim transfer
? Relations (⭐ Premium)
relations:
enabled: true # Enable the relations system
cost: 0.0 # Economy cost to change a relation
nation-auto-ally: true # Auto-ally lands within the same nation
? GUI & Messages
command-aliases: # Define custom subcommand aliases
lands: {} # Example: claim: ["takechunk", "grabland"]
nations: {} # Example: create: ["nationmake"]
gui:
text-style: normal # ⭐ Text style: 'normal' or 'smallcaps' (Unicode small capitals)
messages:
prefix: "&8[&aPeaTowny&8] &7" # Chat message prefix for all plugin messages
? Getting Started
- ? Download PeaTowny from our Discord
- ? Drop the JAR into your server's
plugins/ folder
- ? Restart your server
- ? Players automatically receive a selection tool and claim block on first join
- ✨ Use
/lands, /pea, or /town to open the GUI
? Upgrading to Premium
- ? Purchase from our Discord
- ? Replace
PeaTowny-Free.jar with the premium JAR
- ? Restart — all existing data is preserved
- ? Premium features unlock automatically, zero migration needed
? Support & Community
Need help? Have a suggestion? Want to grab Premium?
? Discord: discord.gg/Y8QhgYaq6K
? Made with love by Pea Studios
评论 0
登录后参与评分
还没有评论,来抢沙发吧