> For the complete documentation index, see [llms.txt](https://metaversenw.gitbook.io/user-manual/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://metaversenw.gitbook.io/user-manual/metaverse-customization/how-to-upload-an-animation-to-your-world.md).
# How to Upload an Animation to Your World
Want to bring your world to life? Here’s how to upload a custom animation using a sprite sheet. Follow these simple steps!
1️⃣ Open Settings
Start by clicking the Settings button at the top-right corner of your screen.
👉 This opens all the customization tools you’ll need.
2️⃣ Click “Add Object”
In the Settings panel, click the Add Object button
3️⃣ Click “Create A New Object”
Next, click the “Create A New Object” button (highlighted in pink).
4️⃣ Select “Animation”
In the upload window, choose “Animation” as the upload method.
5️⃣ Prepare & Upload a Sprite Sheet
For animations, you need to upload a sprite sheet—a single PNG file with all the animation frames placed in a single row.
👉 Here’s an example I made using ChatGPT and Photoshop of a volcano erupting:
✅ In this example, the animation is made up of 16 frames. Make sure your sprite sheet is the same format: all frames in one horizontal line.
6️⃣ Fill Out the Upload Form
Once you select your sprite sheet:\
✅ Enter a name for your animation (e.g. “Volcano”).\
✅ Enter the Quantity frames (the total number of frames—in this case, 16).\
✅ Choose the Depth (e.g. “Above Floor” to make it float above ground).
👉 Then click Upload.
7️⃣ Place Your Animation in the World
After uploading, the animation will appear in your object list.\
👉 Move your mouse over your world to position it exactly where you want it.\
👉 Left-click to place it.
✅ When you’re happy with the placement, click “Done” at the bottom to save your changes.
\
---
# 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, and the optional `goal` query parameter:
```
GET https://metaversenw.gitbook.io/user-manual/metaverse-customization/how-to-upload-an-animation-to-your-world.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.
