In-game Guide¶
Every card from the Guide screen in game (press ] by default). <bot> stands for your fren's name.
Basics¶
- Set up AI companions: Optional: let companions talk back in their own words. Frens works fully without it.
- Talk to Nearby Bots (Group Chat): Start chat with Bots or All bots instead of naming each companion.
- Stop: Immediately cancels whatever the bot is doing.
- Stand Down: Bot pauses follow + drop-sweep for 60s, then auto-resumes follow.
- Resume: Resumes a paused pending task when available.
- Switch Active Bot (Inventory): Cycle to another companion from the inventory UI without retyping commands.
- Bot Controls Panel: Configure spawn behavior and per-bot preferences in one place.
- Fast-Travel Gates: Which items/conditions let the bot fast-travel, and at what speed.
- Home & Bases Explained: Two kinds of rows in the Base Manager, and two meanings of [Home].
Spawning¶
- Auto Spawn on Load: Controls whether a bot automatically returns when you re-enter the world.
- Auto Respawn: Controls what happens when a bot dies.
- Bot Roster (Spawn Bots…): Multi-select screen for (re)spawning bots and creating new ones.
- Bulk Apply (All Bots): One-click reset buttons that set a spawning flag for every bot in this world.
- No-Companions HUD Hint: The on-screen notice that appears when no bots are currently in the world.
Admin¶
- World Mode Reset: Admin command to re-trigger the world mode selection (Questing vs Admin) welcome screen.
- Learning Mode (Admin): Operator-only demonstration capture used to record player examples for later bot-control tuning.
Movement¶
- Follow: Keeps the bot near you while you travel.
- Regroup: Calls the companion back toward you using the safer regroup behavior.
- Return Home: Sends the bot back to its saved home/base anchor.
- Guard & Patrol: Keeps the bot at a spot, guarding it, patrolling around it or staying put.
Settings¶
- Keep Bots Quiet: Turn down what bots say, in text or out loud.
- Let a Friend Use Bots: Who can command a bot on a shared world.
- Follow Teleport: Wolf-style catch-up teleport during follow mode.
- Fast Travel & Navigation Tiers: Companion fast travel speed depends on held artifacts.
- Preserve Expensive Gear: Keep your bots from wearing out your best tools.
Gathering¶
- Cleanup (Drop Sweep): Collects nearby dropped items quickly.
- Retrieve Drops: Sends the bot to where you or another bot last died to pick up the items, then it comes back to you.
- Fishing: Fish until sunset or a chosen catch count.
- Forget Fishing Spot: Clears the bot's saved fishing stand so it picks a fresh spot next time.
- Woodcut: Fells nearby trees. Defaults to 'Until sunset' mode. Use +/- to set a specific tree count.
- Daily Work Loops (Lodestone Compass): Send a fren to a far work spot that it returns to every morning: home at sunset, back to work at sunrise.
- Wool: Shears sheep and gathers wool.
- Leaf Litter: Collects leaf litter from the ground for cheap furnace fuel.
Farming¶
- Build Farm: Builds a watered square farm and plants it.
- Plant Seeds: Plants seeds on empty farmland nearby.
- Harvest Crops: Harvests ripe wheat, beetroot, carrots and potatoes, and replants them.
Mining¶
- Collect Dirt: Collects dirt-like blocks for scaffolding and builds.
- Stripmine: Mines a straight tunnel for ores and stone resources.
- Ascent: Climbs upward by a block count or until surface sky.
- Descent: Digs downward by a selected block count.
Construction¶
- Fortify Village: Builds a stone wall with corner towers and a gate around a village.
- Map Village: Saves the nearby settlement as a shared remembered no-go zone without building a wall.
Modes¶
- Quest Mode: Layman progression path: recruit first, then unlock more capabilities.
- Delegate Mode Setup: Admins can permit specific non-operator players to choose world mode.
- Direct Mode: Spawn/use bots with broad capabilities immediately.
Roadmap¶
- Roadmap (High-Level): High-level summary of what already exists, what is being polished now, and what optional AI work is planned next.
Items¶
- Wizard's Tome: A rare magical item that unlocks the companion movement spells from anywhere.
- Navigation Artifacts: Give your companion a Compass, Map, or Eye of Ender to unlock autonomous navigation.
- Spell Ingredients: Quick reference for all spell-related items and what they unlock.
Shortcuts¶
- Command + Keybind Cheatsheet: Quick reference for the most-used controls.
Spells¶
- Remote Guidance: Uses paired ender pearls to guide your companion across any distance.
- Chorus Recall: Consumes paired ender pearls and chorus fruit for an instant teleport.
Core Actions¶
- Quick Store & Quick Fetch: Point at a nearby chest and click to deposit or take items.
Utilities¶
- Hunting: Hunts animals for food and leather, or zombies when well armed, then cooks the meat.
- Storage: View and manage supply chests your companions have placed in the world.
- Protected Zones: Mark areas where bots cannot break blocks.
Enchanting¶
- Bot Enchanting: Enchant your companion's items using the bot's XP and lapis.
- Bot Anvil: Repair, rename, or combine your companion's items using the bot's XP.