Skip to content
托管 · 错误解析

plugin.yml 无效

服务器不认为该文件是插件:下载损坏、文件类型错误、模组而非插件,以及压缩包套压缩包。

更新于 2026年8月13日

org.bukkit.plugin.InvalidDescriptionException: Invalid plugin.yml

服务器打开了 .jar,但里面没有找到有效的插件描述文件。

原因

  1. 文件没有下载完整。 这是最常见的原因。请重新上传——服务器文件。
  2. 这是模组,不是插件。 Forge 和 Fabric 模组不能放在 plugins 中——客户端与服务端模组。
  3. 这是库文件或源代码, 而不是编译好的插件。
  4. 文件是从 zip 重命名而来的。 包含一组插件的压缩包并不是插件:请解压后上传其中的内容。
  5. 插件是为其他平台构建的: 例如把 Velocity 插件放进了 Paper 服务器的 plugins 文件夹。

如何检查

用压缩软件打开 .jar:其根目录下应包含 plugin.yml。如果您看到的是 fabric.mod.json 或 META-INF/mods.toml,那它就是模组,应放入 mods。

文件大小

将服务器上的文件大小与下载页面上的大小进行对比。两者不一致说明传输被中断了。

相关错误:插件无法加载。

Minecraft 托管您离线时服务器仍在运行创建服务器