> For the complete documentation index, see [llms.txt](https://cosmo.atomatrix.gg/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cosmo.atomatrix.gg/addons/creating-an-addon.md).

# Creating an Addon

Developers can create add-ons for Cosmo to sell on resource sites like BuiltByBit. Addons for Cosmetics can be created, or Addons can be created for the [Cosmo API](/api/overview.md).

Some examples of possible API add-ons that could be created are Discord Bots with alternative features to the default one or a self-hostable web dashboard that users can use to apply cosmetics.

Feel free to let us know about your addon in the Cosmo Discord Server to be featured in the [Addon Store](broken://pages/PDQ67EN6c1zdyfm5aYZU).

## Addon Terms and Conditions

1. You're not allowed to sell addons that are un-tested.
2. You're not allowed to sell addons that can harm other users or their servers.
3. You're not allowed to include Cosmo's source code with the addon. You must publish only the addon that you have created.
4. You should maintain good support for your resources. The Cosmo team are not responsible for your customers, resources or support for it.

## Cosmetic Addons

You are welcome to make Optifine Player Models (Created in Blockbench) to sell on Sites like BuiltByBit. Users that use these add-ons will not need to API Addon, just a Cosmo License.

You can use the graphic below to put on your resource page to let people know. You should create a hyperlink on the banner that links to the [Cosmo Resource Page](https://builtbybit.com/r/29913).

Direct Banner Link: <https://i.imgur.com/d3SaEZT.png>.

<figure><img src="/files/GnAf4HIChjCWP5F7NXeV" alt=""><figcaption><p>Cosmo Cosmetic Addon Banner</p></figcaption></figure>

## API Addons

For extra resources that require the API Addon, you must let your users know on the resource page.

You can use the graphic below to put on your resource page to let people know. You should create a hyperlink on the banner that links to the [Cosmo Resource Page](https://builtbybit.com/r/29913).

Direct Banner Link: <https://i.imgur.com/qVKtPC0.png>.

<figure><img src="/files/YdjALHEPZQe1L32MltZZ" alt=""><figcaption><p>Cosmo API Addon Banner</p></figcaption></figure>

## Other Addons

For resources that don't require the API Addon, but also provide users with

You can use the graphic below to put on your resource page to let people know. You should create a hyperlink on the banner that links to the [Cosmo Resource Page](https://builtbybit.com/r/29913).

Direct Banner Link: <https://i.imgur.com/KCMeCzt.png>.

<figure><img src="/files/Mf2tNxqSb6BwA74pLut7" alt=""><figcaption><p>Cosmo Other Addon Banner</p></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://cosmo.atomatrix.gg/addons/creating-an-addon.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
