# Uploading to Thunderstore

### We'll use the included template below to help us upload to Thunderstore.

{% file src="/files/P6SLy797aKD14hUW1nYl" %}

{% hint style="success" %}
Unzip the `Template.zip` file.
{% endhint %}

### Here is the "Package Format Documentation" if you'd like: <https://thunderstore.io/package/create/docs/>.

## 1. Skin .zip placement

Replace `SKIN.zip` with you own skin.

This is found in `Template\mods\SKIN_NAME\SKIN.zip`

You can also rename the `SKIN_NAME` folder to your preferred skin name.

## 2. Thunderstore Mod Icon

In `Template/mods/icon.png` replace `icon.png` with your own icon named `icon.png`.&#x20;

{% hint style="success" %}
`icon.png` has to be 256x256 pixels in size.
{% endhint %}

{% hint style="info" %}
This is the first thing people see when browsing Thunderstore.
{% endhint %}

If you need help with making this icon:

<details>

<summary>Making a 256 x 256  icon with Pixlr X</summary>

### Pixlr X:

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

Also found in&#x20;

[/pages/yDyrs0kn6qHg5cTcp2b4#pixlr.com-free-website](https://retryy.gitbook.io/tf2/archive/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>

## 3. Customize your README.md

{% hint style="info" %}
.md file types stand for Markdown. You can still edit these with standard text editors (like Notepad).&#x20;
{% endhint %}

It is recommended you use a previewer; either online or in a text editor. We can use <https://markdownlivepreview.com/> for this.&#x20;

You can also use <https://www.markdownguide.org/basic-syntax/> for syntax for formatting.

Or look at the README.md published on Thunderstore: [here](https://northstar.thunderstore.io/package/when_you_when_i/SKIN_NAME/0.0.2/).

#### Just customize the README.md to your liking.

Transfer from website. Save. Done

## 4. Configure manifest.json

{% hint style="info" %}
To edit a .json files. Open them in text editors.
{% endhint %}

All you need to replace is `"SKIN_NAME",` and `"Description",`. Version number if you'd like.

Save. Done.

## 5. Finalizing the mod zip.

#### Make sure to zip the files. Not a containing folder!

So it's like this:

![Correct pack.](/files/4BAAOnQAPIMBbRLbsarD)

Not like:

![Incorrect pack.](/files/2LbH5TTBot3H93Ni30B1)

You should now have your own `SKIN_NAME.zip` mod!

## 6. Uploading to Thunderstore

{% hint style="warning" %}
You CANNOT remove your mods once they are published onto Thunderstore.
{% endhint %}

sign in (i did github)

top left has upload

use old packer

do the requirements (skins, dds, nsfw if there is)

## 7. Finished.

{% embed url="<https://imgs.search.brave.com/e8pOxYZ8d4AlICvXkOufp8H6HT_YZvxh_U8Ylw6IgrM/rs:fit:860:845:1/g:ce/aHR0cHM6Ly93d3cu/dmh2LnJzL2Rwbmcv/ZC85LTk1NTEyX3Ro/dW1icy11cC1lbW9q/aS1oZC1wbmctZG93/bmxvYWQucG5n>" %}


---

# 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/archive/uploadtothunderstore.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.
