# MOD FOLDER STRUCTURES

 **For Mods With Variants:** 

mods/                                             # Your mod repository root

├── ModA/                                  # Each mod in its own folder

│ ├── variant1/                           # Contains `variation.png`

│ │ ├── `.stream/.core` files

│ │ └── variation.png

│ └── variant2/

│ │ ├── `.stream/.core` files

│ │ └── variation.png

└── ModB.zip                              # ZIP archive (extracted on drop)

│ ├── variant1/                            # Contains `variation.png`

│ │ ├── `.stream/.core` files

│ │ └── variation.png

│ └── variant2/

│ │ ├── `.stream/.core` files

│ │ └── variation.png

├── preview\.png                            # mod preview image (any name will do), in root folder

└── modinfo.json                          # used to store your mods metadata.

Mods with multiple variants:

<div data-with-frame="true"><figure><img src="https://2456881842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkCtNHGk2ffX9CAfCDGZi%2Fuploads%2FEVVeDtNhwb6W2saYT11R%2FScreenshot%202025-11-27%20191735.png?alt=media&#x26;token=36a45a02-d600-4076-946f-2b9c2ec22235" alt=""><figcaption></figcaption></figure></div>

Inside a variant:

<figure><img src="https://2456881842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkCtNHGk2ffX9CAfCDGZi%2Fuploads%2Fi2rZVG8xtAX24kbRGiRO%2FScreenshot%202025-11-27%20192031.png?alt=media&#x26;token=52211da7-4461-4c0b-826c-557901bd6517" alt=""><figcaption></figcaption></figure>

**For Mods With Non-Variants**

mods/                                                 # Your mod repository root

├── ModA/                                        # Each mod in its own folder

│ ├── `.stream/.core` files

└── `preview.png`                            # mod preview image (any name will do)

├── ModB.zip/                                 # ZIP archive (extracted on drop)

│ ├── `.stream/.core` files

├── `preview.png`                           # mod preview image (any name will do), in root folder.

└── modinfo.json                            # used to store your mods metadata.

<figure><img src="https://2456881842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkCtNHGk2ffX9CAfCDGZi%2Fuploads%2FUIQ5AEGrgOULFmsa6BNw%2Fimage.png?alt=media&#x26;token=6b223feb-a8c6-41e7-9d0f-2188ff15f822" alt=""><figcaption></figcaption></figure>

For ZIP archives, the tool extracts them temporarily, checks for the same structure and logic as uncompressed folders.