> ## 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 > Deploy your AurInfer character as a Minecraft player — it joins your server, chats, fights, builds, and plays the game like a real person. Currently in Beta. # Minecraft Integration Minecraft integration is currently in **Beta**. Join the [AurInfer Discord](https://aurinfer.com/discord) to get early access and share feedback. AurInfer's Minecraft integration deploys your AI character as a **real player** in your Minecraft server. It connects and plays the game exactly like a human would — chatting with other players, exploring, fighting, building, and reacting to the world around it. All driven by its personality. No plugins. No server modifications. No configuration files. You manage everything from the AurInfer dashboard. Joins with its own Minecraft account and participates exactly like a human — movement, combat, building, and chat. Give your character its own in-game appearance with a custom skin URL or NameMC link. Auto Eat, Auto Combat, and Auto Flee keep the character alive and acting independently without any prompting. Enable or disable specific capabilities — movement, following players, jumping, mining, farming, and more. The character reacts to in-game events: player chat, damage taken, mob attacks, spawning, death, and more. Define item-triggered instruction chains to guide your character through multi-step progression goals. *** ## Setting Up Minecraft Integration Go to [labs.aurinfer.com](https://labs.aurinfer.com) → **Your Characters** → click the character you want to deploy in Minecraft. In the left sidebar under **INTEGRATIONS**, click the **Select Integration** dropdown and choose **Minecraft**. You'll see the "Bring \[Character Name] to Minecraft" page. Click **Integrate with Minecraft**. Fill in the setup form: * **Player Name** — the in-game username (3–16 characters). This is how the character will appear to other players in your server. * **Account Type** — choose **Offline** (no Microsoft account needed, works on most servers) or **Microsoft** (for servers requiring a valid Minecraft account). * **Skin URL** — paste a direct `.png` image URL or a NameMC skin link to give your character a custom look. A live 3D preview updates as you type. * Check the **Terms of Service** checkbox. * Click **Create Integration**. In the sidebar, go to **Play → Server** and click **+ Add Server**. Enter: * **Label** — a nickname for this server (just for your reference) * **Address** — the server's IP address or hostname * **Port** — defaults to `25565`, change if your server uses a different port. Your character will connect and start playing automatically. *** ## Player Profile Go to **Player → Profile** to manage your character's in-game identity. **Player Skin** Your character's skin is shown as a live 3D model with animation toggles (Idle, Walk, Run). The current skin URL is displayed and can be copied or changed with the **Change Skin** button. If using an **Offline** account type, Minecraft servers won't display the custom skin by default. To show the skin on your server, install the [SkinRestorer](https://modrinth.com/mod/skinrestorer) mod on your server, then run this command in-game: `/skin set web classic "[your_skin_url]"`. A pre-filled copy command is available on the Profile page. *** ## Player Engine Go to **Player → Player Engine** to configure the AI core for Minecraft. * **AI Model** — select the model powering your character in-game (e.g., GPT-OSS 120B) * **System Instructions** — write custom instructions that define how your character behaves in Minecraft. This is separate from the base character personality — use it to set goals, playstyle, tone when talking to players, and general priorities in-game. Be specific in your system instructions. Describe how the character plays — is it aggressive or passive? Does it try to help other players or compete with them? Does it prefer mining, building, or exploring? The more specific, the more natural it feels. *** ## Behavior Go to **Player → Behavior** to configure automatic in-game responses. ### Auto Behavior These are survival instincts that run independently, without the AI needing to decide: | Setting | Description | Control | | --------------- | -------------------------------------------- | ----------------------------------------------- | | **Auto Eat** | Automatically eats food when hunger drops | Toggle + **Eat Threshold** slider (0–20 hunger) | | **Auto Combat** | Fights back when attacked by mobs or players | Toggle + **Combat Range** slider (0–64 blocks) | | **Auto Flee** | Runs away when health is critically low | Toggle + **Flee Threshold** slider (0–20 HP) | Changes to behavior settings save automatically and take effect on the character's next spawn. ### Actions Go to **Player → Behavior → Actions** to control which in-game capabilities your character can use. Actions are organized into categories. Toggle each action on or off — disabled actions are completely blocked and excluded from the AI's decision-making. | Category | Actions | | ------------------------- | --------------------------------------------------------------------------------- | | **Movement & Navigation** | Move To (walk to coordinates), Follow (follow a player or entity), Jump, and more | | *(More categories)* | Mining, Farming, and other capability groups depending on your plan | Enabling an action makes it available, but for best results also describe in **Player Engine → System Instructions** when and how the character should use it. The AI makes better decisions when it understands the intent behind each capability. ### Events Go to **Player → Behavior → Events** to configure what in-game events the character reacts to. Each event can be individually toggled, and events are grouped by priority: | Priority | Event | Trigger | | ------------- | --------------- | ---------------------------------------------- | | **Normal** | Player Chat | A player sends a message the character can see | | **Normal** | Player Approach | A player comes within range of the character | | **Normal** | Item Nearby | A dropped item is detected nearby | | **Normal** | Player Damage | A player attacks the character | | **Normal** | Mob Attack | A mob damages the character | | **Normal** | Bot Spawn | The character spawns or respawns | | **Normal** | Bot Death | The character dies | | **Important** | Action Failed | An attempted action failed | Disable events you don't want the character to respond to. The AI uses active events to understand what's happening around it and decide how to respond. *** ## Training Go to **Player → Training** to define instruction chains that guide your character through progression goals. Training uses **item-triggered instructions** — a set of instructions that activate automatically when specific items appear in the bot's inventory, and deactivate once other items are obtained. This lets you chain multi-step goals without manual intervention. **How it works:** * **Trigger Item** — the instruction activates when this item appears in the bot's inventory (e.g., Wooden Log) * **Instruction** — what the bot should do while this trigger is active (e.g., "Craft planks and build a shelter") * **Closing Item** — the instruction deactivates once this item is obtained (e.g., Wooden Planks) Leave the trigger and closing items empty for **always-active instructions** — useful for spawn behavior like "Find a safe spot and start gathering wood" that should run every time the character enters the world. Click **+ Add Instruction** to create your first training step. *** ## Play — Server Go to **Play → Server** to manage which Minecraft servers your character connects to. Click **+ Add Server** and fill in: | Field | Description | | ----------- | -------------------------------------------------------- | | **Label** | A nickname for this server — just for your own reference | | **Address** | The server's IP address or hostname | | **Port** | The connection port — defaults to `25565` | Once a server is added, your character connects automatically and starts playing. ### Monitoring The **Play → Server** section has three sub-tabs for monitoring your character in real time: | Tab | What It Shows | | ------------- | ------------------------------------------------------------------------------------------------------- | | **Overview** | Server connection status and general stats | | **Inventory** | Live grid of everything the character is currently carrying — main inventory, armor slots, and off-hand | | **Memory** | The character's current internal state and environmental awareness | *** ## Tips for Great Gameplay For roleplay or story servers, describe your world, its lore, and setting in the **System Instructions**. The character will reference it naturally when talking to other players. Use **Training** instruction chains to give your character a progression arc. A character that starts by collecting wood, then builds a base, then goes mining feels far more alive than one that just wanders. Keep **Auto Eat** and **Auto Flee** enabled unless you want to manage survival manually. They prevent the character from dying from simple causes while it focuses on doing more interesting things. Minecraft integration is Beta — behavior and capabilities are still evolving. If you run into bugs or unexpected behavior, report them in the **#minecraft-beta** channel on the [AurInfer Discord](https://aurinfer.com/discord).