> For the complete documentation index, see [llms.txt](https://handbook.tronmc.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://handbook.tronmc.com/image-on-map-iom.md).

# Image-on-Map (IOM)

Upload artwork, create map bundles, and manage them safely.

Turn an image into a Minecraft map display with IOM. Upload it, pass moderation, then use the generated command in-game.

{% hint style="info" %}
Link your Discord account before uploading. Run `/discord link` in-game, then sign in again.
{% endhint %}

### How IOM works

1. Upload an image through **My Uploads** or `/upload-image` in Discord.
2. IOM scans it for server-safe content.
3. Approved images appear in your library with ready-to-copy commands.
4. Create the map once, then request copies whenever you need them.

### Upload an image

{% stepper %}
{% step %}

#### Sign in and open your library

Sign in with Discord, then select **My Uploads**.
{% endstep %}

{% step %}

#### Choose the image settings

Upload a PNG, JPG, or WEBP image. Give it a short name using letters, numbers, `_`, or `-`.

Set the width and height from `1` to `10`. A `1 × 1` image uses one map. Larger dimensions create a combined map display.
{% endstep %}

{% step %}

#### Upload and scan

Select **Upload & Scan**. The image appears as **Approved & Active** when moderation passes.
{% endstep %}
{% endstepper %}

You can also run `/upload-image` in Discord. It accepts the same image formats, name, and optional dimensions.

### If an image is held for review

IOM assigns each held upload a six-character ID, such as `8f9a1b`. Open an appeal ticket within 30 minutes and include that ID.

{% hint style="warning" %}
Opening an appeal pauses deletion. Staff can approve or reject the image after review.
{% endhint %}

{% hint style="danger" %}
**If an appeal is not placed within 30 minutes, your image will automatically be removed and will have to be reuploaded**
{% endhint %}

### Use an approved image in-game

Select **Use In-Game** on the image card. The dashboard shows the correct command for its current state.

{% stepper %}
{% step %}

#### Create the map for the first time

Keep enough empty maps in your inventory. Copy the **First Time Creating This Map** command and run it once:

```
/imageframe create <name> <provided-url> <width> <height> combined
```

{% endstep %}

{% step %}

#### Get another copy

After creation, use the reusable command:

```
/imageframe get <name> combined
```

{% endstep %}
{% endstepper %}

The card shows **In-Game Map #…** when IOM detects the map on the server. At that point, use the copy command rather than creating it again.

### Remove an image

Deleting an image from **My Uploads** removes its cloud file. It does not remove an existing server map.

Run the dashboard’s **Delete From Server** command to remove the cached map:

```
/imageframe delete <name>
```

{% hint style="warning" %}
This command will delete all current maps that have the image you're deleting. In regard to Staff-Deleted images, those are deleted instantly from the server.
{% endhint %}


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://handbook.tronmc.com/image-on-map-iom.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.