Secure Plots

模组

· 作者 TupacGodoy

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

0 本站下载 0 关注 更新于 7 个月前

最新 1.0.4 · 1.21.1 · Fabric

一键开服(送7天)

Secure Plots

? Secure Plots

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


依赖项

  • 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(视觉设置)。

工作原理

放置一个 地块方块 以认领该区域。方块的等级决定了受保护区域的大小。右键点击该方块或使用 地块蓝图 物品打开管理菜单。

地块等级(均可配置)

等级 名称 默认半径
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> 分配。

工作原理

  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 环境粒子生成的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 对你的服务器有所帮助,请考虑支持开发:

方式 链接
☕ Ko-fi
? Mercado Pago link.mercadopago.com.ar/zhilius
?️ PayPal

许可证

GPL-3.0 — 版权所有 (C) 2025 TupacGodoy

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源