Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/joshuaKnauber/serpens_addon_market/llms.txt

Use this file to discover all available pages before exploring further.

Addons in the Serpens Addon Market are complete, installable Blender addons built using the Serpens visual scripting system and shared with the community. Each addon is a self-contained Blender extension — ranging from small productivity tools to fully-featured content pipelines — distributed either as a downloadable ZIP file (hosted on the Discord CDN) or via an external link to platforms such as Gumroad, BlenderMarket, or GitHub. Any community member can submit their own Serpens-built addon through the Discord bot.

Entry Schema

Every addon entry in addons.json contains the following fields:
name
string
required
The display name of the addon shown in the marketplace listing.
description
string
required
A short human-readable description of what the addon does.
category
string
required
The Blender addon category the addon belongs to (e.g. "3D View", "Render", "Node", "Physics").
author
string
required
The display name of the addon’s author.
blender_version
array
required
The minimum Blender version required, expressed as a three-element integer array [major, minor, patch]. For example, [2, 93, 0] means Blender 2.93.0 or later.
addon_version
array
required
The version of the addon itself, expressed as a three-element integer array [major, minor, patch]. For example, [1, 2, 0] means version 1.2.0.
external
boolean
required
Set to true if the addon is hosted on an external platform such as Gumroad, BlenderMarket, or GitHub. Set to false if the file is uploaded directly and stored on the Discord CDN.
url
string
required
The download or product page URL. For direct uploads this is a cdn.discordapp.com link to a .zip file; for external addons it is the Gumroad, BlenderMarket, or GitHub URL.
blend
boolean
required
Set to true if an optional companion .blend example file is included alongside the addon.
blend_url
string
The URL of the companion .blend example file. Only present and non-empty when blend is true.
price
string
The price of the addon as a plain string, e.g. "Free", "$8", "2.99". May be null or an empty string for free direct uploads that predate the price field.
user
integer
required
The Discord user ID (snowflake) of the community member who submitted the addon. Used by the bot to associate the entry with its owner.
serpens_version
integer
Optional. Indicates which major version of Serpens the addon was built with — 2 or 3. Entries that predate this field may omit it entirely.

Example Entry

Below is a real entry from addons.json — the QuickUV addon by Brennan, which includes a companion .blend file:
{
    "name": "QuickUV",
    "description": "Pi Menu for some common UV Editing to make the workflow a little less cluttered and faster, Use with Ctrl+Shift+E on both 3D View and Image Editor",
    "category": "3D View, Image Editor",
    "author": "Brennan",
    "blender_version": [2, 80, 0],
    "addon_version": [1, 1, 0],
    "external": false,
    "url": "https://cdn.discordapp.com/attachments/785132940278366260/862581802895147018/quickuv_1.1.0.zip",
    "price": "",
    "blend": true,
    "blend_url": "https://cdn.discordapp.com/attachments/785132940278366260/862581992243593267/QuickUV_Serpens.blend",
    "user": 148734666659069952
}

Distribution Methods

Addon authors can choose from two hosting methods when submitting through the Discord bot.

Direct File Upload

Upload a .zip file directly in the Discord channel. The bot saves the file and stores a permanent cdn.discordapp.com URL in the registry. This is the simplest option for free, community-shared tools.
  • The external field is set to false.
  • The url field points to a Discord CDN attachment URL.
  • No Gumroad or external account is required.

External URL

Provide a link to an external download or product page. This method is used for paid addons, GitHub releases, or anything hosted outside Discord.
  • The external field is set to true.
  • The url field is a link to Gumroad (gumroad.com), BlenderMarket (blendermarket.com), or a GitHub repository/release page.
  • The marketplace displays the link directly; users are directed to the external platform to obtain the file.
Both hosting methods are equally valid. External links are required for paid addons, since Discord does not support payments.

Optional Companion .blend File

Any addon can optionally include a companion Blender file that demonstrates how the addon works or serves as a development reference.
  • Set blend to true to indicate a companion file exists.
  • Set blend_url to the URL of the .blend file (typically another Discord CDN attachment).
When blend is false, blend_url should be an empty string. The marketplace uses the blend flag to decide whether to show a “Download Example” button.
Including a companion .blend file is a great way to help other Serpens users understand how your addon was built, especially if you want to share its node tree as a learning resource.

How to Submit

Addon submissions are handled entirely through the Discord bot. Type Upload in the addon-market channel, select Addon, then paste in the JSON export you copied from Serpens. The bot will walk you through attaching your ZIP file (and optional .blend). For full step-by-step instructions, see the Upload command reference. For a complete field-by-field reference, see the Addon Schema.

Community Addons

Here is a selection of real addons currently listed in the marketplace:

QuickFrame

Author: Brennan CurrierQuickly add a frame in node editors (including the Serpens editor) using the Ctrl+F keymap shortcut.

kolup_superspeeds

Author: kolupsy · Price: FreeCreate a group of objects, collections, and modifiers that can all be toggled off in one click for better viewport performance. Hosted on Gumroad.

Serpens Buttons

Author: vranimetedQuick access to frequently used buttons in the 3D viewport. Includes a companion .blend development file.

Easy Soft Body

Author: Luca Boisvert · Price: $8A fast and easy soft body simulation setup with just a few clicks. Available on BlenderMarket.

Serpens Node Wrangler

Author: CorzaBuilt with Serpens, for Serpens — a node wrangler utility specifically designed for the Serpens node editor.

Crease Pie Menu

Author: WilphiAdds a pie menu in edit mode for quickly adjusting edge crease values, with options to set, clear, or use the standard crease operator.
NameAuthorCategoryPrice
QuickUVBrennan3D View, Image EditorFree
IL GRANDE POMODOROShawn Blanch (blanchsb)3D View$10.00
Layer Creatorshade who3D View$15
Dummy Materialsbleedn3D ViewFree
Serpens Node TemplatesskdsamNodeFree
World_Generator 1.01Thibault Fisset3D View$15
Shader Group DefaultsSMOUSEShader EditorFree
CollectorAyjentUser InterfaceFree

Build docs developers (and LLMs) love