Permistry

Paper and Spigot plugin.yml errors

paper-plugin.yml: "[api-version] ... A value is required for this field"

Server log
[DirectoryProviderSource] Error loading plugin: [api-version] of type org.bukkit.craftbukkit.util.ApiVersion: A value is required for this field

What it means

In paper-plugin.yml, api-version is required. Without it Paper refuses the plugin.

What causes it

paper-plugin.yml has no api-version.

How to fix it

Before

name: MyPlugin
version: '1.0'
main: com.example.myplugin.MyPlugin

After

name: MyPlugin
version: '1.0'
main: com.example.myplugin.MyPlugin
api-version: '26.3'

Also note that paper-plugin.yml ignores commands, depend, softdepend and libraries without a warning. Register commands in code and declare dependencies under dependencies: server:.

Check the whole file. Paste your plugin.yml or drop the plugin jar into Permistry. It finds this and about 40 other problems, and explains each one in plain words. It runs in your browser and nothing is uploaded.

Open the checker