MatrixLight Docs

Appearance

EsbpmPlugin 使用指南 ​

本指南提供了 EsbpmPlugin 的详细使用说明，包括配置示例和常见场景的解决方案，帮助服务器管理员更好地设置和使用插件。

配置示例 ​

以下是几个常见场景的配置示例，您可以根据自己服务器的需求进行调整。

示例 1: 新手服务器配置 ​

对于面向新手的服务器，建议提供较为宽松的游戏环境，但仍然限制危险物品以保护服务器安全。

yaml
# 新手服务器配置示例

speed-effect:
  enabled: true
  level: 1  # 较低的速度加成，适合新手适应游戏

flight:
  allow-in-survival: false  # 禁止生存模式飞行，鼓励探索和建造

gamemode:
  forced-mode: 0  # 强制使用生存模式，体验完整游戏内容
  enabled: true

示例 2: 冒险服务器配置 ​

对于冒险主题的服务器，通常会强制使用冒险模式以确保玩家按照预设路径进行游戏。

yaml
# 冒险服务器配置示例

speed-effect:
  enabled: true
  level: 2  # 适中的速度加成，提高探索效率

flight:
  allow-in-survival: false  # 禁止飞行，保持冒险的挑战性

gamemode:
  forced-mode: 2  # 强制使用冒险模式，防止破坏地形和物品
  enabled: true

示例 3: 创造服务器配置 ​

对于创造主题的服务器，通常会允许更多的自由，但仍可能需要限制某些危险物品。

yaml
# 创造服务器配置示例

speed-effect:
  enabled: true
  level: 3  # 较高的速度加成，方便快速建造

flight:
  allow-in-survival: true  # 允许飞行，提高建造效率

gamemode:
  forced-mode: 1  # 强制使用创造模式，提供完整的创造能力
  enabled: true

示例 4: 半生存半创造服务器配置 ​

对于希望同时提供生存和创造体验的服务器，可以允许管理员设置玩家的游戏模式。

yaml
# 半生存半创造服务器配置示例

speed-effect:
  enabled: true
  level: 2  # 适中的速度加成

flight:
  allow-in-survival: true  # 允许飞行

gamemode:
  forced-mode: 0  # 默认使用生存模式
  enabled: false  # 禁用强制游戏模式，允许管理员手动设置

常见场景解决方案 ​

场景 1: 如何允许特定玩家在生存模式下飞行？ ​

默认情况下，所有玩家都拥有 esbpm.fly 权限，可以使用 /fly 命令。如果您想限制只有特定玩家可以飞行，可以修改权限设置：

  1. 首先在 plugin.yml 中将 esbpm.fly 权限的默认值设置为 false：
yaml
permissions:
  esbpm.fly:
    description: 允许使用飞行命令
    default: false
  1. 然后使用权限管理插件（如 LuckPerms）为特定玩家或群组授予权限：
/lp user <玩家名> permission set esbpm.fly true

场景 2: 如何临时禁用速度效果？ ​

如果您需要临时禁用速度效果，可以直接修改配置文件：

  1. 打开 plugins/EsbpmPlugin/config.yml 文件
  2. 将 speed-effect.enabled 设置为 false：
yaml
speed-effect:
  enabled: false
  level: 2
  1. 重启服务器使更改生效

场景 3: 如何让管理员不受游戏模式限制？ ​

默认情况下，OP玩家拥有 esbpm.gamemode.bypass 权限，可以自由更改游戏模式。如果您想让非OP玩家也能绕过游戏模式限制，可以使用权限管理插件授予权限：

/lp user <玩家名> permission set esbpm.gamemode.bypass true

或者为特定群组授予权限：

/lp group <群组名> permission set esbpm.gamemode.bypass true

场景 4: 如何调整速度效果的强度？ ​

您可以通过修改配置文件中的 speed-effect.level 值来调整速度效果的强度：

yaml
speed-effect:
  enabled: true
  level: 3  # 1-5之间的整数，数值越大效果越强
  • 等级 1: 轻微的速度加成
  • 等级 2: 适中的速度加成（默认）
  • 等级 3: 明显的速度加成
  • 等级 4: 非常快的速度
  • 等级 5: 极快的速度（可能影响游戏体验）

场景 5: 如何在不重启服务器的情况下应用配置更改？ ​

当前版本的插件不支持热重载配置。如果您需要应用配置更改，必须重启服务器。如果您希望添加热重载功能，可以考虑以下方法：

  1. 联系插件开发者请求添加此功能
  2. 自行修改插件代码，添加一个重载命令，例如：
java
// 在onCommand方法中添加
if (command.getName().equalsIgnoreCase("esbpmreload")) {
    if (!sender.hasPermission("esbpm.reload")) {
        sender.sendMessage(ChatColor.RED + "您没有权限执行此命令!");
        return true;
    }
    
    reloadConfig();
    sender.sendMessage(ChatColor.GREEN + "EsbpmPlugin 配置已重载!");
    return true;
}
  1. 然后在 plugin.yml 中注册此命令和相应权限

最佳实践 ​

服务器性能优化 ​

  • 如果您的服务器玩家数量较多，可以考虑降低速度效果的等级或在玩家数量特别多时暂时禁用速度效果
  • 定期检查被禁止物品列表，确保没有遗漏任何可能破坏服务器的物品
  • 考虑为不同类型的玩家设置不同的权限组，以便更精细地控制权限

玩家体验优化 ​

  • 根据服务器类型选择合适的默认配置
  • 在玩家加入服务器时提供清晰的指引，告知他们可用的命令和限制
  • 考虑添加反馈机制，让玩家可以报告问题或提出建议
  • 定期更新插件，确保与最新的 Minecraft 版本兼容

安全注意事项 ​

  • 不要将 esbpm.gamemode.bypass 权限授予不可信的玩家
  • 定期备份服务器数据，以防万一
  • 考虑与其他安全插件配合使用，提供更全面的服务器保护

故障排除 ​

问题 1: 命令不生效 ​

可能原因：

  • 玩家没有相应的权限
  • 命令拼写错误
  • 插件未正确加载

解决方案：

  • 检查玩家的权限设置
  • 确保命令拼写正确（/fly）
  • 检查服务器日志，确认插件是否成功加载

问题 2: 配置更改未生效 ​

可能原因：

  • 配置文件修改后未重启服务器
  • 配置文件格式错误
  • 配置项名称拼写错误

解决方案：

  • 重启服务器
  • 检查配置文件格式，确保YAML格式正确
  • 核对配置项名称是否与本文档一致

问题 3: 速度效果未应用 ​

可能原因：

  • 配置中禁用了速度效果
  • 玩家切换世界后效果未重新应用

解决方案：

  • 检查配置文件中的 speed-effect.enabled 设置
  • 尝试让玩家重新加入服务器或切换世界

问题 4: 玩家仍然可以使用被禁止的物品 ​

可能原因：

  • 物品名称在代码中未正确添加
  • 玩家通过其他方式使用了被禁止的物品

解决方案：

  • 检查插件代码中的 initializeBannedItems() 方法，确保包含了所有需要禁止的物品
  • 考虑添加额外的事件监听器，阻止玩家通过其他方式使用被禁止的物品

常见问题 ​

Q: 插件支持哪些 Minecraft 版本？ A: 插件当前支持 Minecraft 1.21 版本，基于 Paper API 1.21.1-R0.1-SNAPSHOT 开发。

Q: 插件是否与其他插件兼容？ A: 插件应该与大多数其他插件兼容，但可能与某些修改相同游戏机制的插件存在冲突。如果遇到兼容性问题，建议暂时禁用其他可能冲突的插件，然后逐一启用以确定冲突来源。

Q: 如何查看插件的加载状态？ A: 可以在服务器启动日志中查找 "EsbpmPlugin 已启用!" 的消息，确认插件是否成功加载。

Q: 插件是否会影响服务器性能？ A: 插件设计时考虑了性能因素，正常情况下不会对服务器性能造成明显影响。但在玩家数量特别多的服务器上，可能需要调整配置以优化性能。

Copyright © 2025-Shanghai MatrixLight Technology Co., Ltd. All rights reserved.