> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aurinfer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Minecraft Setup

> Create your character's Minecraft player, prepare your server to accept it, and send your character into the game.

Setting up Minecraft takes four steps: create your character's player, prepare your server, add the server in the dashboard, and press **Play**.

## Create your character's player

**1. Open your character**

Go to [labs.aurinfer.com](https://labs.aurinfer.com), open **Your Characters** and select the character you want to bring into Minecraft.

**2. Choose Minecraft**

In the sidebar, open the **Integrations** dropdown (it reads **Select Integration** or **Add Integration**) and choose **Minecraft**. You see the **Bring \[character name] to Minecraft** page.

**3. Start the setup**

Click **Integrate with Minecraft**. On the Free plan, the button reads **Start free trial** instead.

**4. Fill in the player details**

* **Player Name**: the name other players see in-game. Use 3 to 16 letters, numbers or underscores.
* **Account Type**: set to **Offline**, so no Microsoft account is needed. Your server must accept offline-mode players (see the next section).
* **Skin URL** (optional): paste a NameMC skin link or a direct link to a `.png` skin. The 3D preview updates when the skin is found. Use the **Idle**, **Walk** and **Run** buttons to animate it.

**5. Create the integration**

Tick the box to agree to the Terms of Service and Community Guidelines, then click **Create Integration**. The page reloads, and the sidebar now shows the **Player** and **Play** groups.

> [!NOTE]
>
> You can't rename the player later from the dashboard, so choose the name carefully. You can change the skin at any time on the [Profile](https://docs.aurinfer.com/Integrations/Minecraft/profile.md) page.

## Prepare your server

The character joins with an offline account, so your server has to allow offline-mode players. If it doesn't, the character is refused when it tries to join.

**1. Turn off online mode**

In your server's `server.properties` file, set `online-mode=false`, then restart the server.

**2. Check your proxy, if you use one**

If your server runs behind Velocity or BungeeCord, turn off online mode in the proxy's config too.

**3. Allow the character through plugins and protection**

If an anti-cracked plugin or your hosting provider blocks offline players, allow them there. If you use a whitelist, add your character's player name to it. Firewalls and DDoS protection must allow new connections.

> [!WARNING]
>
> With online mode off, anyone can join your server using any player name. Protect your server, for example with a whitelist that contains only the players you trust and your character.

Your server also needs to:

* run **Minecraft: Java Edition**, on a full release (1.8 or newer). Snapshots and pre-releases can't be joined.
* have a **public address** that's reachable from the internet. Local addresses can't be added.

## Add your server

**1. Open the Play page**

In the sidebar, click **Play → Server**.

**2. Add the server**

Click **Add Server** and fill in:

* **Label**: a name for this server, only for you.
* **Server Address**: your server's address, for example `play.example.com`.
* **Port**: leave it at `25565` unless your server uses another port.

**3. Wait for the check**

The dashboard checks the server and shows its icon, message of the day and player count. The server must be online, and on a supported version, before you can click **Add Server**.

If the server is offline or hides its status, the dialog shows **Server not found or offline**. Double-check the address and port. If they're right, click **Add Anyways** to save the server and connect later, once it's online.

## Send your character in

1. On **Play → Server**, click a server in your list to select it.
2. Click **Play**. The button shows **Connecting...** while your character joins.
3. When it's in, you see **Connected**, its health, hunger and position, and the controls described in [Server](https://docs.aurinfer.com/Integrations/Minecraft/server.md).

If joining takes a while, the dashboard reminds you to check that your server allows offline-mode players. Your server console shows whether the character is trying to join and being refused.

## Free trial and playtime

* **On the Free plan**, your first **Play** starts your free trial session. You get one trial session a month; when it's used, the dashboard shows when it resets. If your character fails to join, the trial isn't used up.
* **On a paid plan**, a badge next to the server shows your remaining playtime for today, or **Unlimited**. Daily playtime resets at 00:00 UTC.
* When your trial or daily playtime runs out, the character leaves the server. If you click **Play** again before it resets, the dashboard offers an upgrade instead.

See [Pricing](https://docs.aurinfer.com/home/pricing.md) for the playtime on each plan.

## If your character can't join

When a join fails, the Play page shows what went wrong, the server's own message if there is one, and steps to fix it. Fix the problem, then click **Try again**.

> [accordion] Server version not supported
>
> The server runs a version the character can't join. The message shows the version your server runs and the newest (or oldest) version that's supported. Switch the server to a supported full release, restart it, and try again.

> [accordion] Server blocks offline-mode players
>
> The server refused the character's offline account. Set `online-mode=false` in `server.properties`, turn off online mode in your Velocity or BungeeCord proxy if you use one, and allow offline players in any anti-cracked plugin or hosting setting that blocks them.

> [accordion] Kicked by the server
>
> The server let the character in and then removed it. Read the server's message and your server console for the reason. If the server uses a whitelist, add your character's player name.

> [accordion] Could not reach the server
>
> The character couldn't connect at all. Make sure the server is online and the address and port are correct, and that firewalls or DDoS protection allow new connections.

Still stuck? Click **Contact Support** in the error message to reach the team on Discord.

## Manage the integration

Open **Player → Settings** to see your Minecraft setup at a glance:

* **Player Name**, with a button to copy it.
* **Account Type**.
* **Status**: turn the switch off to disable your character in Minecraft. While it's disabled, the character can't join servers. Your configuration is kept, and you can turn it back on at any time.
* **Skin**: the current skin link, or **Default skin**.
* A shortcut to the **Play** page, or your free trial status on the Free plan.

### Delete the integration

Under **Danger Zone**, click **Delete**, wait for the short countdown, then click **Delete Integration**. This permanently removes the Minecraft setup, including its settings, stats, training instructions and saved servers. It can't be undone.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.