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.

The Serpens Addon Market is a community-powered marketplace where Blender creators share addons, node snippets, and packages they have built using the Serpens visual scripting addon. Rather than a traditional web storefront, the marketplace is driven by a Discord bot that lets community members upload, update, and remove their work directly from the Serpens Discord server — no coding or pull requests required. All marketplace data is stored in version-controlled JSON files on GitHub, so every submission is transparent and permanently tracked.

​
What Is Serpens?

Serpens is a visual scripting addon for Blender that lets you build fully functional Blender addons using a node-based editor — no Python experience needed. It is available for purchase on BlenderMarket. The current stable release is version 3.1.2, which introduced outputs for interface nodes, context overrides, and a range of bugfixes.

​
What the Marketplace Provides

The marketplace is a single place to discover and share three kinds of community-created content, all tagged with the Serpens version they target:

Addons

Full Blender addons built and exported from Serpens. Each listing includes metadata such as category, blender_version, addon_version, and an optional .blend source file.

Snippets

Reusable node-group fragments exported as .json or .zip files. Snippets can be imported directly into any Serpens project and optionally include an example .blend file.

Packages

Curated collections of custom Serpens nodes distributed as installable packages. Packages extend the node palette with new building blocks for the Serpens editor.

​
Key Features

  • Discord bot interface — community members interact entirely through the #addon-market channel using plain-text commands (upload, update, remove, cancel).
  • Three content types — addons, snippets, and packages are stored and surfaced separately so users can find exactly what they need.
  • File hosting via Discord CDN — uploaded .zip, .py, and .blend files are stored as Discord message attachments and referenced by their cdn.discordapp.com URLs, so no external file host is required.
  • External URL support — creators who host their work on platforms like Gumroad, BlenderMarket, or GitHub can submit a link instead of a direct file upload.
  • Git-backed data store — every change the bot makes to addons.json, snippets.json, or packages.json is automatically committed and pushed to GitHub, creating a full audit trail.
  • Serpens version tagging — entries carry a serpens_version field so users can filter content by the version of Serpens they have installed.

​
Bot Startup and Unknown Commands

When the bot first connects, its on_ready event handler fires and prints Connected to Discord! to the console, confirming a successful login. If a user sends a message in one of the allowed channels but has no active conversation with the bot, the bot responds with a usage reminder listing the three available commands. This reminder is prefixed with a randomly chosen emoji from the random_emoji() function — a lighthearted way to signal that the bot did not recognise the input: 
:dog: Hey, I don't have a conversation with you yet, just type:

- Upload for uploading
- Update for updating
- Remove for removing
The random emoji is picked from a built-in list of 27 options (animals, food, and everyday objects) and changes each time.
The Serpens Addon Market is entirely community-maintained. Listings are added and updated by the creators themselves through Discord. Because all data lives in a GitHub repository, every change propagates to the marketplace within minutes of the bot’s automatic git push.
Pricing is flexible and set by each creator. Free addons typically leave the price field empty or set it to "Free", while paid items include a price string such as "$8" or "15". The marketplace does not process any payments — all transactions happen directly between buyers and sellers on external platforms.

Build docs developers (and LLMs) love

Get started for freeTalk to us