WorldGuard Extra Flags - 扩展插件

WorldGuard ExtraFlags 是 WorldGuard 的扩展插件，它新增了 26 项强大的区域标记（Flag），让你能更精细地控制玩家在领地内的行为，从移动速度、聊天格式到特殊游戏机制，应有尽有。

💡新增标记列表

以下是本插件添加的所有新标记及其简要说明。

传送与位置

• teleport-on-entry & teleport-on-exit：当玩家进入/离开区域时，将其传送至指定位置。
• join-location：当玩家在区域内登录时，将其传送至指定位置。
• respawn-location：设置在区域内死亡后的重生点。

命令执行

• command-on-entry & command-on-exit：当玩家进入/离开区域时，执行一条命令（使用 %username% 作为玩家名占位符）。
• console-command-on-entry & console-command-on-exit：当玩家进入/离开区域时，以控制台身份执行一条命令（使用 %username% 作为玩家名占位符）。

玩家状态与能力

• walk-speed & fly-speed：设置在区域内的行走和飞行速度。
• fly：控制进入区域时飞行能力是否启用或禁用。
• glide：控制区域内是否允许使用鞘翅飞行，也可用于在不穿戴鞘翅时给予滑翔效果。
• godmode：玩家在区域内是否无敌（不受伤害）。
• keep-inventory：玩家在区域内死亡是否保留物品栏。
• keep-exp：玩家在区域内死亡是否保留经验值。
• give-effects：在区域内给予玩家状态效果，并在离开时恢复原有的效果及剩余时间。
• blocked-effects：禁止区域内的状态效果。

聊天与交互

• chat-prefix & chat-suffix：设置在区域内聊天时显示的前缀和后缀。

世界与方块交互

• worldedit：区域内是否允许使用 WorldEdit。
• frostwalker：区域内是否允许冰霜行者附魔生效。
• nether-portals：区域内是否允许创建下界传送门。
• chunk-unload：区域内是否允许区块卸载。
• item-durability：区域内物品是否消耗耐久度。

声音与效果

• play-sounds：允许播放声音（单次或循环）。在 1.9 及以上版本的服务器中，声音会在玩家离开区域时停止。

❓如何使用

所有标记都通过标准的 WorldGuard 区域标记命令进行设置，使用方法与其他原生标记完全相同。

🎮版本兼容性

为确保插件正常工作，你需要搭配兼容的 Minecraft、WorldGuard 和 WorldGuard ExtraFlags 版本。

最新支持版本

• Minecraft: 1.20.6
• WorldGuard: 7.0.10
• WorldGuard ExtraFlags: 4.2.4+ (最新版，提供支持)

历史版本（已过时）

• Minecraft 1.20 - 1.20.4 | WorldGuard 7.0.9 | ExtraFlags 4.2.3 (有限支持)
• Minecraft 1.19 | WorldGuard 7.0.8 | ExtraFlags 4.2.3 (有限支持)
• Minecraft 1.17 - 1.18 | WorldGuard 7.0.7 | ExtraFlags 4.2.3 (有限支持)
• Minecraft 1.16 | WorldGuard 7.0.5 | ExtraFlags 4.1.5 (无支持)
• Minecraft 1.14 - 1.15 | WorldGuard 7.0.3 | ExtraFlags 4.1.5 (无支持)
• Minecraft 1.13 | WorldGuard 7.0.0 | ExtraFlags 4.1.5 (无支持)
• Minecraft 1.12 | WorldGuard 6.2.2 | ExtraFlags 4.1.5 (无支持)
• Minecraft 1.7 - 1.11 | WorldGuard 6.2.0 | ExtraFlags 4.1.5 (无支持)

🔧常见问题 (FAQ)

标记绕过行为

版本 4.2.0 及以上

• 默认情况下，管理员会绕过大多数标记以便管理区域。你可以使用 WorldGuard 命令 /rg bypass 来禁用此行为。
• 你也可以通过修改 WorldGuard 配置选项 disable-bypass-by-default 来设置默认不给予管理员绕过权限。

版本 4.1.5 及更早

• /rg bypass 命令无效，绕过权限由以下权限节点决定：worldguard.region.bypass.<world>.<region>.<flag>
• 请注意：如果你是 OP，则拥有所有权限，意味着你将绕过本插件提供的所有标记。

标记不生效？

• 请确保你理解了上述“标记绕过行为”，并检查 WorldGuard 配置中 use-player-move-event 是否设置为 true。

关于使用 command-on 类标记授予权限

• 除非你想永久性地给进入/离开区域的玩家授予权限，否则绝对不要使用 command-on 类标记来授予临时权限。这涉及安全性、可靠性和性能问题。
• 推荐使用 LuckPerms 的权限上下文（Context）来管理区域内的权限。这需要安装 LuckPerms 扩展 ExtraContexts。

执行命令时能获取玩家名吗？

• 可以，使用 %username% 占位符。

能在 command-on 标记中使用多个命令吗？

• 可以，使用逗号分隔命令。

如果命令里包含逗号怎么办？

• 将整个命令用引号包裹，它将被视为一个完整的命令。例如，使用 title 命令时应这样设置：

  /rg flag region-name console-command-on-entry "title %username% title {\"text\":\"Hey!\",\"color\":\"green\"}"

在 command-on-entry/exit 中使用传送命令导致服务器崩溃？

• 不支持在此类标记中直接使用传送命令。请使用专门的 teleport-on-entry 和 teleport-on-exit 标记，它们能更安全地处理传送并防止循环传送。

关于自定义命令

• Skript 等插件定义的“自定义命令”不被认为是“真实”命令，因此可能无法工作。这类插件的开发者应提供替代的执行方式以实现兼容性。

使用 keep-inventory 标记导致物品栏重复？

• 这不是本插件的问题，是与其他插件发生了冲突。

play-sounds 标记的值是什么？

• 值取决于你的 Minecraft 服务器版本。任何在 /playsound 命令中可用的值在这里都有效。

walk-speed 标记的值是什么？

• 该标记使用与 Minecraft 相同的值，默认值为 0.2。

respawn-location 标记不工作？

• 请确保已阅读上方的故障排除部分。
• 已知某些插件会覆盖此标记设置的重生点。如果你使用 Essentials，可以在其配置文件中将 respawn-listener-priority 改为 lowest 或 low 来修复。

在 Thermos 上不工作？

• 请参考此链接了解已知问题：Thermos Issue #498

✨获取帮助

如需更多帮助，请访问 Discord 的 #wg-extra-flags 频道。

点击此处获取邀请链接。