> For the complete documentation index, see [llms.txt](https://worldboxopenmods.gitbook.io/mod-tutorial-en/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://worldboxopenmods.gitbook.io/mod-tutorial-en/other-techs/modupload.md).

# Mod Upload

## Introduction

You can upload mod to workshop in game. And you should upload mod in game to provide a basic guarantee that your mod works.

## How to upload

Click mod icon eight times exactly and interval should be less than 1s. Then wait for 3s, an upload window should pop up. Like this:

![Upload Window](/files/APkM0z4up3TMQiy0MhTS)

The top field is used to input `fileID` when editing your item on workshop. Keep it empty if you upload a mod first time.

The below field is used to input changelog. It can be empty and you can edit it on workshop item page.

### How to edit mod

Similar with uploading, and input `fileID`. You can get your mod's `fileID` in the url of your mod's item page.

## Authentication

If you are uploading a new mod, you need to authenticate. Here are two approaches:

1. Discord
2. Github Organization
3. Skip Authentication

![Authentication Window](/files/Rs6AT9piPSnCndAl2W8s)

### Discord

You need to have `Modder` role in WorldBox official discord server. Contact with administrator to get it.

### Github Organization

You need to join `WorldBoxOpenMods` organization on github which owns `NML`. Send an email titled "WorldBoxOpenMods" and with your github username as content and your mod as attachment to <wbopenmods@gmail.com>. Then wait for at most a week.

### Skip Authentication

If you skip authentication, your mod will be uploaded with tag `Unverified Mods`.

## Attention

You need to make sure your mod works in any directory.


---

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

```
GET https://worldboxopenmods.gitbook.io/mod-tutorial-en/other-techs/modupload.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.