plugin.yml 无效
服务器不认为该文件是插件:下载损坏、文件类型错误、模组而非插件,以及压缩包套压缩包。
更新于 2026年8月13日
org.bukkit.plugin.InvalidDescriptionException: Invalid plugin.yml
服务器打开了 .jar,但里面没有找到有效的插件描述文件。
原因
- 文件没有下载完整。 这是最常见的原因。请重新上传——服务器文件。
- 这是模组,不是插件。 Forge 和 Fabric 模组不能放在
plugins中——客户端与服务端模组。 - 这是库文件或源代码, 而不是编译好的插件。
- 文件是从 zip 重命名而来的。 包含一组插件的压缩包并不是插件:请解压后上传其中的内容。
- 插件是为其他平台构建的: 例如把 Velocity 插件放进了 Paper 服务器的
plugins文件夹。
如何检查
用压缩软件打开 .jar:其根目录下应包含 plugin.yml。如果您看到的是 fabric.mod.json 或 META-INF/mods.toml,那它就是模组,应放入 mods。
文件大小
将服务器上的文件大小与下载页面上的大小进行对比。两者不一致说明传输被中断了。
相关错误:插件无法加载。
Minecraft 托管您离线时服务器仍在运行创建服务器
