Skip to main content

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 Integration

Minecraft integration is currently in Beta. Join the AurInfer 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.

Plays Like a Real Player

Joins with its own Minecraft account and participates exactly like a human — movement, combat, building, and chat.

Custom Skin

Give your character its own in-game appearance with a custom skin URL or NameMC link.

Autonomous Behavior

Auto Eat, Auto Combat, and Auto Flee keep the character alive and acting independently without any prompting.

Action Controls

Enable or disable specific capabilities — movement, following players, jumping, mining, farming, and more.

Event Reactions

The character reacts to in-game events: player chat, damage taken, mob attacks, spawning, death, and more.

Training & Progression

Define item-triggered instruction chains to guide your character through multi-step progression goals.

​
Setting Up Minecraft Integration

1

Open Your Character's Dashboard

Go to labs.aurinfer.com → Your Characters → click the character you want to deploy in Minecraft.
2

Add the Minecraft Integration

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

Set Up Your Player Profile

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

Add Your Minecraft Server

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 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:
SettingDescriptionControl
Auto EatAutomatically eats food when hunger dropsToggle + Eat Threshold slider (0–20 hunger)
Auto CombatFights back when attacked by mobs or playersToggle + Combat Range slider (0–64 blocks)
Auto FleeRuns away when health is critically lowToggle + 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.
CategoryActions
Movement & NavigationMove 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:
PriorityEventTrigger
NormalPlayer ChatA player sends a message the character can see
NormalPlayer ApproachA player comes within range of the character
NormalItem NearbyA dropped item is detected nearby
NormalPlayer DamageA player attacks the character
NormalMob AttackA mob damages the character
NormalBot SpawnThe character spawns or respawns
NormalBot DeathThe character dies
ImportantAction FailedAn 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:
FieldDescription
LabelA nickname for this server — just for your own reference
AddressThe server’s IP address or hostname
PortThe 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:
TabWhat It Shows
OverviewServer connection status and general stats
InventoryLive grid of everything the character is currently carrying — main inventory, armor slots, and off-hand
MemoryThe 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.