# What is AI Players?

A quick tour of what AI Players adds to your Minecraft world, and what makes its bots different.

import { AccordionItem, Accordions, Card, CardGrid } from '@prosefly/astro-components';

**AI Players** adds computer-controlled players to your Minecraft world. Every bot is a real player (not a mob
dressed up as Steve), with a name, a skin, an inventory and a spot in the tab list. Drop one into a fresh survival
world with empty pockets and it gets to work. It punches trees, crafts tools, cooks its food, builds a house,
works through the night and climbs all the way up to iron, diamond and netherite gear.

Give it a few in-game days and it builds a real base, with houses for its faction, a storehouse full of chests, a
watered farm, a pen of cows, an enchanting corner with bookshelves and a mine. If it likes to play safe, it also
builds a cobblestone fortress with a lava moat and iron golems on guard.

It trades with villagers (and trades its way up to bought armor), fishes at night, rows a boat across lakes and
keeps a water bucket handy for fires and falls. It fights monsters, enchants its kit and travels to
[the Nether](/ai-players/guide/nether/) for blaze rods, potions and ancient debris. It also holds a grudge against
anyone who hits it or robs its chests in front of it.

Bots in a faction split the work between a miner, a farmer and a guard, and call each other for help in team
chat. Some styles take a war further. They scout the enemy's base, tunnel under its wall by night and rob its
chests, and a robbed base raids back (see [Raiding enemy bases](/ai-players/guide/raiding/)). Once a faction's
gear is done, it goes to [the End](/ai-players/guide/the-end/). It hunts eyes of ender, throws them to find the
stronghold and fights the dragon together. Then it brings the egg home, raids an end city for its elytra and
flies from then on.

Install the same jar on your own game and you get a management screen, an orders screen, a debug overlay and
custom skins for your bots ([the client add-on](/ai-players/guide/client-add-on/)). On a modded server, bots
learn a mod's ores and crops from its tags, and a small plugin can teach them a mod's machines, tools and armor
([mod integration](/ai-players/reference/mod-integration/)).

## Playing alongside bots

Bots are made to share a world with you, as teammates or as rivals.

<CardGrid>
  <Card title="Team up" icon="lucide:handshake">
    Put bots in your [faction](/ai-players/guide/factions/) and they protect you, share what they find, follow
    your [orders](/ai-players/guide/orders/) (follow me, stay here, defend this spot, bring me some iron) and ask
    you for help in team chat when they're outmatched.
  </Card>
  <Card title="Compete" icon="lucide:swords">
    Make a rival faction and declare war. Enemy bots gear up, remember where they last saw you and come looking for
    you. Raiding styles also scout your base, slip past its wall and steal from its chests. See
    [Combat and safety](/ai-players/guide/combat/) and [Raiding enemy bases](/ai-players/guide/raiding/).
  </Card>
  <Card title="Watch them grow" icon="lucide:sprout">
    Bots keep playing while you're elsewhere. Come back after a few days and see how far their base has come.
  </Card>
  <Card title="Make them yours" icon="lucide:palette">
    Pick a [play style](/ai-players/guide/play-styles/) (a miner, a fighter, a builder of walls, a raider of
    bases) and a [difficulty](/ai-players/guide/difficulty/), or write your own with a data pack.
  </Card>
</CardGrid>

## Fair play: legit by default

AI Players bots play by the same rules you do. They:

- mine blocks at normal speed, with the right tool, and only blocks they can reach;
- craft with real recipes at a real crafting table, smelt in a real furnace, brew at a real brewing stand,
  enchant at a real enchanting table and upgrade netherite at a real smithing table;
- carry everything they own in their inventory, so a bot with no iron really has no iron;
- open chests, doors and gates with their own hands, and trade through the villager's trading screen;
- row a boat with the same keys you press, fish with a real rod and drink potions from their hotbar;
- glide on an elytra they looted from an end ship, with firework rockets they crafted;
- get hungry, take damage, drown, die and respawn, just like you.

They never fly through walls or spawn items out of thin air. The only teleports they use are the game's own
portals and ender pearls, which they hunt from endermen and throw like a player would. If you *want* to give them
a head start, you can turn on optional [cheats](/ai-players/guide/difficulty/#cheats) per bot, but those stay off
unless a server operator turns them on.

## No AI service involved

Despite the name, AI Players doesn't use ChatGPT, Claude or any other online AI. Bots are driven by hand-written
game logic, like the mobs and villagers in Minecraft itself. Everything runs on your server, works offline and
costs nothing to run beyond some CPU time.

## What's next?

- [Install the mod](/ai-players/guide/installation/) on your server or in singleplayer.
- [Spawn your first bot](/ai-players/guide/first-bot/) and watch what it does.
- [Install the client add-on](/ai-players/guide/client-add-on/) to manage bots from a screen.
- Curious about what's coming? Check the [roadmap](/ai-players/guide/roadmap/).

## Technical details

<Accordions>
  <AccordionItem title="How is a bot a &quot;real player&quot;?">
    Every bot is a server-side player entity (a `ServerPlayer` with a fake network connection), the same technique
    the Carpet mod uses for its fake players. Because of that, bots have player data saved on disk, earn
    advancements and statistics, appear in the tab list and fire the same Fabric and vanilla player events as real
    players. Protection and claim mods see them as players too.

    Other mods can tell a bot apart from a human with the public API, and teach bots their own content through
    a plugin (see [Mod integration](/ai-players/reference/mod-integration/)).
  </AccordionItem>
  <AccordionItem title="How do bots decide what to do?">
    Bots run a scripted "utility AI". About once a second they score a list of goals (survive, gear up, gather,
    build, mine, farm, fish, trade, fortify, explore, scout and raid enemy bases, go to the End...) and work on the
    best one. They break it down into small tasks like "walk there", "mine this block" or "craft that item". The
    process is described in [How the AI works](/ai-players/reference/how-the-ai-works/).
  </AccordionItem>
</Accordions>
