FAQ¶
Do I need an AI model or Ollama?¶
No. Skills, following, building, fighting, storage and scripted dialogue all work without one. Ollama is only for the optional Soul Chat, where frens answer in their own words. See Talking with frens (AI chat).
Do I need Carpet?¶
No. Carpet is recommended alongside Frens, but it isn't required.
Which Minecraft version?¶
Java Edition 1.21.11, with Fabric Loader 0.17.3 or newer and Fabric API. See Getting started.
Questing or Admin mode?¶
Admin, unless you specifically want to recruit frens through a village questline. Questing is still in development and buggier. See Getting started.
How do I make a fren stop?¶
Look at it and press \, or run /bot stop <name>. To keep it following you while it stops grabbing drops for a minute, use Stand Down instead.
How do I give a fren items?¶
Open its inventory with /bot open <name> and move items in, the same way you would with a chest.
My fren's pack is full. How do I empty it?¶
Use Quick Store: open its inventory, then Actions, Core Actions, Quick Store, and click a chest. It keeps its tools and food unless you shift-click. During a job it puts its haul in a nearby chest by itself, and some jobs place a chest when there isn't one. See Storage and chests.
My fren is stuck or lost. How do I get it back?¶
Use Regroup (/bot regroup <name>) to call it back with the safer recovery behaviour. If you turn on Follow Teleport, a following fren teleports to you when it falls far behind or gets stuck.
My fren didn't go home at sunset¶
Frens that are idle (not following you) or on an until-sunset job go home at sunset, and so do guards and patrols when that option is on. A job with a count keeps running. Where it goes depends on its beds and bases: see Bases and home.
How do I make a fren fast-travel?¶
Give it food and a lodestone compass bound to a lodestone. With those it fast-travels home at sunset, back to work at sunrise, with /bot compass travel, and for Storage Go and Collect. Without a compass, an Eye of Ender held by you or the fren still works for Storage trips. See Fast travel.
Can it go back to work by itself in the morning?¶
Yes, with a lodestone compass at the work spot. See Work loops.
It won't cut the trees near my house¶
That's deliberate. Frens don't cut trees inside any base (yours included), the spawn area, a protected zone, a mapped village, near a wall or by a bee nest. If those are the only trees nearby, the fren walks out to find others. See Protected zones.
How do I make frens quieter?¶
Bot Controls has separate switches for scripted text, scripted voice, Soul Chat and Soul Voice. See Keep Bots Quiet.
Can a friend use my frens?¶
A fren takes commands from its owner, an operator or the host. To let a friend command yours, make them an operator on the world, or have an operator give them the fren with /bot config owner. See Multiplayer and ownership.
Can I change how fast a fren walks?¶
No, there is no speed setting.
My fren died. What about its items?¶
With Auto Respawn on, it comes back right away. Its dropped items, or yours, can be fetched with Retrieve Drops while they still exist (about 5 minutes once the area is loaded).
Where are the settings?¶
In Bot Controls: open a fren's inventory and go to Admin, then Bot Controls, or run /configMan. See Bot Controls Panel.
Something went wrong. Where do I report it?¶
Open an issue on GitHub with your Frens version and what the fren was doing. The game log (logs/latest.log) helps a lot.
Why didn't my guard fren help me fight?¶
A guarding fren fights mobs that are after it. With only a sword it leaves a mob alone until the mob turns on it, even one chasing you. Give it a bow or crossbow and arrows and it attacks hostile mobs it can see within about 10 blocks. See Guard and patrol.