MINECRAFT PLUGINS

Create a Minecraft Paper plugin from an idea

Plan a Paper plugin, generate and review its project files, then test it on a matching Minecraft server.

A useful plugin starts with a specific behavior, a target Minecraft version, and a test plan. MCraft AI can help organize that work in a project and propose files for review. Generated source is a starting point; a downloaded ZIP is not proof that a plugin compiles or loads.

Write a small plugin brief

Describe what triggers the feature, what players or administrators should see, and which permissions or commands it needs. Specify Java Edition, the exact Minecraft version, and Paper as the target platform. For example: “For Paper on my server version, create a /spawn command that returns players to a configured location and checks a permission before teleporting.”

A narrow first feature is easier to review than a request for an entire server network. Include how configuration should work and what should happen when the configuration is missing.

Review the source and project structure

Check the entry point, plugin metadata, declared commands and permissions, dependency versions, and configuration defaults. Look for APIs that match the chosen Paper version. If you already have source files, attach or select the relevant files so changes stay in the intended project.

Keep secrets, access tokens, and private server data out of prompts and project files. Review generated commands and event handlers before running them.

Build, install, and test

A source ZIP contains source files, not a compiled JAR. MCraft’s separate Build JAR workflow requires an enabled isolated build runner and is disabled by default. When enabled, it builds a committed revision offline; success means the build produced a valid JAR, not that Minecraft loaded the plugin. Review compiler diagnostics and the exact revision before using an artifact.

If Run Server is available, it starts a disposable session only when the isolated runtime and compatible committed server files are configured; you must explicitly accept the Minecraft EULA. Otherwise, install the JAR on a disposable Paper server matching the project version. Restart, inspect startup errors, exercise each command and permission, and test missing or malformed configuration. Paper’s official development and plugin installation guides cover platform steps.

Platform documentation

Open MCraft AI to plan your project