Upload a New Addon, Snippet, or Package to the Marketplace

The upload command starts a step-by-step guided conversation with the Serpens marketplace bot, allowing you to submit a new addon, snippet, or package directly from Discord. The bot walks you through every required field — including file attachments — and saves your entry to the marketplace once all information has been collected.

Channel Requirement

The upload command (and all marketplace commands) must be used in one of two designated channels:

#addon-market (channel ID 767853772562366514)
#commands (channel ID 768053288989360128)

Messages sent outside these channels are ignored by the bot.

Upload Steps

Addon
Snippet
Package

Start the conversation

Type upload in #addon-market or #commands. The bot will reply asking what type of content you want to upload.

Select the Addon type

Reply with Addon or A. The bot confirms your choice and asks you to paste your Serpens export string.

Paste your Serpens JSON export

Copy the export message from within Serpens and paste it into the channel. The bot validates the string using JSON parsing — if the string is not valid JSON, the bot will ask you to try again.

File attachment (depends on your export settings)

The bot checks the external and blend flags in your JSON export and responds accordingly:

external: true and blend: false — No file upload needed. The entry is saved immediately and the bot confirms: “Thanks for uploading your addon! It might take a few minutes to show up on the marketplace!”
external: true and blend: true — No zip file needed. The bot asks you to attach a .blend example file directly. Once received, the entry is saved and the bot confirms: “Thanks for uploading your addon and blend file! It might take a few minutes to show up on the marketplace!”
external: false and blend: false — The bot asks you to attach your addon’s .zip file. Send it as a Discord attachment. Once the zip is received, the entry is saved and the bot confirms: “Thanks for uploading your addon!”
external: false and blend: true — The bot asks for your .zip file first. After the zip is uploaded, the bot asks for a .blend example file. Once both files are received, the entry is saved and the bot confirms: “Thanks for uploading your addon and blend file! It might take a few minutes to show up on the marketplace!”

Start the conversation

Type upload in #addon-market or #commands. The bot will reply asking what type of content you want to upload.

Select the Snippet type

Reply with Snippet or S. The bot confirms and asks for a title.

Enter a title

Type the name you want to give your snippet.

Enter a description

Type a short description of what your snippet does.

Enter an author name

Type the author name to display on the marketplace listing.

Enter a price

Type a price (e.g. $5) or simply type Free for free submissions.

Choose file delivery method

The bot asks: “Type Yes if you want to upload a file directly and No if you have an external url!”

Type Yes to attach a file directly.
Type No to provide an external download URL.

Provide the file or URL

If Yes: Attach a .zip or .json file to your next message. The bot uploads it automatically.
If No: Paste the external URL into the chat.

Optionally include a .blend file

The bot asks: “Type Yes if you want to upload a blend file and No if you don’t”

Type Yes to attach a .blend example file.
Type No to finish without a blend file.

Attach the .blend file (if Yes)

Attach your .blend file to your next message. Once received, the entry is saved and the bot confirms: “Thanks for uploading your snippet and blend file! It might take a few minutes to show up on the marketplace!”If you typed No in the previous step, the bot confirms immediately: “You’re done! Thanks for uploading your snippet! It might take a few minutes to show up on the marketplace!”

Start the conversation

Type upload in #addon-market or #commands. The bot will reply asking what type of content you want to upload.

Select the Package type

Reply with Package or P. The bot confirms and asks for a title.

Enter a title

Type the name of your package.

Enter a description

Type a description of what the package includes.

Enter an author name

Type the author name to display on the marketplace listing.

Enter a price

Type a price (e.g. $10) or type Free for free submissions.

Paste the download URL

Paste the link to the download page for your package. The bot saves the entry immediately after receiving the URL and confirms: “Thanks for uploading your package! It might take a few minutes to show up on the marketplace!”

The bot automatically sets version: 3 on all package entries. You do not need to include or specify a version yourself.

You can type cancel at any point during the conversation to abort the upload. The bot will discard all progress and confirm the cancellation: “I canceled your upload! Feel free to try again at any time!”

The bot automatically deletes your messages after processing each reply. This keeps the marketplace channels tidy and prevents sensitive information (such as your JSON export string) from lingering in the channel history.

The Serpens JSON export string is generated from within the Serpens visual scripting addon in Blender. Look for the export or share option inside the Serpens interface — it produces a JSON string you can copy and paste directly into Discord. The bot parses this string to extract your addon’s metadata, including the external, blend, and other configuration flags.

Overview

Content Types

Bot Commands

Data Reference

Self-Hosting

Upload a New Addon, Snippet, or Package to the Marketplace

Channel Requirement

Upload Steps

Build docs developers (and LLMs) love

Overview

Content Types

Bot Commands

Data Reference

Self-Hosting

Documentation Index

​Channel Requirement

​Upload Steps

Build docs developers (and LLMs) love

Channel Requirement

Upload Steps