docs.ero.dance

Appearance

Upload ​

You can load files from the web into ero.dance using query parameters. This allows you to share links that directly load your scene; see here. However, you first need to upload the files somewhere.

Requirements ​

To upload files, you need a file host that allows direct linking to the files. The files must be accessible via a URL and the host must allow cross origin requests.

Compatibility to different file hosts ​

Image Hosts ​

You might store your scene data as ero.dance image card and then use an image host to upload it.

There are two reasons why a file host might not work:

  1. The file host does not allow cross origin requests from https://ero.dance for png files.

INFO

If your favorite image board isn't working for this reason, feel free to ask the host to allow cross origin requests from https://ero.dance for PNG files.

  1. The file host compresses the image and thereby deletes all MMD data.

TIP

Creating an image card with animated cover image may prevent this compression by some file hosts. When creating an image card, there is are options at "Animated Image" to create an animated image cover.

Zip files ​

You can also store your scene data into zip files and upload it to a file host that allows direct linking to zip files. But keep in mind that the zip should use a standard zip compression und no password protection.

Already tested file hosts ​

Permanent storage via Arweave ​

ArDrive helps you upload your files permanently to the Arweave blockchain.

ArDrive.io Promise

Even if they promise permanent storage, you never know. So make sure to keep a local backup of your files.

Pricing ​

Keep in mind that this option requires AR tokens. You can calculate the price here

INFO

As of early 2025, uploading a typical ero.dance card costs less than $0.20 USD.

Usage ​

After uploading, you will see the Data Tx ID of your file. You just need the public URL to your file, which might look like this: https://ar-io.net/{data_tx_id}

By following the steps outlined here, your direct link to the scene might look like this:

ero.dance/?arb=https://ar-io.net/{data_tx_id}.