> For the complete documentation index, see [llms.txt](https://wiki.auraplugins.eu/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.auraplugins.eu/getting-started/studio.md).

# AuraSounds Studio

**AuraSounds Studio** is the official web companion of the plugin. It turns any audio file into a server-ready sound in about a minute — no audio tools, no manual configuration.

👉 [**studio.auraplugins.eu**](https://studio.auraplugins.eu)

## What it does

1. **Upload any audio file** — mp3, wav, ogg, flac, m4a, aac or opus (up to 30 MB).
2. **It compresses it for you** — converted to OGG Vorbis at the right bitrate for Minecraft, with an optional mono downmix that halves the file size.
3. **Configure your sound visually** — type (ambient, music), volume, looping, fades, zones, and the full condition system (time of day, weather, biomes, altitude...) in a simple form.
4. **Pick your setup** — ItemsAdder, Nexo, or a plain resource pack. The download adapts:
   * **ItemsAdder** — a ready-made `plugins/ItemsAdder/contents/` folder: drop it on your server and run `/iazip`.
   * **Nexo** — the pack lands in `plugins/Nexo/pack/external_packs/`: drop it and reload Nexo.
   * **Manual** — a standalone resource pack to distribute however you like.
5. **Drag & drop** — every download includes the matching `plugins/AuraSounds/sounds/<name>.yml`, ready to use. Run `/aurasounds reload` and you're done.

The Studio is available in **English and French** (toggle in the top-right corner).

## Getting access

The Studio is **invite-only**: every customer gets a personal access code.

{% hint style="info" %}
**To receive your access code, send me a private message on Discord.** Include the username you purchased with so I can verify it quickly.
{% endhint %}

Your code is personal — entering it on a new device signs out the previous session, so there is no point sharing it.

## Tips

* Prefer **mono** for ambient loops and positional sounds: Minecraft only spatializes mono audio, and the file is half the size.
* Use **Medium (\~96 kbps)** compression unless the sound is music — then pick Light (\~128 kbps).
* The generated YAML is a normal AuraSounds [sound file](/guides/sound-files.md): you can edit it by hand afterwards like any other.


---

# 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://wiki.auraplugins.eu/getting-started/studio.md?ask=<question>&goal=<endgoal>
```

`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.
