Guides · Growth

A free SpigotMC resource page template (BBCode included)

Free BBCode template for a SpigotMC plugin page: the section order that sells, the tags SpigotMC supports, image and GIF sizes, and common mistakes.

Updated 9 October 2026 · by Skilled · 4 min read

A good SpigotMC page answers, in this order: what the plugin does, whether it works on my server, what it looks like, and how to set it up. This template follows that order. Copy it, replace the parts in capitals and you have a page that reads well on desktop and on a phone.

The section order that works

Hero image: the plugin in action, with its name.
One paragraph: what it does and for whom.
Compatibility in bold: server software, Minecraft versions, dependencies.
Features: 5 to 8 bullets, each starting with the benefit in bold.
A GIF or video of the main feature.
Getting started: install steps in 3 or 4 lines.
Commands and permissions: inside spoilers, so they don't push everything down.
Support and links: Discord, wiki, source, bug reports.

Configuration details, the full command list and FAQs fit better in the Documentation tab of your resource, which SpigotMC shows next to the description.

The template

Paste this into the description editor in BB code mode (the [ ] button in the editor's toolbar). Replace the capitalised parts.

[CENTER][IMG]https://i.imgur.com/YOUR_BANNER.png[/IMG][/CENTER]

[SIZE=5][B]PLUGIN NAME[/B][/SIZE] does ONE SENTENCE ABOUT WHAT IT DOES AND FOR WHOM. ONE MORE SENTENCE ON WHAT MAKES IT DIFFERENT.
[B]Works on Spigot, Paper and Folia · Minecraft 1.20 to 1.21.x · No dependencies[/B]

[SIZE=5][B]Features[/B][/SIZE]
[LIST]
[*][B]BENEFIT IN A FEW WORDS:[/B] how it works, in one sentence.
[*][B]BENEFIT IN A FEW WORDS:[/B] how it works, in one sentence.
[*][B]BENEFIT IN A FEW WORDS:[/B] how it works, in one sentence.
[*][B]BENEFIT IN A FEW WORDS:[/B] how it works, in one sentence.
[*][B]Fully configurable:[/B] every message, sound and limit in config.yml.
[/LIST]

[CENTER][IMG]https://i.imgur.com/YOUR_GIF.gif[/IMG][/CENTER]

[SIZE=5][B]Getting started[/B][/SIZE]
[LIST=1]
[*]Drop the jar into your plugins folder and restart.
[*]Edit plugins/PLUGIN NAME/config.yml if you want to change anything.
[*]Run /COMMAND to start.
[/LIST]

[SPOILER="Commands"]
[LIST]
[*][B]/COMMAND[/B]: what it does
[*][B]/COMMAND reload[/B]: reloads the configuration
[/LIST]
[/SPOILER]

[SPOILER="Permissions"]
[LIST]
[*][B]plugin.use[/B]: use the plugin (default: everyone)
[*][B]plugin.admin[/B]: admin commands (default: op)
[/LIST]
[/SPOILER]

[SIZE=5][B]Support[/B][/SIZE]
Questions, bugs or ideas: [URL='https://discord.gg/YOUR_INVITE']join the Discord[/URL]. Please report bugs there instead of in reviews, so they get fixed faster.

For a video instead of a GIF, SpigotMC embeds YouTube with [MEDIA=youtube]VIDEO_ID[/MEDIA], where VIDEO_ID is the part after v= in the link.

The BBCode you'll actually use

SpigotMC's editor understands more tags than these, but these cover a clean page:

Tag	What it does
`[B]…[/B]`, `[I]…[/I]`, `[U]…[/U]`	Bold, italic, underline
`[SIZE=5]…[/SIZE]`	Bigger text, for section titles (1 to 7)
`[COLOR=#3f8a2a]…[/COLOR]`	Coloured text; use it for one accent, not everywhere
`[CENTER]…[/CENTER]`	Centres images and lines
`[IMG]url[/IMG]`	An image from a link (SpigotMC doesn't host images)
`[URL='link']text[/URL]`	A link with its own text
`[LIST]` / `[LIST=1]` with `[*]`	Bulleted / numbered list
`[SPOILER="Title"]…[/SPOILER]`	A collapsible block
`[CODE]…[/CODE]`	A monospaced block for config snippets
`[MEDIA=youtube]id[/MEDIA]`	An embedded YouTube video

Images and GIFs: sizes that work

Host images on Imgur or similar and link the direct file URL (ending in .png, .jpg or .gif). SpigotMC loads them through its own image proxy.
Keep GIFs under about 3 MB. In our experience bigger ones aren't served by the proxy and show as broken images. Short loops (5 to 8 seconds) around 600 px wide fit.
Banners around 1000 px wide look sharp on desktop and scale down on phones.
A few tall section images ("poster" panels with a heading, a screenshot and two lines of text) look polished. Keep each one well under a megabyte.

Mistakes that break a description

Editing the BBCode the editor shows you after switching modes. SpigotMC converts between its visual editor and BBCode, and the round trip can break list indentation. Keep your description in a text file, edit that, and paste the whole thing every time.
Line breaks. SpigotMC shows every line break you type. Write each paragraph on one line, or your text breaks in odd places on wide screens.
Emojis. 4-byte emojis (🚀, 🔥…) are stripped when you save. Use simple symbols (★, ✔) or none.
Everything coloured and centred. It looks like a 2012 forum signature. Black text, left-aligned, with one accent colour for section titles reads best.
A changelog at the top. Put it in the Updates tab, where SpigotMC already keeps it.

Is the new page working?

Change the page, then watch whether more of the people who see it download it. SpigotMC only shows downloads, not views, so you can't tell from SpigotMC alone. A tracking image in the description fixes that: PluginAnalytics' listing tag counts views on SpigotMC and Modrinth, and next to downloads and the servers that install your plugin you see whether the new page converts better than the old one.

For everything else that brings downloads (tag lines, update rhythm, reviews, Modrinth and Hangar), see how to get more downloads on SpigotMC.

Skilled

Makes Minecraft plugins (including The Sift on SpigotMC) and PluginAnalytics, so other plugin developers can see how their plugins are found, installed and used.