安全地块

安全地块

带菜单、角色、升级、基于等级的权限、环境效果和完全可配置的视觉边界系统的领地保护模组。

游戏机制

Secure Plots

🛡 Secure Plots

Minecraft 1.21.1 — Fabric 领地保护模组,包含菜单、角色、升级、基于等级的权限、环境效果以及完全可配置的视觉边界系统。

ko-fi


要求

  • Minecraft 1.21.1
  • Fabric Loader ≥ 0.15.0
  • Fabric API
  • Java 21+

安装

  1. 将 .jar 放入服务器和客户端的 mods/ 文件夹。
  2. 启动服务器一次,在 config/ 中生成配置文件。
  3. 编辑 secure_plots.json(服务器行为)和 secure_plots_client.json(视觉设置)。

工作原理

放置一个 Plot Block 来占领该区域。方块等级决定了受保护区域的大小。右键点击该方块或使用 Plot Blueprint 物品打开管理菜单。

地块等级(均可配置)

等级 名称 默认半径
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 关闭 任何人都可以放置和破坏方块
ALLOW_VISITOR_INTERACT 关闭 任何人都可以使用门、拉杆、按钮
ALLOW_VISITOR_CONTAINERS 关闭 任何人都可以打开箱子
ALLOW_PVP 关闭 为所有玩家启用 PvP
ALLOW_FLY 关闭 所有人都可以飞行
ALLOW_TP 开启 任何人都可以 /sp tp 到此地块
GREETINGS 开启 显示进入/离开标题消息

单独权限(/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> 分配。

工作原理

  1. 在 secure_plots.json 中的 rankPerks 下定义等级。
  2. 使用 /tag <player> add <tag> 或快捷方式 /sp admin setrank <player> <tag> 为玩家分配标签。
  3. 没有等级标签的玩家使用全局默认值。
  4. 如果玩家有多个等级标签,每个字段的最宽松值生效。
  5. 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 环境粒子生成之间的刻数
checkInterval 10 进入/离开检测检查之间的刻数
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+ 个翻译键涵盖命令、UI、工具提示、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
给予创造模式地块方块 站在地块菜单中 → Creative 选项卡(仅限 OP)

支持

如果 Secure Plots 对你的服务器有用,请考虑支持开发:

方式 链接
☕ Ko-fi ko-fi.com/zhilius
💙 Mercado Pago link.mercadopago.com.ar/zhilius
🅿️ PayPal paypal.com/ncp/payment/TWGPKWLKEJNCG

许可证

GPL-3.0 — Copyright (C) 2025 TupacGodoy