? Secure Plots
Minecraft 1.21.1 — Fabric
一款带有菜单、角色、升级、基于等级的权限、环境特效以及完全可配置的视觉边界系统的领地保护模组。
依赖项
- Minecraft 1.21.1
- Fabric Loader ≥ 0.15.0
- Fabric API
- Java 21+
安装方法
- 将
.jar 文件放入服务器和客户端的 mods/ 文件夹中。
- 启动一次服务器,以便在
config/ 目录中生成配置文件。
- 编辑
secure_plots.json(服务器行为)和 secure_plots_client.json(视觉设置)。
工作原理
放置一个 地块方块 以认领该区域。方块的等级决定了受保护区域的大小。右键点击该方块或使用 地块蓝图 物品打开管理菜单。
地块等级(均可配置)
| 等级 |
名称 |
默认半径 |
| 0 |
Bronze |
15 × 15 |
| 1 |
Gold |
30 × 30 |
| 2 |
Emerald |
50 × 50 |
| 3 |
Diamond |
75 × 75 |
| 4 |
Netherite |
100 × 100 |
指令
所有指令均支持使用 /sp 或 /secureplots。
玩家指令
| 指令 |
描述 |
/sp help |
显示所有指令 |
/sp list |
列出你的地块 |
/sp info [plot] |
显示你所在的地块信息,或指定名称/编号的地块信息 |
/sp view |
显示你最近的地块的边界 |
/sp rename <name> |
重命名你当前站立的地块 |
/sp add <player> <plot|all> |
向一个或多个所有地块添加成员 |
/sp remove <player> <plot|all> |
从一个或多个所有地块移除成员 |
/sp role <player> <member|admin> |
更改你当前站立地块中成员的权限角色 |
/sp tp [plot] |
通过名称或编号传送至某地块 |
/sp upgrade |
升级你当前站立的地块(消耗材料) |
/sp myrank |
显示你当前的等级特权 |
/sp flag |
列出可用的全局标志 |
/sp flag <flag> <true|false> [plot] |
设置全局标志 |
/sp perm |
列出可用的个体权限 |
/sp perm <player> <perm> <true|false> [plot] |
为某成员设置权限 |
/sp fly [true|false] [plot] |
切换你当前站立地块的飞行模式 |
/sp group |
列出当前地块的权限组 |
/sp group create <name> |
创建权限组 |
/sp group delete <name> |
删除权限组 |
/sp group addmember <group> <player> |
将成员添加到组 |
/sp group removemember <group> <player> |
从组中移除成员 |
/sp group setperm <group> <perm> <true|false> |
为组设置权限 |
/sp plot particle <type|clear> |
设置进入地块时的环境粒子效果 |
/sp plot weather <clear|rain|thunder|none> |
覆盖地块内的天气 |
/sp plot time <day|noon|sunset|night|midnight|sunrise|<ticks>|reset> |
覆盖地块内的时间 |
/sp plot music <sound_id|clear> |
在地块入口播放音乐 |
/sp plot enter <message|clear> |
设置进入标题消息 |
/sp plot exit <message|clear> |
设置离开标题消息 |
地块参数: 大多数接受 [plot] 参数的指令都接受地块名称、/sp list 中的编号或 all。
管理员指令
所有 /sp admin 指令需要 OP 等级 ≥ adminOpLevel(默认值:2)。
| 指令 |
描述 |
/sp admin listall [page] |
分页列出服务器上的所有地块(每页 10 个) |
/sp admin search <player> [page] |
列出特定玩家拥有的所有地块 |
/sp admin nearby [count] [x y z] |
显示距你当前位置或给定坐标最近的 N 个地块 |
/sp admin list <player> |
快速列出某玩家的地块 |
/sp admin info <player> <plot> |
显示另一位玩家的地块的完整信息 |
/sp admin tp <player> <plot> |
传送到另一位玩家的地块 |
/sp admin delete <player> <plot|all> |
删除某玩家的一个或所有地块 |
/sp admin rename <player> <plot> <name> |
重命名另一位玩家的地块 |
/sp admin setowner <newowner> |
转移你当前站立地块的所有权 |
/sp admin upgrade <player> <plot> |
强制升级某地块(不消耗材料) |
/sp admin rank <player> <plot> <true|false> |
切换等级保护(免疫闲置过期) |
/sp admin particle <player> <plot> <type> |
在任何地块上设置粒子效果 |
/sp admin music <player> <plot> <sound> |
在任何地块上设置音乐 |
/sp admin weather <player> <plot> <type> |
在任何地块上设置天气 |
/sp admin time <player> <plot> <value> |
在任何地块上设置时间 |
/sp admin enter <player> <plot> <message> |
在任何地块上设置进入消息 |
/sp admin exit <player> <plot> <message> |
在任何地块上设置离开消息 |
/sp admin setrank <player> <tag> |
为玩家添加等级标签(/tag <player> add <tag> 的快捷方式) |
/sp admin removerank <player> <tag> |
从玩家移除等级标签 |
/sp admin reload |
重新加载两个配置文件并同步所有客户端(无需重启) |
角色与权限
角色
| 角色 |
描述 |
OWNER |
完全控制 —— 可以破坏方块、升级、重命名 |
ADMIN |
可以管理成员、权限和标志 |
MEMBER |
默认的受信任玩家 |
VISITOR |
未明确添加的任何人都属于此角色 |
全局标志 (/sp flag)
全局标志影响地块内的所有人,包括访客。
| 标志 |
默认值 |
描述 |
ALLOW_VISITOR_BUILD |
off |
任何人都可以放置和破坏方块 |
ALLOW_VISITOR_INTERACT |
off |
任何人都可以使用门、拉杆、按钮 |
ALLOW_VISITOR_CONTAINERS |
off |
任何人都可以打开箱子 |
ALLOW_PVP |
off |
所有玩家启用 PvP |
ALLOW_FLY |
off |
所有人可以飞行 |
ALLOW_TP |
on |
任何人都可以 /sp tp 到该地块 |
GREETINGS |
on |
显示进入/退出标题消息 |
独立权限 (/sp perm)
可为每个成员或每个权限组分配。
建造: BUILD BREAK PLACE
交互: INTERACT CONTAINERS USE_BEDS USE_CRAFTING USE_ENCHANTING USE_ANVIL USE_FURNACE USE_BREWING
实体: ATTACK_MOBS ATTACK_ANIMALS PVP RIDE_ENTITIES INTERACT_MOBS LEASH_MOBS SHEAR_MOBS MILK_MOBS
自然: CROP_TRAMPLING PICKUP_ITEMS DROP_ITEMS BREAK_CROPS PLANT_SEEDS USE_BONEMEAL BREAK_DECOR
爆炸物: DETONATE_TNT GRIEFING
其他: TP FLY ENTER CHAT COMMAND_USE
管理: MANAGE_MEMBERS MANAGE_PERMS MANAGE_FLAGS MANAGE_GROUPS
基于等级的权限
等级允许你为不同的玩家提供不同的地块功能限制——而无需逐个调整玩家的独立权限。等级使用原版命令标签,通过 /tag <player> add <tag> 分配。
工作原理
- 在
secure_plots.json 的 rankPerks 下定义等级。
- 使用
/tag <player> add <tag> 或快捷方式 /sp admin setrank <player> <tag> 为玩家分配标签。
- 没有等级标签的玩家使用全局默认值。
- 如果玩家拥有多个等级标签,则每个字段的最宽松值生效。
adminTag 始终绕过所有等级限制。
等级字段
| 字段 |
默认值 |
描述 |
tag |
— |
用于匹配的命令标签 |
maxPlots |
0 |
该等级最多可拥有的地块数(0 = 使用全局 maxPlotsPerPlayer) |
maxTier |
4 |
该等级可放置的最高地块层级(0–4) |
canRename |
true |
可以重命名其地块 |
canSetMusic |
true |
可以设置地块音乐 |
canSetParticles |
true |
可以设置地块粒子效果 |
canSetWeather |
true |
可以设置天气覆盖 |
canSetTime |
true |
可以设置时间覆盖 |
canSetEnterExit |
true |
可以设置进入/退出消息 |
canTp |
true |
可以使用 /sp tp 传送至自己的地块 |
canFly |
true |
可以在其地块上启用飞行 |
canUpgrade |
true |
可以升级其地块层级 |
canGroups |
true |
可以创建权限组 |
hasRankProtection |
false |
地块免疫因不活跃而过期 |
等级配置示例
"rankPerks": [
{
"tag": "basic",
"maxPlots": 1,
"maxTier": 0,
"canSetMusic": false,
"canSetParticles": false,
"canSetWeather": false,
"canSetTime": false,
"canFly": false,
"canUpgrade": false,
"canGroups": false
},
{
"tag": "vip",
"maxPlots": 5,
"maxTier": 3,
"canSetMusic": true,
"canSetParticles": true,
"canFly": true,
"canUpgrade": true
},
{
"tag": "mvp",
"maxPlots": 10,
"maxTier": 4,
"hasRankProtection": true
}
]
服务器配置 — secure_plots.json
功能开关
| 字段 |
默认值 |
描述 |
enableProtection |
true |
所有方块/交互保护的主开关 |
enableFlyInPlots |
true |
允许通过 FLY 权限授予飞行能力 |
enableEnterHud |
true |
进入时在工作栏显示地块名称 |
enableGreetingMessages |
true |
显示进入/退出标题消息 |
enablePlotParticles |
true |
进入地块时显示环境粒子效果 |
enablePlotMusic |
true |
进入地块时播放音乐 |
enablePlotWeather |
true |
支持按地块单独设置天气覆盖 |
enablePlotTime |
true |
支持按地块单独设置时间覆盖 |
enablePlotTeleport |
true |
允许使用 /sp tp |
enableHologram |
true |
在地块方块上方显示悬浮信息板 |
enablePvpControl |
true |
在没有 ALLOW_PVP 标志的地块中阻止 PvP |
enableUpgrades |
true |
允许层级升级 |
enablePermissionGroups |
true |
允许创建权限组 |
plotBlocksUnbreakable |
true |
非所有者无法破坏地块方块 |
allowNestedPlots |
false |
允许在其他地块内放置地块 |
常规设置
| 字段 |
默认值 |
描述 |
maxPlotsPerPlayer |
3 |
玩家默认最大地块数(0 = 无限制;会被 rankPerks 覆盖) |
plotBuffer |
15 |
地块之间的最小方块间隔 |
adminOpLevel |
2 |
执行 /sp admin 命令所需的 OP 等级(0–4) |
adminTag |
"plot_admin" |
授予完全管理员覆盖权限的命令标签 |
blockedStructurePrefixes |
["legendarymonuments:"] |
阻止放置地块的结构 ID 前缀 |
环境设置
| 字段 |
默认值 |
描述 |
particleCount |
3 |
进入地块时的粒子爆发数量(1–5) |
ambientParticleCount |
2 |
每个间隔内的持续粒子数量(1–5) |
ambientInterval |
20 |
环境粒子生成的tick间隔 |
checkInterval |
10 |
进入/退出检测检查的tick间隔 |
musicVolume |
4.0 |
音乐音量(0.1–4.0) |
不活跃过期
"inactivityExpiry": {
"enabled": false,
"baseDays": 45,
"daysPerTier": 5
}
启用后,如果所有者在 baseDays + (tier × daysPerTier) 天内未登录,地块将过期。具有 hasRankProtection 的地块免疫此机制。
层级配置
"tiers": [
{ "tier": 0, "displayName": "Bronze", "radius": 15, "luminance": 4, "hardness": 50, "blastResistance": 1200 },
{ "tier": 1, "displayName": "Gold", "radius": 30, "luminance": 5, "hardness": 50, "blastResistance": 1200 },
{ "tier": 2, "displayName": "Emerald", "radius": 50, "luminance": 6, "hardness": 50, "blastResistance": 1200 },
{ "tier": 3, "displayName": "Diamond", "radius": 75, "luminance": 7, "hardness": 50, "blastResistance": 1200 },
{ "tier": 4, "displayName": "Netherite", "radius": 100, "luminance": 8, "hardness": 50, "blastResistance": 1200 }
]
升级费用
每次升级可能需要来自任意模组的任意数量的物品。
"upgradeCosts": [
{ "fromTier": 0, "toTier": 1, "items": [{ "itemId": "minecraft:gold_block", "amount": 15 }] },
{ "fromTier": 1, "toTier": 2, "items": [{ "itemId": "minecraft:emerald_block", "amount": 10 }] },
{ "fromTier": 2, "toTier": 3, "items": [{ "itemId": "minecraft:diamond", "amount": 64 }] },
{ "fromTier": 3, "toTier": 4, "items": [{ "itemId": "minecraft:netherite_block", "amount": 1 }] }
]
默认角色权限
当通过角色添加成员时自动授予的权限。
"roleDefaults": {
"admin": ["BUILD", "INTERACT", "CONTAINERS", "PVP", "MANAGE_MEMBERS", "MANAGE_PERMS", "TP", "ENTER"],
"member": ["BUILD", "INTERACT", "CONTAINERS", "TP", "ENTER"],
"visitor": ["INTERACT", "ENTER"]
}
新地块的默认标志
"defaultFlags": ["ALLOW_TP", "GREETINGS"]
合成配方
用于地块方块和蓝图物品的配方。每个配方都可以单独禁用("disabled": true),使得该物品仅在创造模式或通过 /sp admin 获得。
"craftingRecipes": [
{
"result": "secure-plots:bronze_plot_block",
"pattern": ["CBC", "BHB", "CBC"],
"key": {
"C": "minecraft:copper_block",
"B": "minecraft:redstone_block",
"H": "minecraft:heart_of_the_sea"
}
},
{
"result": "secure-plots:plot_blueprint",
"pattern": ["SPS", "PCP", "SPS"],
"key": {
"S": "minecraft:amethyst_shard",
"P": "minecraft:paper",
"C": "minecraft:compass"
}
}
]
客户端视觉配置 — secure_plots_client.json
此文件位于服务器端,并在玩家加入时自动同步到所有客户端。在服务器端编辑它——更改将在下一次执行 /sp admin reload 时立即生效。
地块边界 — 厚度
| 字段 |
默认值 |
描述 |
edgeThickness |
0.06 |
核心边缘线宽度 |
glowThickness |
0.13 |
外部发光光环宽度 |
scanlineThickness |
0.025 |
垂直扫描线宽度 |
scanlineSpacing |
1.5 |
扫描线之间的方块数 |
borderHeight |
25.0 |
边界墙的高度(以方块为单位) |
地块边界 — 动画
| 字段 |
默认值 |
描述 |
pulseCycleMs |
2000 |
一次亮度脉冲周期的持续时间(毫秒) |
pulseMin |
0.6 |
最小亮度(0.0–1.0) |
pulseRange |
0.4 |
亮度变化范围(pulseMin + pulseRange ≤ 1.0) |
boltFlickerMs |
120 |
角落闪电雷击再生的频率(毫秒) |
地块边界 — 层级颜色
每个层级有 9 个颜色通道(值为 0.0–1.0):
"tierColors": [
{
"tier": 0,
"coreR": 1.0, "coreG": 0.55, "coreB": 0.05,
"glowR": 0.7, "glowG": 0.28, "glowB": 0.0,
"whiteR": 1.0, "whiteG": 0.88, "whiteB": 0.55
}
]
| 通道组 |
效果 |
coreR/G/B |
主边缘颜色 |
glowR/G/B |
外部光环颜色 |
whiteR/G/B |
内部明亮核心 |
全息投影
显示在地块方块上方的浮动信息面板。
| 字段 |
默认值 |
描述 |
hologramEnabled |
true |
显示/隐藏全息投影 |
hologramHeight |
3.0 |
位于地块方块上方的方块数 |
hologramMaxDistance |
24.0 |
最大渲染距离(以方块为单位) |
hologramScale |
0.025 |
文本缩放比例 |
hologramBackgroundOpacity |
0.75 |
面板背景不透明度(0.0–1.0) |
hologramPaddingX |
8 |
水平内边距(字体像素) |
hologramPaddingY |
6 |
垂直内边距(字体像素) |
hologramLineSpacing |
1 |
行之间的额外像素间距 |
hologramFadeInMs |
400 |
淡入持续时间(毫秒) |
hologramFadeOutMs |
600 |
过期前的淡出持续时间(毫秒) |
hologramFloat |
true |
启用上下浮动动画 |
hologramFloatAmplitude |
0.1 |
浮动范围(以方块为单位) |
hologramFloatCycleMs |
3000 |
一次浮动周期的持续时间(毫秒) |
全息投影文本标签(全部可自定义)
| 字段 |
默认值 |
hologramDefaultName |
"PROTECTED PLOT" |
hologramLabelOwner |
"Owner: " |
hologramLabelTier |
"Tier: " |
hologramLabelSize |
"Size: " |
hologramLabelMembers |
"Members: " |
hologramLabelNext |
"Next: " |
hologramLabelMaxLevel |
"§6§l★ Max Level ★" |
地块管理屏幕
| 字段 |
默认值 |
描述 |
screenPanelWidth |
320 |
面板宽度(像素) |
screenPanelHeight |
240 |
面板高度(像素) |
screenRowSpacing |
16 |
信息行之间的像素间距 |
screenMaxNameLength |
32 |
地块名称的最大长度 |
屏幕面板颜色(ARGB 十六进制)
| 字段 |
默认值 |
screenColorBorderOuter |
0xFF373737 |
screenColorBackground |
0xFFC6C6C6 |
screenColorTitleBar |
0xFF555555 |
screenColorTitleBarTop |
0xFF666666 |
screenColorShadowDark |
0xFF8B8B8B |
screenColorShadowLight |
0xFFFFFFFF |
本地化
捆绑了两种语言:en_us(英语)和 es_es(拉普拉塔西班牙语)。所有 260+ 翻译键涵盖了命令、用户界面、工具提示、HUD 消息、权限名称以及所有面向玩家的字符串。
要添加其他语言,请在资源包中创建 assets/secure-plots/lang/<locale>.json,并使用现有文件作为模板。
服务器管理员快速参考
| 任务 |
命令 |
| 授予管理员权限 |
/tag <player> add plot_admin |
| 分配等级 |
/sp admin setrank <player> <tag> 或 /tag <player> add <tag> |
| 移除等级 |
/sp admin removerank <player> <tag> |
| 查看服务器所有地块 |
/sp admin listall |
| 按玩家查找地块 |
/sp admin search <player> |
| 查找附近的领地 |
/sp admin nearby 10 或 /sp admin nearby 10 100 64 -200 |
| 删除玩家的领地 |
/sp admin delete <player> all |
| 转移领地所有权 |
站在领地内,执行 /sp admin setowner <newowner> |
| 在游戏中重载配置 |
/sp admin reload |
| 给予创造模式剧情方块 | 站在剧情菜单 → 创造选项卡(仅限 OP) |
支持
如果 Secure Plots 对你的服务器有所帮助,请考虑支持开发:
许可证
GPL-3.0 — 版权所有 (C) 2025 TupacGodoy
? Secure Plots
Minecraft 1.21.1 — Fabric
Territory protection mod with menus, roles, upgrades, rank-based permissions, ambient effects, and a fully configurable visual border system.
Requirements
- Minecraft 1.21.1
- Fabric Loader ≥ 0.15.0
- Fabric API
- Java 21+
Installation
- Drop the
.jar into your mods/ folder on both server and client.
- Start the server once to generate config files in
config/.
- Edit
secure_plots.json (server behaviour) and secure_plots_client.json (visual settings).
How it works
Place a Plot Block to claim that area. The block's tier determines how large the protected zone is. Right-click the block or use the Plot Blueprint item to open the management menu.
Plot tiers (all configurable)
| Tier |
Name |
Default radius |
| 0 |
Bronze |
15 × 15 |
| 1 |
Gold |
30 × 30 |
| 2 |
Emerald |
50 × 50 |
| 3 |
Diamond |
75 × 75 |
| 4 |
Netherite |
100 × 100 |
Commands
All commands are available as /sp or /secureplots.
Player commands
| Command |
Description |
/sp help |
Show all commands |
/sp list |
List your plots |
/sp info [plot] |
Show info for the plot you're in, or a named/numbered plot |
/sp view |
Show the border of your nearest plot |
/sp rename <name> |
Rename the plot you're standing in |
/sp add <player> <plot|all> |
Add a member to one or all of your plots |
/sp remove <player> <plot|all> |
Remove a member from one or all of your plots |
/sp role <player> <member|admin> |
Change a member's role in the plot you're standing in |
/sp tp [plot] |
Teleport to a plot by name or number |
/sp upgrade |
Upgrade the plot you're standing in (consumes materials) |
/sp myrank |
Show your current rank perks |
/sp flag |
List available global flags |
/sp flag <flag> <true|false> [plot] |
Set a global flag |
/sp perm |
List available individual permissions |
/sp perm <player> <perm> <true|false> [plot] |
Set a permission for a member |
/sp fly [true|false] [plot] |
Toggle fly for the plot you're standing in |
/sp group |
List permission groups of the current plot |
/sp group create <name> |
Create a permission group |
/sp group delete <name> |
Delete a permission group |
/sp group addmember <group> <player> |
Add a member to a group |
/sp group removemember <group> <player> |
Remove a member from a group |
/sp group setperm <group> <perm> <true|false> |
Set a permission for a group |
/sp plot particle <type|clear> |
Set ambient particles on plot entry |
/sp plot weather <clear|rain|thunder|none> |
Override weather inside the plot |
/sp plot time <day|noon|sunset|night|midnight|sunrise|<ticks>|reset> |
Override time inside the plot |
/sp plot music <sound_id|clear> |
Play music on plot entry |
/sp plot enter <message|clear> |
Set the entry title message |
/sp plot exit <message|clear> |
Set the exit title message |
Plot argument: most commands that accept [plot] accept a plot name, its number from /sp list, or all.
Admin commands
All /sp admin commands require OP level ≥ adminOpLevel (default: 2).
| Command |
Description |
/sp admin listall [page] |
List every plot on the server, paginated (10 per page) |
/sp admin search <player> [page] |
List all plots owned by a specific player |
/sp admin nearby [count] [x y z] |
Show the N nearest plots to your position or given coordinates |
/sp admin list <player> |
Quick list of a player's plots |
/sp admin info <player> <plot> |
Show full info for another player's plot |
/sp admin tp <player> <plot> |
Teleport to another player's plot |
/sp admin delete <player> <plot|all> |
Delete one or all plots of a player |
/sp admin rename <player> <plot> <name> |
Rename another player's plot |
/sp admin setowner <newowner> |
Transfer ownership of the plot you're standing in |
/sp admin upgrade <player> <plot> |
Force-upgrade a plot (no materials consumed) |
/sp admin rank <player> <plot> <true|false> |
Toggle rank protection (immune to inactivity expiry) |
/sp admin particle <player> <plot> <type> |
Set particles on any plot |
/sp admin music <player> <plot> <sound> |
Set music on any plot |
/sp admin weather <player> <plot> <type> |
Set weather on any plot |
/sp admin time <player> <plot> <value> |
Set time on any plot |
/sp admin enter <player> <plot> <message> |
Set entry message on any plot |
/sp admin exit <player> <plot> <message> |
Set exit message on any plot |
/sp admin setrank <player> <tag> |
Add a rank tag to a player (shortcut for /tag <player> add <tag>) |
/sp admin removerank <player> <tag> |
Remove a rank tag from a player |
/sp admin reload |
Reload both config files and re-sync all clients (no restart needed) |
Roles & permissions
Roles
| Role |
Description |
OWNER |
Full control — can break the block, upgrade, rename |
ADMIN |
Can manage members, permissions, and flags |
MEMBER |
Default trusted player |
VISITOR |
Anyone not explicitly added |
Global flags (/sp flag)
Global flags affect everyone inside the plot, including visitors.
| Flag |
Default |
Description |
ALLOW_VISITOR_BUILD |
off |
Anyone can place and break blocks |
ALLOW_VISITOR_INTERACT |
off |
Anyone can use doors, levers, buttons |
ALLOW_VISITOR_CONTAINERS |
off |
Anyone can open chests |
ALLOW_PVP |
off |
PvP enabled for all players |
ALLOW_FLY |
off |
Everyone can fly |
ALLOW_TP |
on |
Anyone can /sp tp to this plot |
GREETINGS |
on |
Show enter/exit title messages |
Individual permissions (/sp perm)
Assignable per member or per permission group.
Construction: BUILD BREAK PLACE
Interaction: INTERACT CONTAINERS USE_BEDS USE_CRAFTING USE_ENCHANTING USE_ANVIL USE_FURNACE USE_BREWING
Entities: ATTACK_MOBS ATTACK_ANIMALS PVP RIDE_ENTITIES INTERACT_MOBS LEASH_MOBS SHEAR_MOBS MILK_MOBS
Nature: CROP_TRAMPLING PICKUP_ITEMS DROP_ITEMS BREAK_CROPS PLANT_SEEDS USE_BONEMEAL BREAK_DECOR
Explosives: DETONATE_TNT GRIEFING
Misc: TP FLY ENTER CHAT COMMAND_USE
Management: MANAGE_MEMBERS MANAGE_PERMS MANAGE_FLAGS MANAGE_GROUPS
Rank-based permissions
Ranks let you give different players different plot feature limits — without touching individual permissions per player. Ranks use vanilla command tags, assigned with /tag <player> add <tag>.
How it works
- Define ranks in
secure_plots.json under rankPerks.
- Assign tags to players with
/tag <player> add <tag> or the shortcut /sp admin setrank <player> <tag>.
- Players with no rank tag use the global defaults.
- If a player has multiple rank tags, the most permissive value of each field wins.
- The
adminTag always bypasses all rank restrictions.
Rank fields
| Field |
Default |
Description |
tag |
— |
The command tag to match |
maxPlots |
0 |
Max plots this rank can own (0 = use global maxPlotsPerPlayer) |
maxTier |
4 |
Highest plot tier (0–4) this rank can place |
canRename |
true |
Can rename their plot |
canSetMusic |
true |
Can set plot music |
canSetParticles |
true |
Can set plot particles |
canSetWeather |
true |
Can set a weather override |
canSetTime |
true |
Can set a time override |
canSetEnterExit |
true |
Can set enter/exit messages |
canTp |
true |
Can use /sp tp to their own plot |
canFly |
true |
Can enable fly on their plot |
canUpgrade |
true |
Can upgrade their plot tier |
canGroups |
true |
Can create permission groups |
hasRankProtection |
false |
Plot is immune to inactivity expiry |
Example rank config
"rankPerks": [
{
"tag": "basic",
"maxPlots": 1,
"maxTier": 0,
"canSetMusic": false,
"canSetParticles": false,
"canSetWeather": false,
"canSetTime": false,
"canFly": false,
"canUpgrade": false,
"canGroups": false
},
{
"tag": "vip",
"maxPlots": 5,
"maxTier": 3,
"canSetMusic": true,
"canSetParticles": true,
"canFly": true,
"canUpgrade": true
},
{
"tag": "mvp",
"maxPlots": 10,
"maxTier": 4,
"hasRankProtection": true
}
]
Server config — secure_plots.json
Feature toggles
| Field |
Default |
Description |
enableProtection |
true |
Master switch for all block/interact protection |
enableFlyInPlots |
true |
Allow fly grants via the FLY permission |
enableEnterHud |
true |
Show plot name in action bar on entry |
enableGreetingMessages |
true |
Show enter/exit title messages |
enablePlotParticles |
true |
Ambient particles on plot entry |
enablePlotMusic |
true |
Music playback on plot entry |
enablePlotWeather |
true |
Per-plot weather override |
enablePlotTime |
true |
Per-plot time override |
enablePlotTeleport |
true |
Allow /sp tp |
enableHologram |
true |
Floating info display above plot blocks |
enablePvpControl |
true |
Block PvP in plots without ALLOW_PVP flag |
enableUpgrades |
true |
Allow tier upgrades |
enablePermissionGroups |
true |
Allow creating permission groups |
plotBlocksUnbreakable |
true |
Non-owners cannot break plot blocks |
allowNestedPlots |
false |
Allow placing plots inside other plots |
General
| Field |
Default |
Description |
maxPlotsPerPlayer |
3 |
Default max plots per player (0 = unlimited; overridden by rankPerks) |
plotBuffer |
15 |
Minimum block gap between plots |
adminOpLevel |
2 |
OP level required for /sp admin commands (0–4) |
adminTag |
"plot_admin" |
Command tag granting full admin override |
blockedStructurePrefixes |
["legendarymonuments:"] |
Structure ID prefixes that block plot placement |
Ambient settings
| Field |
Default |
Description |
particleCount |
3 |
Burst particle count on plot entry (1–5) |
ambientParticleCount |
2 |
Continuous particles per interval (1–5) |
ambientInterval |
20 |
Ticks between ambient particle spawns |
checkInterval |
10 |
Ticks between enter/exit detection checks |
musicVolume |
4.0 |
Music volume (0.1–4.0) |
Inactivity expiry
"inactivityExpiry": {
"enabled": false,
"baseDays": 45,
"daysPerTier": 5
}
When enabled, a plot expires if the owner hasn't logged in for baseDays + (tier × daysPerTier) days. Plots with hasRankProtection are immune.
Tier configuration
"tiers": [
{ "tier": 0, "displayName": "Bronze", "radius": 15, "luminance": 4, "hardness": 50, "blastResistance": 1200 },
{ "tier": 1, "displayName": "Gold", "radius": 30, "luminance": 5, "hardness": 50, "blastResistance": 1200 },
{ "tier": 2, "displayName": "Emerald", "radius": 50, "luminance": 6, "hardness": 50, "blastResistance": 1200 },
{ "tier": 3, "displayName": "Diamond", "radius": 75, "luminance": 7, "hardness": 50, "blastResistance": 1200 },
{ "tier": 4, "displayName": "Netherite", "radius": 100, "luminance": 8, "hardness": 50, "blastResistance": 1200 }
]
Upgrade costs
Each upgrade can require any number of items from any mod.
"upgradeCosts": [
{ "fromTier": 0, "toTier": 1, "items": [{ "itemId": "minecraft:gold_block", "amount": 15 }] },
{ "fromTier": 1, "toTier": 2, "items": [{ "itemId": "minecraft:emerald_block", "amount": 10 }] },
{ "fromTier": 2, "toTier": 3, "items": [{ "itemId": "minecraft:diamond", "amount": 64 }] },
{ "fromTier": 3, "toTier": 4, "items": [{ "itemId": "minecraft:netherite_block", "amount": 1 }] }
]
Default role permissions
Permissions automatically granted when a member is added by role.
"roleDefaults": {
"admin": ["BUILD", "INTERACT", "CONTAINERS", "PVP", "MANAGE_MEMBERS", "MANAGE_PERMS", "TP", "ENTER"],
"member": ["BUILD", "INTERACT", "CONTAINERS", "TP", "ENTER"],
"visitor": ["INTERACT", "ENTER"]
}
Default flags for new plots
"defaultFlags": ["ALLOW_TP", "GREETINGS"]
Crafting recipes
Recipes for plot blocks and the blueprint item. Each can be disabled individually ("disabled": true) so the item is only obtainable in creative mode or via /sp admin.
"craftingRecipes": [
{
"result": "secure-plots:bronze_plot_block",
"pattern": ["CBC", "BHB", "CBC"],
"key": {
"C": "minecraft:copper_block",
"B": "minecraft:redstone_block",
"H": "minecraft:heart_of_the_sea"
}
},
{
"result": "secure-plots:plot_blueprint",
"pattern": ["SPS", "PCP", "SPS"],
"key": {
"S": "minecraft:amethyst_shard",
"P": "minecraft:paper",
"C": "minecraft:compass"
}
}
]
Client visual config — secure_plots_client.json
This file lives on the server and is automatically synced to every client on join. Edit it server-side — changes propagate instantly on the next /sp admin reload.
Plot border — thickness
| Field |
Default |
Description |
edgeThickness |
0.06 |
Core edge line width |
glowThickness |
0.13 |
Outer glow halo width |
scanlineThickness |
0.025 |
Vertical scanline width |
scanlineSpacing |
1.5 |
Blocks between scanlines |
borderHeight |
25.0 |
Height of the border wall in blocks |
Plot border — animation
| Field |
Default |
Description |
pulseCycleMs |
2000 |
Duration of one brightness pulse cycle (ms) |
pulseMin |
0.6 |
Minimum brightness (0.0–1.0) |
pulseRange |
0.4 |
Brightness variation range (pulseMin + pulseRange ≤ 1.0) |
boltFlickerMs |
120 |
How often corner lightning bolts regenerate (ms) |
Plot border — tier colors
Each tier has 9 color channels (values 0.0–1.0):
"tierColors": [
{
"tier": 0,
"coreR": 1.0, "coreG": 0.55, "coreB": 0.05,
"glowR": 0.7, "glowG": 0.28, "glowB": 0.0,
"whiteR": 1.0, "whiteG": 0.88, "whiteB": 0.55
}
]
| Channel group |
Effect |
coreR/G/B |
Main edge color |
glowR/G/B |
Outer halo color |
whiteR/G/B |
Inner bright core |
Hologram
The floating info panel displayed above plot blocks.
| Field |
Default |
Description |
hologramEnabled |
true |
Show/hide the hologram |
hologramHeight |
3.0 |
Blocks above the plot block |
hologramMaxDistance |
24.0 |
Max render distance in blocks |
hologramScale |
0.025 |
Text scale |
hologramBackgroundOpacity |
0.75 |
Panel background opacity (0.0–1.0) |
hologramPaddingX |
8 |
Horizontal padding in font pixels |
hologramPaddingY |
6 |
Vertical padding in font pixels |
hologramLineSpacing |
1 |
Extra pixels between lines |
hologramFadeInMs |
400 |
Fade-in duration (ms) |
hologramFadeOutMs |
600 |
Fade-out duration before expiry (ms) |
hologramFloat |
true |
Enable floating up/down animation |
hologramFloatAmplitude |
0.1 |
Float range in blocks |
hologramFloatCycleMs |
3000 |
Duration of one float cycle (ms) |
Hologram text labels (all customizable)
| Field |
Default |
hologramDefaultName |
"PROTECTED PLOT" |
hologramLabelOwner |
"Owner: " |
hologramLabelTier |
"Tier: " |
hologramLabelSize |
"Size: " |
hologramLabelMembers |
"Members: " |
hologramLabelNext |
"Next: " |
hologramLabelMaxLevel |
"§6§l★ Max Level ★" |
Plot management screen
| Field |
Default |
Description |
screenPanelWidth |
320 |
Panel width in pixels |
screenPanelHeight |
240 |
Panel height in pixels |
screenRowSpacing |
16 |
Pixels between info rows |
screenMaxNameLength |
32 |
Maximum plot name length |
Screen panel colors (ARGB hex)
| Field |
Default |
screenColorBorderOuter |
0xFF373737 |
screenColorBackground |
0xFFC6C6C6 |
screenColorTitleBar |
0xFF555555 |
screenColorTitleBarTop |
0xFF666666 |
screenColorShadowDark |
0xFF8B8B8B |
screenColorShadowLight |
0xFFFFFFFF |
Localisation
Two languages are bundled: en_us (English) and es_es (Rioplatense Spanish). All 260+ translation keys cover commands, UI, tooltips, HUD messages, permission names, and every player-facing string.
To add another language, create assets/secure-plots/lang/<locale>.json in a resource pack using the existing files as a template.
Server admin quick reference
| Task |
Command |
| Grant admin override |
/tag <player> add plot_admin |
| Assign a rank |
/sp admin setrank <player> <tag> or /tag <player> add <tag> |
| Remove a rank |
/sp admin removerank <player> <tag> |
| See all server plots |
/sp admin listall |
| Find plots by player |
/sp admin search <player> |
| Find nearby plots |
/sp admin nearby 10 or /sp admin nearby 10 100 64 -200 |
| Delete a player's plots |
/sp admin delete <player> all |
| Transfer plot ownership |
Stand in the plot, /sp admin setowner <newowner> |
| Reload config in-game |
/sp admin reload |
| Give Creative plot block |
Stand in plot menu → Creative tab (OPs only) |
Support
If Secure Plots is useful for your server, consider supporting development:
License
GPL-3.0 — Copyright (C) 2025 TupacGodoy
评论 0
登录后参与评分
还没有评论,来抢沙发吧