Minecraft自定义服务端插件plugin.yml出现Aliases Error报错如何解决？

修复方案 #

1. Aliases报错处理 #

Aliases Error: mapping values are not allowed here 属于YAML语法解析错误，绝大多数场景是格式不符合规范触发，你可以按以下规则核对plugin.yml的commands配置块：

• 所有子配置项的缩进必须比父级多2个空格，禁止使用Tab缩进
• 每个配置键（如aliases、description、permission）后的冒号必须紧跟一个空格，再写对应值
• aliases配置需严格遵循列表格式，参考正确写法：

commands:
  testcmd:
    description: 测试命令
    usage: /testcmd
    # 单行多别名写法
    aliases: [tc, tcmd]
    # 分行多别名写法
    # aliases:
    #   - tc
    #   - tcmd

如果已经删除aliases配置仍报错，说明其他配置行也存在相同的语法问题，逐行检查commands块的缩进和冒号格式即可。

2. 配置修改不生效处理 #

该问题和Eclipse默认调用Xcode打开yml文件无关联，核心原因是更新后的plugin.yml没有被正确打包到插件jar包中，按以下步骤验证即可：

• 导出插件jar包后，直接用解压工具打开jar，核对jar内的plugin.yml是否和你本地修改的版本完全一致
• 确认将最新的jar包替换到服务端的plugins目录后，完全重启服务端再测试

内容的提问来源于stack exchange，提问作者Kiwi