Create a plugin

Mint CLI is retired. Plugin development is now managed through Plugin Studio, which creates local projects, opens them in an editor, uploads source, and shows build progress.

Install Plugin Studio

1. Sign in at the OriginMint panel.
2. Open Downloads and choose the Plugin Studio build for your operating system.
3. Start Plugin Studio and sign in when prompted.

Create a project

1. Open Plugins and select New Plugin.
2. Choose a name and the Minecraft family the plugin targets.
3. Create the project, then use Open Folder or Open in VS Code.
4. Edit the generated Java entry point. The entry-point class must implement IPlugin and provide onEnable() and onDisable().
5. Return to Plugin Studio. Use Refresh Plugins if the local or server metadata is stale.
6. Select Upload/Publish. Keep Plugin Studio open while it packages the project, uploads it, and waits for the server build.

Plugins for 1.8.9 compile with Java 8, 1.18.2 and 1.20.4 with Java 17, the 1.21 family with Java 21, and 26.2 with Java 25. Create a separate plugin project when targeting another Minecraft family.

Caution

A successful upload publishes a new version. If an admin previously verified the plugin, changing its source clears that verified badge until the new code is reviewed.

Visibility

• Public lists the plugin in the marketplace.
• Unlisted hides it from marketplace discovery; people who already know the ID may still access non-private source.
• Private restricts source and template downloads to the owner.
• Runtime access is separate: only the owner and invited users who accepted can load the compiled plugin.

Public and private can both be enabled. That creates a marketplace listing whose source remains owner-only.

Use a marketplace template

Open Marketplace, select Use Template, and let Plugin Studio create a local copy. The copy receives its own plugin identity when published. Use Update Plugin only when you intentionally want to replace one of your existing plugin’s source with the template while keeping that plugin’s name and visibility.

Danger

Plugins execute code on your computer. Read and understand template code before compiling or running it.

Build failures

Plugin Studio displays the server build result. For a failed build, check the first compiler error, confirm the entry-point package and class name, and verify that APIs or libraries match the selected Minecraft version. Fix the local source and publish again; do not manually increment a version number.