> For the complete documentation index, see [llms.txt](https://retryy.gitbook.io/tf2/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://retryy.gitbook.io/tf2/guide/making-a-thunderstore-mod.md).

# Making a Thunderstore Mod

What else should i clarify?

## Root Folder (every needed file):

![](https://1960366533-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz2f8BXwKo4kqhtL6lDjN%2Fuploads%2FpJnv41LtpFV0BFSA1CyD%2F24-3.png?alt=media\&token=75c0b7ed-2487-4d46-98b2-7b4447c62118)

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:

![](https://1960366533-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz2f8BXwKo4kqhtL6lDjN%2Fuploads%2FvIMqscVKWMUxMYNTCbrk%2F23-4.png?alt=media\&token=dd255206-a963-429d-bace-1c016c2a2827)

## icon.png

![](https://1960366533-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz2f8BXwKo4kqhtL6lDjN%2Fuploads%2FZGb7US0nngltDPlla4e4%2Fclipboard26.png?alt=media\&token=781f688b-8896-4130-9db8-5b501ffa57e4)

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.

![](https://1960366533-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz2f8BXwKo4kqhtL6lDjN%2Fuploads%2FoerAzL923VjBNJUqE2qh%2Fscreenshot-000013.png?alt=media\&token=e06bbc9b-b2d2-4bcb-ba03-93fcface16f8)

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

![](https://1960366533-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz2f8BXwKo4kqhtL6lDjN%2Fuploads%2FbEGqVsA9vRDH6BAeeHTr%2Fscreenshot-000015.png?alt=media\&token=466e7a28-5b77-4176-97b4-a18a94a4958e)

Drop and drop your image you chose for an icon.

Select `Add current`.

Zoom out so you can see the resize guides.

![](https://1960366533-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz2f8BXwKo4kqhtL6lDjN%2Fuploads%2FnaeqJB8NoD7fqctk9wHb%2Fscreenshot-000016.png?alt=media\&token=2d07e0b9-7b92-4edc-95c4-b0dac4c35bf8)

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"

![](https://1960366533-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz2f8BXwKo4kqhtL6lDjN%2Fuploads%2Fbva47V0gIaAr7hw1hU6h%2Fscreenshot-000018.png?alt=media\&token=2790cdd3-9250-4db4-b12b-99c7038f6f67)

#### 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

![](https://1960366533-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz2f8BXwKo4kqhtL6lDjN%2Fuploads%2FUAKyoZq4XI2a7wNZZLay%2Fclipboard27.png?alt=media\&token=9baf839c-cc25-44c1-a0b9-dfd403919288)

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

![](https://1960366533-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz2f8BXwKo4kqhtL6lDjN%2Fuploads%2Ff8PqiFB2Axn8odu3FRL9%2F28-0.png?alt=media\&token=d1f02940-5a4d-4591-a9d9-0222ff558381)

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;