StackNest Documentation

Everything you need to know to get the most out of AI-powered plugin generation — no prior coding experience required.

What is StackNest?

StackNest is an AI tool that writes Minecraft server plugins for you. You describe what you want in plain English — like "a plugin that bans players who swear in chat" — and StackNest generates the complete Java code and configuration file.

There's no need to know Java or any programming language. The output is a ready-to-deploy plugin that you can install directly on your Minecraft server.

Your first plugin

1. Create a free account Go to /app and sign up with your email. Verify your email — you'll get a confirmation link.
2. Describe your plugin Type what you want in the prompt box. Be specific — the more detail you give, the better the result. See Writing better prompts.
3. Wait for generation Click Generate. The AI writes your plugin, validates it, and usually corrects any issues automatically. This takes 15–60 seconds on average.
4. Download your JAR Once generated, click Download JAR. Drop the .jar file into your server's plugins/ folder and restart.

Writing better prompts

The quality of your plugin depends heavily on how clearly you describe it. Here are the key things to include:

• What triggers the plugin — a command, an event (player joins, breaks a block, dies), a timer
• What it does — the specific action or behaviour
• Who it affects — all players, specific permissions, ops only
• Any configuration — messages, cooldowns, limits

Prompt examples

Platform overview

Minecraft server software comes in many flavours. Choosing the right one affects what features your plugin can use.

Which platform should I choose?

How generation works

When you hit Generate, StackNest goes through several steps automatically:

1. Your prompt is sent to the AI — it writes Java code and a plugin.yml file based on what you described.
2. The code is validated — the plugin is compiled (like a real build process) and any errors are shown.
3. Automatic fixing — if the code has issues, StackNest tries up to 3 times to fix them automatically before returning the result to you.
4. You get the output — the code, any warnings, and a download button for the compiled JAR.

Validation & errors

StackNest validates your plugin in two ways:

• Java compilation — checks that the code is valid Java and compiles without errors.
• plugin.yml check — checks that the configuration file has all required fields (name, version, main class).

If warnings are shown after generation, they're usually minor (like an unused import). Your plugin will still work. Errors shown in red mean compilation failed — try regenerating with a more specific prompt, or describe what went wrong.

Downloading your JAR

After a successful generation, click Download JAR. You'll get a .jar file ready to install:

1. Stop your server (or let it run — hot-loading is possible but not recommended).
2. Drop the .jar into your server's /plugins folder.
3. Start (or restart) the server.
4. The plugin loads automatically. Check your console for any startup errors.

Gallery

The Gallery is a community library of plugins that users have uploaded for others to use freely.

• Browsing — anyone can browse and download plugins from the gallery, no account needed.
• Uploading — you need a verified account. Upload a .jar or .zip containing your plugin (it must have a valid plugin.yml inside).
• Tagging — tag your upload with the platforms it supports (Paper, Spigot, etc.) so others can filter by platform.

Free vs Pro

See the pricing page for full details and to upgrade.

Common issues

My plugin generated but doesn't work on the server

Check your server console for error messages when the plugin loads. Common causes:

• Wrong server version — make sure your prompt mentioned the Minecraft version (e.g. "Paper 1.21").
• Missing dependency — if the plugin requires another plugin (like Vault or LuckPerms), make sure it's installed first.
• Folia compatibility — if you're on Folia, regenerate with "make this Folia-compatible" in your prompt.

Generation is taking a long time

Complex plugins can take up to 90 seconds. If the page shows a spinner, it's still working — don't reload. If it times out, try again with a slightly simpler prompt and build up from there.

I get a compilation error in the output

This happens occasionally with very complex or unusual requests. Try:

• Regenerating with the same prompt (the AI might get it right on the next attempt).
• Simplifying your prompt slightly, then adding complexity in a follow-up generation.
• Being more specific about the Minecraft version and API you're targeting.

The plugin has "StackNest" as the author — can I change it?

On the free plan, authors: [StackNest] is added to your plugin.yml automatically. You can edit the file manually to change it, or upgrade to Pro to remove this entirely.

I've hit my monthly limit

Free accounts get 3 plugin generations per month. The counter resets on the 1st of each month. To generate more, upgrade to Pro for unlimited generations.

Service availability

StackNest uses cloud AI services to generate plugins. Occasionally these services may be slower or temporarily unavailable due to high demand.

Pro users get priority queue access, meaning their requests are processed before free-tier requests during high-traffic periods.