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

# AurInfer for Minecraft

> Bring your AurInfer character into a Minecraft: Java Edition server as a real player that chats, explores, gathers, fights, builds and remembers.

The Minecraft integration brings your character into a Minecraft server as a player. It joins with its own player name and skin, and it plays with the personality you gave it: it chats with players, explores, gathers and crafts, fights, builds, and remembers what happens on each server.

You set everything up and control it from the AurInfer Labs dashboard. To get started you don't need to install anything on your server, but the server must let offline-mode players join (see [Setup](https://docs.aurinfer.com/Integrations/Minecraft/setup.md)).

> [!NOTE]
>
> Minecraft is in **Beta**, so its behavior and features may change.

## What your character can do

> [card] Chat and talk
>
> Reads the server chat and replies in character. With Simple Voice Chat on the server, it can also use proximity voice with its own voice.

> [card] Play survival
>
> Walks, follows players, mines, collects, crafts, smelts, farms, fishes, trades, sleeps and fights.

> [card] Build
>
> Builds structures from a description, or uses builds you designed and saved in the Builder Engine.

> [card] Remember
>
> Keeps separate memories for each server, such as players, places, goals and tasks, and pins important locations on a radar.

> [card] Follow your rules
>
> Follows your Minecraft instructions, automatic survival habits and training goals that unlock as it collects items.

> [card] Show you what it's doing
>
> Watch its screen live, send it messages and commands, and check its health, inventory, actions and memories.

## What you need

* **A Minecraft: Java Edition server** running a full release, version 1.8 or newer. Bedrock Edition servers aren't supported. If a server runs a version the character can't join yet, the dashboard warns you.
* **Offline mode allowed.** The character joins with an offline (non-Microsoft) account, so the server must accept offline-mode players. [Setup](https://docs.aurinfer.com/Integrations/Minecraft/setup.md#prepare-your-server) shows what to change.
* **A public server address.** The server must be reachable from the internet. Local addresses such as `localhost` or a home network IP can't be added, so a single-player world opened to LAN won't work.
* **An approved character** that you own or manage.

## Plans and playtime

Anyone can set up the integration. What you can do in-game depends on your plan:

* **Free**: a short free trial session once a month. The character disconnects when the trial time is up.
* **Spark** and **Blaze**: daily Minecraft playtime. It resets every day at 00:00 UTC.
* **Aurora** and higher, including the developer plans: unlimited playtime.

The Play page shows how much playtime you have left. Playtime belongs to your account and counts across all your characters.

Some tools need a paid plan (**Spark** or higher): pausing and resuming the character, the console, the live screen viewer, and generating or saving builds in the Builder Engine. Premium chat engines need **Blaze** or higher.

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

## Find your way around

When you open a character with Minecraft set up and choose **Minecraft** in the sidebar's **Integrations** dropdown, the sidebar shows two groups:

| Sidebar item | What it's for | Guide |
| - | - | - |
| **Player → Profile** | Skin and lifetime stats | [Profile](https://docs.aurinfer.com/Integrations/Minecraft/profile.md) |
| **Player → Player Engine** | Chat engine and Minecraft instructions | [Player Engine](https://docs.aurinfer.com/Integrations/Minecraft/player-engine.md) |
| **Player → Builder Engine** | Builder instructions, test builds and saved builds | [Builder Engine](https://docs.aurinfer.com/Integrations/Minecraft/builder-engine.md) |
| **Player → Behavior → Auto Behavior** | Automatic survival habits | [Auto Behavior](https://docs.aurinfer.com/Integrations/Minecraft/behavior.md) |
| **Player → Behavior → Actions** | Which actions the character may use | [Actions](https://docs.aurinfer.com/Integrations/Minecraft/actions.md) |
| **Player → Behavior → Events** | Which game events the character hears about | [Events](https://docs.aurinfer.com/Integrations/Minecraft/events.md) |
| **Player → Training** | Item-based goals and progression | [Training](https://docs.aurinfer.com/Integrations/Minecraft/training.md) |
| **Player → Settings** | Turn the integration on or off, or delete it | [Setup](https://docs.aurinfer.com/Integrations/Minecraft/setup.md#manage-the-integration) |
| **Play → Server → Overview** | Add servers, join, watch and control the character | [Server](https://docs.aurinfer.com/Integrations/Minecraft/server.md) |
| **Play → Server → Inventory** | Live inventory and status | [Inventory & Memory](https://docs.aurinfer.com/Integrations/Minecraft/inventory-memory.md) |
| **Play → Server → Memory** | What the character remembers on a server | [Inventory & Memory](https://docs.aurinfer.com/Integrations/Minecraft/inventory-memory.md#memory) |

## Who can use what

* **The character's owner**, and people who manage the character with them (see [Teams](https://docs.aurinfer.com/Account/teams.md)), see both the **Player** and **Play** groups. Only the owner can use the Builder Engine.
* **Anyone else who opens the character** sees only the **Play** group. If a character has Minecraft set up, its profile shows a **Minecraft** button, and you can filter **Explore** by Minecraft to find these characters. Each person adds their own servers and uses their own plan and playtime.

> [!NOTE]
>
> Premium chat engines only run on servers the owner added. On servers other people add, the character uses the free default engine. On a developer plan, premium engines run everywhere. See [Player Engine](https://docs.aurinfer.com/Integrations/Minecraft/player-engine.md).

## Let your character join on its own

The **Minecraft** tool in the **Tools Library** lets your character join and leave Minecraft servers by itself, for example when someone asks it to in Discord. You choose which of your saved servers it may join. This tool needs a paid plan. See [Tools](https://docs.aurinfer.com/Character/tools.md).

> [!TIP]
>
> You can also manage your character's Minecraft setup from the Android app. See [Mobile](https://docs.aurinfer.com/Mobile/overview.md).

## Get started

> [card] [Set up Minecraft](https://docs.aurinfer.com/Integrations/Minecraft/setup.md)
>
> Create the integration, prepare your server and send your character in.

> [card] [Shape how it plays](https://docs.aurinfer.com/Integrations/Minecraft/player-engine.md)
>
> Pick a chat engine and write the rules your character follows in-game.

> [card] [Watch and control it](https://docs.aurinfer.com/Integrations/Minecraft/server.md)
>
> View its screen, talk to it and check what it's doing.

> [card] [Give it goals](https://docs.aurinfer.com/Integrations/Minecraft/training.md)
>
> Chain goals that unlock as your character collects items.


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