# Making a Thunderstore Mod

## Root Folder (every needed file):

![](/files/Sc6duQDIvTNHvovmhnAK)

This guide will go in order of files added. Make the folders or files needed.

## mods 

Put your mod here. Either zipped or just a folder. Make sure to not have nested files. Refer to image for what nested folders look like:

![](/files/D7kY4mtnOVeCzjXl0SAV)

## icon.png

![](/files/4tQADCBm42xY3MqxAoiB)

Your `icon.png` has to be 256x256 pixels in size. Be creative and put some effort into this. This is the first thing people see when browsing Thunderstore. 

<details>

<summary>If you need help making 256 x 256 Icon</summary>

### Pixlr X:

Go to <https://pixlr.com/x/>

Also found in&#x20;

[/pages/yDyrs0kn6qHg5cTcp2b4#pixlr.com-free-website](https://retryy.gitbook.io/tf2/guide/pages/yDyrs0kn6qHg5cTcp2b4#pixlr.com-free-website "mention")

### Creating the Image

Press `Create new` in the middle of webpage.

![](/files/uCNUdPQ8N3LG2o6Frf2O)

Make your file a Width of 256 and Height of 256.

![](/files/zYKrsdT2OaalB2nHV5dt)

Drop and drop your image you chose for an icon.

Select `Add current`.

Zoom out so you can see the resize guides.

![](/files/Rf3GahOInzJ68tPzd03N)

Now move and scale the image to your preferred view.

#### "SNAPPING IS IN MY WAY!!!"

1. Click the 'Preferences' "settings" gear symbol in the bottom left.
2. Disable "Snap to guides"

![](/files/2FYt7m4QFYwt29m3vEOj)

#### Feel free to add text, background or whatever you want to your icon.

When you are satisfied\
Click 'Save' on the bottom right.

Make sure you have '256 x 256px' image size and Selected PNG for export.

Click 'Save As'

Rename the image and click 'Apply'

#### There it is. You made a 256x256 icon preview for your skin!

</details>

## manifest.json

![](/files/N57H4PWp5NSBTQ4lOHZx)

This is the name and description to your on when browsing the Thunderstore. Just make a manifest.json. To edit a .json files, open them in text editors. Version numbers are important if you plan to update the mod or patch your mod. You can keep dependencies empty if you are using the old uploader. Dependencies only matter if you upload using the new uploader.

Example .json:

```
{
"name": "NAME",
"version_number": "0.0.0",
"website_url": "",
"description": "DESCRIPTION",
"dependencies": []
}
```

## README.md

![](/files/yAqtdGNVFaV8iVWYCDh5)

After you click a mod. You'll see the mod page. Under the mod page you get to README.md. You get to customize this. Just make README.md file and open it in a text editor or use a website like: (<https://markdownlivepreview.com/>). Syntax here:(<https://www.markdownguide.org/basic-syntax/>). Put some effort into this because if it's unclear people won't download and ignore your mod. Look at S2ymi's mod pages for good examples (<https://northstar.thunderstore.io/package/S2Mods/GlitchOverhaul/>).&#x20;

## Finish

That is every part and what they do in a Thunderstore mod.&#x20;


---

# Agent Instructions: 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:

```
GET https://retryy.gitbook.io/tf2/guide/making-a-thunderstore-mod.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.