Capabilities

• Möbius Automata can be spawned using the /bot command, by any player, both on servers that have the mod installed and in singleplayer worlds
• The Automata traverse the world around them through the A* pathfinding engine, very similar to what baritone uses.
• The bot is controlled either in chat via suffixes of the /bot command, or through a full menu opened with /automatamenu or by right-clicking the bot — no client mod needed for either
• A bot answers only to the player that spawned it, and to anyone that player chooses to share it with. Nobody else can command it, take its items or so much as make it walk — server operators included
• You can only spawn bots that are not in the world yet
• Multiple bots can be put into a group and then all be commanded at the same time with /botgroup in place of a bot name
• Bots climb ladders, vines and scaffolding, and build their own way out of deep water
• Bots jump off a ledge or the end of their own bridge into water below rather than getting stuck, and place their own water to land in if there is none
• Spear related commands and actions only available in 1.21.11 and future
• All normal carpet player commands are also supported, and every one of them is a button in the menu as well
• Actively defends itself from mobs during processes
• Looks after itself without being told to: digs itself out when buried by falling gravel or sand, raises its shield when a creeper corners it with nowhere to back away to, and keeps swimming toward where it was going while it comes up for air
• Looks after its own gear too: swaps to a spare tool before one shatters, repairs its Mending equipment itself, and keeps everything it is not using in its own ender chest
• Says what it is missing before it starts. No pickaxe for that block, a bow with no arrows, no fishing rod, no storage set, an inventory that filled up with nowhere to put things — you hear it once, up front, instead of watching a bot achieve nothing

Significant features

The Control Panel

• Every command in the mod is also a button. /automatamenu opens a menu of every bot you own, each one wearing its own skin and showing what it is doing, its health and where it is. Your groups sit on the row underneath.
• Opening a bot gives you its whole panel: health, hunger, position, inventories, take control, and a button for every job — mine, mine area, build, craft, drain, fish, hunt, go to, place, bodyguard, workflows, command chains, the carpet controls and all three storages. Its rules are a page of levers sorted into Combat, Staying alive, Working, Crafting and Control.
• The carpet controls are their own page: attack, use, jump, drop, drop stack, swap hands, every direction of movement, sneak, sprint, look, turn, hotbar slot, mount and dismount. The repeatable ones ask how you want them — once, held, or a number of ticks between goes — and the button says so while it is running.
• The inventory button is a menu of its own: the bot's pack on one side, its ender chest on the other, both live and editable straight from the menu.
• It is built entirely out of chests, on the server. A completely vanilla client gets the whole thing, on any server running the mod.
• Where a command needs a block name or coordinates, the menu asks you in chat — and that message is swallowed before it reaches anybody else.
• With the visualselect rule it stops asking in words at all: blocks become a chest of blocks with whatever is near the bot listed first, mobs become a chest of spawn eggs, players become a chest of their own heads, and your schematics and workflows become a chest of their names. Everything pages with arrows.

Mining

• The mod provides both a generic mine command used to find and mine specific blocks, aswell as mine area command used with coordinates.
• For actual collection and usefulness, the mod provides an option pickmineitems that makes the bot actively collect the blocks mined.
• With pickmineitems on the bot mines and collects at the same time instead of stopping to gather, and sweeps the whole area once more when the job is finished so nothing is left lying on the floor.
• Given a fast enough tool it mines straight through soft blocks as it walks rather than aiming at each one in turn, without ever cutting away the ground it is standing on.
• In addition to this, to prevent resource loss in case of a full inventory, a coordinate driven storage gather command is provided. The bot will return to the declared radius and deliver his resources to storage utensils in a radius given in the initial command.
• With the biomeseek rule the bot stops giving up when a resource simply isn't around. The server knows the whole world, not just what is loaded, so the bot finds the nearest biome that actually grows what you asked for and travels there — thousands of blocks if it has to, flying it if it has an elytra.
• When pillaring or bridging, the bot spends anything except the material you sent it to collect, so the harvest comes home instead of becoming scaffolding.

Repairs and Spare Gear

• With the mend rule a bot stops when a tool is down to its last uses and repairs it itself with bottles o' enchanting, tool in the offhand, bottles thrown by hand.
• mendOrder decides which tools matter first and which it should leave alone. Worn armour counts too, not just tools.
• A spare is always the cheaper answer, so if a fresh tool is sitting in its pack, its mend storage or its ender chest it swaps to that instead of spending experience on a broken one.
• storage mend gives a bot a chest of its own for spare tools and bottles, set exactly like the other two. It is looked in before the ender chest, which every bot on the server shares — so a crew of bots stops taking each other's spares. Bottles it did not spend go back in the same chest.
• It only stops and tells you when there is genuinely nothing left to work with — no spare anywhere, and no experience to spend.

The Ender Chest

• Every bot carries its own ender chest and treats it as a pocket. It always knows what is inside, from anywhere in the world.
• Moving things is physical. It walks to a chest standing nearby or sets its own down, opens it, swaps what it needs, then takes the chest back with silk touch — or leaves it standing and remembers exactly where.
• At the start of a job it puts away everything that job cannot use, keeping the best armour, a weapon, the best of each tool, food, a stack of blocks to build with, and a totem or a shield.
• Mid-job it goes and fetches whatever it runs out of — a fresh tool, food, or the experience for a repair — and comes straight back to what it was doing.
• It will never build with a chest, a shulker box or an ender chest, and never puts away the very thing you sent it to mine.

Crafting

• The craft command crafts the real way: in the bot's own 2x2 grid where the recipe allows, otherwise by walking to a crafting table. Missing intermediates are made automatically (logs into planks into whatever you asked for).
• If no crafting table is in range but the bot carries one, it puts it down, uses it, breaks it and takes it with it again. With adaptivecrafting on it will even craft the table itself first.
• max, repeat and drop suffixes turn it into a machine: craft everything the materials allow, keep waiting for new materials forever, and toss the results so hoppers can take them.
• With the adaptivecrafting rule, asking for something the bot cannot make is no longer a refusal. It works out what is actually missing all the way down to raw material, tells you plainly, then goes and mines it. It also picks whichever material is closest — a recipe asking for "any planks" sends it to the spruce at its feet, not the oak four hundred blocks away.

Draining

• The drain command clears water out of an area with sponges, placing them where they soak up the most, leaving them standing as dams while it works, and collecting every one of them again afterwards — including swapping wet ones for dry at a storage if one is set.
• The draining rule decides how mine area deals with water it runs into: with sponges when the bot carries any, or by filling the sources in with spare blocks and mining them back out.

Normal Hunting

• Bots are able to very precisely hunt any entity (if in render distance) using the hunt command

Player Hunting

• A very prominent feature of the mod is player hunting and combat. Multiple rule commands and suffixes are provided to aid the process of commanding a bot to hunt any player anywhere on a world. Alongside this, although not yet bug free, the bot is able to hunt other players through dimensions, by being told where portals are (see Command Definitions and Usage).
  The Automata harness many capabilities related to combat. These include but are not limited to;
• Bridging
• Towering
• Water Bucket Clutching
• Elytra Pursuit
• Mace Chain attacking
• Spear Charging
• Bow usage
• Advanced Sword, Axe and Shield usage
• Totem usage
• Smart Eating
• Digging through whatever the target is hiding behind, rather than standing in front of the last block

Building

• Blocks that need something to attach to (levers, signs, redstone dust, rails, carpets, torches, doors, beds, hanging lanterns, chains and so on) are only placed once their support block exists. Blocks hanging from above are placed in a final pass, after the rest of the build stands.

Workflows

• Bots can record and repeat anything the operator does themselves. The recordworkflow command starts a short guided session; double-tap shift to start, do your cycle, double-tap shift to end. Every movement, block broken, item used and chest interaction is saved under a name.
• Any bot you spawned can then replay that exact cycle with doworkflow, walking to the recorded starting position by itself first.
• Chest interactions are saved by item and amount instead of by slot, meaning the bot still takes and deposits the right things even if the chest was rearranged since.
• Together with the workflowloop rule the bot repeats the cycle forever, making any farm or repetitive manual task fully automatic.
• Should a mob interrupt the bot mid cycle (see mobdefense), it defends itself, returns to the exact position it left off at, and continues.

Command Chains

• Any number of commands, one after the other, separated by commas: /bot commandchain mine iron_ore 64, goto 100 64 100, store iron_ore all.
• Chains can be saved under a name and run again whenever you like, and wait is a step like any other for when something simply needs time.
• A step that fails is tried again before the chain gives up, so one unlucky path does not throw the whole list away.
• With the chainloop rule a finished chain starts again from the top, turning any routine into a permanent one.

Ownership and Sharing

• Every bot belongs to the player who spawned it, and that is enforced everywhere — commands, right-click, movement, combat, its inventory, the lot. Being an operator on the server grants nothing.
• ownership share hands the controls to a friend, as many people as you like. They can do everything you can with it, except give it away or change who else may drive it.
• ownership transfer hands the bot over for good. It leaves your menu and your groups with it.
• Both are also buttons on the bot's own panel, where you pick the player out of a chest of heads.

Group Control

• Bots are put into a group with /botgroup add, as many at once as you like. The group is made by the first bot you put in it and disappears with the last one you take out, so there is never an empty one lying around.
• Any command at all can then be aimed at the group instead of a bot — /botgroup crew mine diamond_ex_ore runs it once for every member. Chat suggestions work inside a group command exactly as they do for a single bot.
• Groups get their own panel in the menu with a roll call: how many are working, the lowest health among them, and how far apart they have spread.

Creative Mode

• Should the operator put a bot into creative mode, it gains the according capabilities.
• Builds no longer require any materials or a build storage, as the bot takes the blocks straight out of the creative inventory, and wrong blocks are broken instantly.
• Movement switches to actual creative flight, sprint flying included, instead of walking, towering and bridging.

Hands-on Control

• With the easycontrols rule you can skip the chat entirely: right-click a bot to open its whole control panel, sneak-right-click it to stop whatever it is doing. Works from a completely vanilla client, no client mod needed, and is on by default.
• A bot you do not own ignores you completely — right-clicking somebody else's bot at spawn does nothing at all.

Command Definitions

Menu
(used on its own)

• /automatamenu opens the control panel for every bot you own and every group you have made

Base Commands
(used as /bot xxx)

• SPAWN spawns a bot
• STOP makes the bot instantly cancel any running task
• STATUS shows what the bot is doing right now ("mining 7/15 oak_log", "building myhouse — layer 4/9", "at its enderchest"), where it is, its health, hunger and air, both of its storages, any loaded schematic, and every rule currently on or off
• KILL kills the bot but lets it keep its items
• DROPALL makes the bot drop all items in its inventory
• OWNERSHIP shows who the bot belongs to and who it is shared with. share, unshare and transfer take a player name (used as /bot ownership share )

Action Commands
(used as /bot xxx)

• GOTO makes the bot go to a specific set of coordinates. If portals are known/declared, can be in any dimension.
• MINE makes the bot search for and mine a specific blocks in the world. compatible with storage gather. can also be used to mine out an area declared with coordinates by using /bot mine area xyz xyz
• CRAFT makes the bot craft an item, in its own grid or at a table it finds, carries or makes itself. accepts max, repeat, once and drop
• PLACE makes the bot put a block from its inventory at a set of coordinates, bridging or towering out to reach it if it has to (used as /bot place xyz)
• STORE makes the bot carry something to its gather storage and put it away, by item and amount (used as /bot store <all/64/2 stacks>)
• DRAIN makes the bot clear the water out of an area with sponges and collect them again afterwards (used with two sets of coordinates)
• HUNT makes the bot search for and kill any entity within render distance. In the case of a player being the target, the bot can use various combat techniques and travel vast distances to eliminate his target.
• BUILD makes the bot build whatever structure is selected per command from the creator's schematics folder, or the server's own.
• OPENINV opens a menu with the bot's own pack and its ender chest, both editable directly
• ENDERCHEST sends everything the current job cannot use to the bot's ender chest
• MEND makes the bot repair its worn Mending gear with bottles o' enchanting
• MENDORDER sets which tools matter first and which to leave alone (used as /bot mendOrder <tools…> blacklist <tools…>)
• COMMANDCHAIN runs a list of commands one after another, separated by commas. save, run and delete keep them under a name (used as /bot commandchain mine iron_ore 64, store iron_ore all)
• WAIT makes the bot stand and wait for a set time, meant as a step inside a chain (used as /bot wait 5m30s)
• FACE makes the bot look at an entity, once or constantly (used as /bot face <once/constant>)
• BODYGUARD makes the bot follow someone and constantly protect them from any attacker. takes start with a name, or stop (used as /bot bodyguard start ). the target can be another bot, so one works while the other watches its back
• FISH finds nearest open body of water bigger than 5x5, stands at its edge and uses fishing rods given to it to fish. Compatible with storage gather
• RECORDWORKFLOW starts a guided recording session in which every move and action of the operator is saved under a given name
• DOWORKFLOW makes the bot walk to the start of one of your recorded workflows and replay it exactly
• TAKECONTROL makes the operator and the bot switch places and gives the operator the bots items with full control over it. say it once to take control, again to let go

Carpet Controls
(used as /bot xxx, all of them also buttons in the menu)

• attack, use, jump, drop, dropStack, swapHands each taking once, continuous, interval or stop
• move forward, backward, left, right or stop
• sneak / unsneak, sprint / unsprint, mount / dismount held on and off like a key
• look points the bot north, south, east, west, up, down, or at a set of coordinates
• turn turns the bot by a number of degrees (used as /bot turn )
• hotbar selects a hotbar slot, 1 to 9

Combat Rules
(used as /bot combatrule xxx <true/false>, or all instead of a rule name)

• allowelytra allows the bot to use an elytra for long range travel and attacks with mace and spear
• allowmace allows the bot to use a mace in combination with elytra (if allowed) to aggressively mace chain its player target
• allowspear allows the bot to lunge towards the player to catch up since it cant sprint jump (if enchanted spear is given) or fly into the player using elytra (if allowed) to do massive amounts of damage
• allowtrident allows the bot to use a riptide enchanted trident to more easily traverse large bodies of water, with which right now (water in general) it struggles
• allowbow exclusively early game rule auto dissabled when elytra and others get allowed to give the bot a chance to do damage from a distance with minimal gear

Gameplay Rules
(used as /bot gameplayrule xxx <true/false>, or all instead of a rule name)

• mobdefense lets the bot defend itself from hostile mobs during any process, on by default
• breathing lets the bot surface for air on its own when it is drowning, on by default
• eating lets the bot care about its hunger and pause whatever it is doing to eat, on by default
• durability keeps a safety margin on tools so they don't shatter, on by default
• mend lets the bot stop and repair its own Mending gear once a tool is down to its last uses, swapping to a spare first if it has one
• draining decides how the bot deals with water while area mining; sponges when it has them, filling it in when it doesn't. on by default
• pickmineitems makes the bot actively try to pick up items dropped from the mine command
• workflowloop makes the bot repeat a workflow forever, returning to the start after every finished cycle
• chainloop makes a finished command chain start again from the top
• biomeseek lets the bot travel to a biome that actually has what it was sent to mine, instead of reporting there is none nearby
• adaptivecrafting lets the bot say what a recipe is missing and then go and mine it, turning pickmineitems on while it is active
• easycontrols right-click the bot to open its control panel, sneak-right-click to stop it. on by default
• visualselect makes the menu ask with a chest of blocks, spawn eggs or player heads instead of asking you to type

Group Commands
(used as /botgroup xxx)

• add puts bots into the group, making the group itself if it does not exist yet (used as /botgroup add )
• remove takes bots back out. the group disappears along with its last member
• any other command /botgroup runs that command once for every bot in the group, from mining and building to stopping and killing them all at once
• /botgroups lists all of your groups and the bots in them

Positional Commands
(used as /bot storage <build/gather/mend> )

• storage gather used to tell the bot where to deposit gathered items (from mining or fishing) in case of a full inventory. provide chests or similar
• storage build used to tell the bot where to find materials for builds. provide chests or similar with materials
• storage mend used to tell the bot where its own spare tools and bottles o' enchanting are kept. looked in before the ender chest, and leftover bottles go back into it

Declaration Commands
(used as /)

• declareNetherPortal tells bot a position for a nether portal
• declareEndPortal tells bot a position for an end portal
• automatadebug controls how much the bots say in chat; joinmsg for the message on world join, all for everything else. with all off you still get errors and warnings. perf reports what a bot's pathfinding and mining are costing the server