WorldLimit 用户文档
插件介绍
WorldLimit 是一个强大的世界访问控制插件，它通过各种条件的组合来限制玩家进入特定世界。该插件采用模块化设计，支持多个版本，并提供丰富的自定义选项。

功能亮点

• 多版本支持 （1.8 - 1.20+）
• 异步处理机制
• 多语言支持（en_US、zh_CN、ja_JP）
• 变量解析引擎（支持 PlaceholderAPI）
• 丰富的条件类型
• 性能监控系统
• 自动异常处理

依赖

• 必填
  • 水龙头/纸张 1.8+
• 自选
  • PlaceholderAPI（推荐，用于变量支持）

安装步骤

1. 下载插件 jar 文件。
2. 将其放在 server.plugins 的文件夹中
3. 重新启动服务器。
4. 配置文件将自动生成。

权限节点
worldlimit.admin 中：
description：允许使用所有 WorldLimit 命令
默认值：op

worldlimit.debug 中：
description：允许使用 debug 命令
默认值：op

worldlimit.bypass 中：
描述：允许绕过世界访问限制
默认值：op
指挥系统
基本命令

• /wl reload - 重新加载配置。
• /wl add <world_name> <type> [parameters] - 添加世界访问条件。
• /wl remove <world_name> <sequence_number> - 删除指定的条件。
• /wl list [world_name] - 查看世界条件列表。
• /wl info <world_name> - 查看有关世界的详细信息。
• /wl lang <list|set|default> - 语言设置。
• /wl debug <option> - 调试工具。

条件类型的命令示例
/wl DIAMOND_SWORD 1 添加world_nether道具 “§6下界剑”
/wl add world_nether 权限 worldlimit.world.nether
/wl add world_nether变量 %player_level% >= 10
/wl 添加 world_nether 冷却时间 300

= 10 /wl 添加world_nether冷却时间 300“ tabindex=”0“ role=”button“ style=”box-sizing： border-box;位置：相对;字体大小：14px;字体粗细： var（--base-text-weight-medium， 500）;行高：20px;文本换行模式：无换行;垂直对齐：中间;cursor： 指针;user-select：无;边框：0px;边框半径：6px;外观：无;颜色： var（--fgColor-accent， var（--color-accent-fg））;background-color：透明;box-shadow：无;过渡：颜色 80ms 立方贝塞尔（0.33， 1， 0.68， 1）， 背景色， 框阴影， 边框色;宽度： var（--control-small-size， 28px）;高度： var（--control-small-size， 28px）;显示： flex ！important;填充： 0px ！important;对齐内容： center ！important;对齐项目： 居中 ！important;边距： var（--base-size-8， 8px） ！important;”>
配置文件
config.yml
# 插件语言设置（支持：en_US、zh_CN、ja_JP）
语言： zh_CN

# 调试模式
调试：False

# 版本适配器设置
版本：
show_info：true
force_enable： false

# 缓存设置
缓存：
variable_duration：1000
variable_enabled：true
world_rules.yml
worlds:
world_nether:
enabled: true
message:
deny: "&cYou cannot enter this world!"
cooldown: "&eYou need to wait {time} seconds before you can enter again!"
conditions:
- type: item
item: "DIAMOND_SWORD:0"
amount: 1
name: "§6Nether Sword"
lore:
- "§7This sword allows you to"
- "§7enter the Nether"
message: "&cYou need a Nether Sword to enter!"

- type: permission
permission: "worldlimit.world.nether"
message: "&cYou do not have permission to enter this world!"

- type: variable
variable: "%player_level%"
operator: ">="
value: 10
message: "&cYou need to reach level 10 to enter!"

- type: cooldown
time: 300
permission_bypass: "worldlimit.bypass.cooldown"
message: "&eYou need to wait {time} seconds before you can enter again!"
=" value: 10 message: "&cYou need to reach level 10 to enter!" - type: cooldown time: 300 permission_bypass: "worldlimit.bypass.cooldown" message: "&eYou need to wait {time} seconds before you can enter again!"" tabindex="0" role="button" style="box-sizing: border-box; position: relative; font-size: 14px; font-weight: var(--base-text-weight-medium, 500); line-height: 20px; text-wrap-mode: nowrap; vertical-align: middle; cursor: pointer; user-select: none; border: 0px; border-radius: 6px; appearance: none; color: var(--fgColor-accent, var(--color-accent-fg)); background-color: transparent; box-shadow: none; transition: color 80ms cubic-bezier(0.33, 1, 0.68, 1), background-color, box-shadow, border-color; width: var(--control-small-size, 28px); height: var(--control-small-size, 28px); display: flex !important; padding: 0px !important; justify-content: center !important; align-items: center !important; margin: var(--base-size-8, 8px) !important;">
Explanation of Condition Types
1. Item Check (item)
Checks if the player holds a specific item.

type: item
item: "item_ID:data_value"
amount: quantity
name: "item_name" (optional)
lore: [description_line_1, description_line_2] (optional)
message: "failure_prompt"
2. Permission Check (permission)
Checks if the player has a specific permission.

type: permission
permission: "permission_node"
message: "failure_prompt"
3. Variable Check (variable)
Checks if the variable value meets the condition.

type: variable
variable: "%variable_name%"
operator: "operator"
value: "target_value"
message: "failure_prompt"
Supported operators:

• == equals
• != not equals
• > greater than
• < less than
• >= greater than or equal to
• <= less than or equal to
• range range check

4. Cooldown Check (cooldown)
Sets the cooldown time for entering a world.

type: cooldown
time: cooldown_time (seconds)
permission_bypass: "bypass_permission" (optional)
message: "failure_prompt"
Built - in Variables

• %player_health% - Player's current health
• %player_max_health% - Player's maximum health
• %player_food% - Player's hunger level
• %player_level% - Player's experience level
• %player_exp% - Player's experience points
• %player_world% - Player's current world
• %player_gamemode% - Player's game mode
• %player_flying% - Player's flying state

Precautions

1. Version Compatibility
   • The plugin will automatically detect the server version and use the appropriate adapter.
   • If there are version compatibility issues, it will automatically degrade to the basic mode.
2. Performance Optimization
   • Enabling variable caching can improve performance.
   • The asynchronous processing mechanism ensures that it does not affect the main thread.
3. Error Handling
   • The plugin includes an automatic error - handling mechanism.
   • It will automatically isolate problematic variables.
   • Detailed information can be viewed through the debug command.
4. Configuration Files
   • After modifying the configuration, use to reload./wl reload
   • It is recommended to back up the configuration file before modification.
5. Multilingual Support
   • Different languages can be set for each player.
   • The language files support UTF - 8 encoding.

Frequently Asked Questions

1. Q: Why can't some variables be used?
   • 答：确保已安装 PlaceholderAPI，并且变量提供程序插件运行正常。
2. 问：如何添加自定义变量？
   • A： 您可以通过 PlaceholderAPI 添加它们，也可以开发插件来实现 VariableProvider 接口。
3. Q：为什么条件检查失败时没有提示？
   • A：检查条件配置中的字段是否设置正确。消息
4. Q： 如何禁用特定世界的限制？
   • A：对于 中的相应世界，设置为 。enabledfalseworld_rules.yml

技术支持
如果您遇到问题，您可以：

1. 使用该命令收集调试信息。/wl 调试
2. 检查 Server Console 中的错误日志。
3. 确保您使用的是最新版本的插件。

更改日志
1.0.0 版

• 实现了版本隔离系统。
• 新增配置管理系统。
• 实现了变量解析引擎。
• 完成世界访问检测的核心。
• 新增 administrator 命令系统。
• 实现了异步处理管道。
• 新增异常监控层。
• 完成多语言支持。Z