权限节点
文档/easier-building/权限节点

权限节点

全部权限节点的说明、默认值与常见配置陷阱。

权限总览

EasierBuilding 的权限以 easierbuilding. 为前缀,按功能分组:基础使用、材料背包、模式、修改器、替换策略、结构操作、拆除与豁免。以下为全部权限节点及其默认值。

基础权限

权限默认说明
easierbuilding.use全员使用插件(打开 /eb 菜单)
easierbuilding.adminOP管理权限(/eb debug/eb cancel、GUI 管理入口)
easierbuilding.reloadOP执行 /eb reload
easierbuilding.admin.reloadOP执行 /eb reload(备用节点)
easierbuilding.material-backpack全员使用专业版材料背包;还需要安装专业版并在个人设置中启用

模式权限

权限默认对应模式
easierbuilding.mode.normal全员普通编辑
easierbuilding.mode.line全员直线
easierbuilding.mode.wall全员墙面
easierbuilding.mode.cube全员立方体
easierbuilding.mode.diagonal_line全员斜线
easierbuilding.mode.diagonal_wall全员斜墙
easierbuilding.mode.slope全员斜坡
easierbuilding.mode.ellipse全员椭圆
easierbuilding.mode.cylinder全员圆柱
easierbuilding.mode.sphere全员球体
easierbuilding.mode.dome全员半球

高级模式的权限默认全员可用,但功能本身需要专业版解锁;未安装专业版时,即使有权限也显示「未解锁」。

修改器权限

权限默认对应修改器
easierbuilding.modifier.mirror全员镜像
easierbuilding.modifier.array全员线性阵列(声明节点)
easierbuilding.modifier.radial_mirror全员旋转镜像(别名 radial-mirror 兼容)

配置陷阱:代码实际检查线性阵列的权限节点为 easierbuilding.modifier.linear-array(兼容 linear_array),但 plugin.yml 默认声明的只有 easierbuilding.modifier.array默认配置下,线性阵列在菜单中会显示「权限不足」,需要管理员额外授予 easierbuilding.modifier.linear-array 权限才能使用。

替换策略权限

权限默认对应策略
easierbuilding.replace.air-only全员仅空气(免费)
easierbuilding.replace.blocks-and-air关闭空气与方块(专业版)
easierbuilding.replace.blocks-only关闭仅方块(专业版)
easierbuilding.replace.offhand-filter关闭副手匹配(专业版)
easierbuilding.replace.whitelist关闭白名单(专业版)
easierbuilding.replace.quick关闭快捷替换(专业版)

专业版替换策略的权限默认关闭,授予权限后才可选用对应策略(仍需专业版解锁功能本身)。

结构操作权限

权限默认对应操作
easierbuilding.structure.move全员移动结构
easierbuilding.structure.copy全员复制结构到剪贴板
easierbuilding.structure.paste全员从剪贴板粘贴结构

三个节点分别控制移动、复制和粘贴;权限只控制能否使用,结构操作本身仍需要专业版解锁。可以只授予某一项,例如只允许建筑团队复制结构而不允许粘贴。

拆除与豁免权限

权限默认说明
easierbuilding.break全员允许批量拆除(无此权限时拆除被跳过)
easierbuilding.break.drops关闭批量拆除是否掉落物品(还需配置 breaking.drop-items: true
easierbuilding.bypass.survival-costOP绕过生存消耗(放置不消耗材料)

推荐的最小配置

普通生存服(保留默认即可):

easierbuilding.use: true
easierbuilding.break: true
easierbuilding.break.drops: false

建筑团队 / 活动测试(授予豁免与高级策略):

# 让指定玩家或组免材料消耗
easierbuilding.bypass.survival-cost: true
# 解锁专业版替换策略
easierbuilding.replace.blocks-and-air: true
easierbuilding.replace.whitelist: true
# 解锁线性阵列(修复默认未声明的节点)
easierbuilding.modifier.linear-array: true

严格模式(只允许基础模式,不允许拆除掉落):

easierbuilding.mode.diagonal_line: false
easierbuilding.mode.diagonal_wall: false
easierbuilding.mode.slope: false
easierbuilding.mode.ellipse: false
easierbuilding.mode.cylinder: false
easierbuilding.mode.sphere: false
easierbuilding.mode.dome: false
easierbuilding.modifier.mirror: false
easierbuilding.modifier.linear-array: false
easierbuilding.modifier.radial_mirror: false
easierbuilding.break.drops: false

常见问题

授予了权限但功能还是「未解锁」?

权限控制「能不能用」,专业版控制「有没有这个功能」。未安装专业版时,高级模式 / 修改器 / 替换策略 / 随机材料袋显示「未解锁」是正常现象,与权限无关。

为什么玩家有 modifier.array 权限,线性阵列还是提示权限不足?

因为代码检查的是 easierbuilding.modifier.linear-array 节点(见上文陷阱)。授予该节点即可。

OP 还需要额外权限吗?

OP 默认拥有 easierbuilding.admineasierbuilding.bypass.survival-cost;各模式的 mode.*break 默认全员,OP 自然可用。但 OP 不等于拥有所有权限,测试玩家行为请使用普通账号。