MatrixLight Docs

Appearance

配置参考 ​

本文档详细介绍了 EsbpmPlugin 的所有配置选项，帮助您根据服务器需求进行自定义设置。

配置文件位置 ​

EsbpmPlugin 的配置文件位于服务器目录下的 plugins/EsbpmPlugin/config.yml。插件首次启动时会自动生成此文件。

完整配置示例 ​

以下是 config.yml 文件的完整示例，包含所有可用配置项及其默认值：

yaml
# EsbpmPlugin 配置文件

# 速度效果设置
speed-effect:
  # 是否启用速度效果
  enabled: true
  # 速度等级 (1-5)
  level: 2

# 飞行设置
flight:
  # 是否允许在生存模式下飞行
  allow-in-survival: true

# 游戏模式设置
gamemode:
  # 强制非管理员玩家的游戏模式 (0=生存, 1=创造, 2=冒险, 3=旁观)
  forced-mode: 2
  # 是否启用强制游戏模式功能
  enabled: true

配置项详解 ​

速度效果配置 (speed-effect) ​

速度效果配置部分控制插件为玩家提供的自动速度加成功能。

speed-effect.enabled ​

  • 类型：布尔值（true/false）
  • 默认值：true
  • 描述：控制是否为所有玩家自动应用速度效果
  • 取值说明：
    • true：启用速度效果，所有玩家加入服务器时会自动获得配置的速度加成
    • false：禁用速度效果，玩家不会获得任何自动速度加成

speed-effect.level ​

  • 类型：整数
  • 默认值：2
  • 取值范围：1 到 5
  • 描述：设置速度效果的等级，决定速度加成的强度
  • 效果说明：
    • 1：轻微速度提升（约1.2倍默认速度）
    • 2：中等速度提升（约1.4倍默认速度）
    • 3：明显速度提升（约1.6倍默认速度）
    • 4：高速度提升（约1.8倍默认速度）
    • 5：最高速度提升（约2.0倍默认速度）

飞行设置配置 (flight) ​

飞行设置配置部分控制玩家在游戏中的飞行权限。

flight.allow-in-survival ​

  • 类型：布尔值（true/false）
  • 默认值：true
  • 描述：控制是否允许玩家在生存模式下使用 /fly 命令
  • 取值说明：
    • true：允许玩家在生存模式下使用 /fly 命令切换飞行状态
    • false：禁止玩家在生存模式下使用 /fly 命令，即使拥有相应权限

游戏模式设置配置 (gamemode) ​

游戏模式设置配置部分控制是否强制非管理员玩家使用特定的游戏模式。

gamemode.forced-mode ​

  • 类型：整数
  • 默认值：2
  • 取值范围：0 到 3
  • 描述：设置要强制非管理员玩家使用的游戏模式
  • 模式说明：
    • 0：生存模式（Survival）- 玩家需要收集资源，有生命值和饥饿值，受到伤害
    • 1：创造模式（Creative）- 无限资源，飞行能力，瞬间破坏方块
    • 2：冒险模式（Adventure）- 无法破坏方块（除非使用特定工具），无法放置方块
    • 3：旁观模式（Spectator）- 穿墙飞行，无法与世界交互，可观察其他玩家

gamemode.enabled ​

  • 类型：布尔值（true/false）
  • 默认值：true
  • 描述：控制是否启用强制游戏模式功能
  • 取值说明：
    • true：启用强制游戏模式，非管理员玩家将被自动设置为 forced-mode 指定的游戏模式
    • false：禁用强制游戏模式，玩家可以自由切换游戏模式（受服务器权限限制）

配置修改方法 ​

要修改 EsbpmPlugin 的配置，请按照以下步骤操作：

  1. 停止服务器（推荐但非必须）：

    • 虽然有些插件支持热重载配置，但为了确保配置正确应用，建议在修改配置前停止服务器

  2. 编辑配置文件：

    • 使用文本编辑器（如 Notepad++、VS Code 等）打开 plugins/EsbpmPlugin/config.yml 文件
    • 根据需要修改相应的配置项
    • 确保 YAML 格式正确，特别是缩进和语法

  3. 保存更改：

    • 保存对配置文件的修改

  4. 应用配置：

    • 如果服务器已停止，启动服务器以加载新配置
    • 如果服务器正在运行，可以使用 /reload 命令（不推荐，可能导致问题）或使用插件管理插件（如 PlugMan）重载 EsbpmPlugin

配置最佳实践 ​

  1. 配置前备份：

    • 在修改配置前，建议先备份原始配置文件，以便出现问题时可以恢复

  2. 遵循 YAML 语法：

    • 确保配置文件遵循正确的 YAML 语法，特别是缩进（使用空格而非制表符）和键值对格式
    • 布尔值应为小写的 true 或 false
    • 字符串值一般不需要引号，除非包含特殊字符

  3. 逐步调整：

    • 建议一次只修改少量配置项，并测试修改效果
    • 避免一次性修改大量配置，这会使问题排查变得困难

  4. 根据服务器类型调整：

    • 参考场景配置指南中的建议，根据您的服务器类型进行优化配置
    • 例如，冒险服务器和创造服务器的最佳配置会有明显差异

  5. 记录更改：

    • 考虑记录对配置的更改，包括更改时间、更改内容和更改原因
    • 这有助于追踪问题和理解配置演变过程

常见配置问题 ​

配置文件未生成 ​

  • 问题：启动服务器后，plugins/EsbpmPlugin 目录或 config.yml 文件未生成
  • 解决方法：
    1. 检查插件文件是否正确放置在 plugins 文件夹中
    2. 检查服务器日志是否有与 EsbpmPlugin 相关的错误信息
    3. 确保使用的是兼容的 Minecraft 版本（1.21）
    4. 尝试删除插件文件并重新下载安装

配置修改后不生效 ​

  • 问题：修改配置文件后，游戏中的设置没有变化
  • 解决方法：
    1. 确保正确保存了配置文件的更改
    2. 尝试重启服务器以完全加载新配置
    3. 检查配置文件语法是否正确，YAML 格式错误可能导致配置被忽略
    4. 确认修改的是正确的配置文件（路径：plugins/EsbpmPlugin/config.yml）

速度效果配置问题 ​

  • 问题：速度效果未应用或效果强度不符合预期
  • 解决方法：
    1. 确认 speed-effect.enabled 设置为 true
    2. 检查 speed-effect.level 的值是否在 1-5 的范围内
    3. 尝试让玩家重新加入服务器以重新应用效果
    4. 检查是否有其他插件可能影响速度效果

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