Bunnyland guides
Learn Bunnyland through playable command sequences.
These guides are rendered from the same Markdown kept with the Bunnyland server. Start with core actions, run your own game, generate worlds, then layer on needs, memory, incidents, and sim-package mechanics.
Player Guides
Start
Getting startedClaim a character, read rooms, move, carry items, and talk.
Running your own gameRun a private game, save it, generate a fresh world, and reconnect clients.
Core actionsUse core verbs to look, move, carry items, use objects, write, rest, and talk.
World actions, focus actions, and costsUnderstand world and focus actions, effort tiers, and point regeneration.
Movement and lookingRead room context, inspect reachable details, use exits, and understand movement.
Inventory and useTake, drop, hold, wear, place, unlock, and use reachable items.
Hunger and thirstRead hunger and thirst cues, then eat, drink, and use renewable sources.
Focus, notes, and memoriesRecord private notes, recall context, reflect, and forget deliberately.
Needs and memoryManage hunger, thirst, notes, recall, reflection, and forgetting.
Daily needsTrack daily meters for fatigue, hygiene, comfort, fun, social contact, privacy, and safety.
Testing
Clients
Client guidesChoose the TUI, REPL, or Toon client for your play style.
The Toon clientPlay visually with layered room sprites, doors, free movement, and an action menu.
The TUI clientPlay from a panel-based terminal with action search and queued actions.
The REPL clientPlay from a keyboard-first terminal with tab completion and clickable targets.
Systems
Sim Packages
Garden-sim farmingPrepare soil, plant, fertilize, water, harvest, and sell crops.
Garden-sim farm productionProduce food, use machines, tend animals, forage, gift, and finish bundles.
Garden-sim fishing and miningCatch seasonal fish, mine nodes, discover ladders, and open geodes.
Garden-sim animals and artisan machinesFeed, pet, breed, collect products, and repair artisan machines.
Garden-sim collections and shippingClaim mail, finish farm quests, ship goods, donate, and claim rewards.
Colony-sim work and ownershipReserve work, gather resources, craft, handle jobs, and claim property.
Colony-sim health and workManage priorities, allowed areas, room quality, medicine, recovery, and wealth.
Colony-sim research and tradeTrack pawn profiles, progress job bills, research tech, trade, and caravan.
Colony-sim prisoners, incidents, and surgerySet prisoner policy, recruit, resolve incidents, and manage surgery bills.
Barbarian-sim combat and survivalChallenge, fight, defend, repair, fortify, poison, cleanse, and survive.
Dragon-sim exploration and questsDiscover locations, complete quests, and work with factions.
Life-sim homes, work, and familyManage aspirations, skills, jobs, businesses, homes, rent, and family.
Life-sim routines and home objectsSet profile context, whims, home object routines, invitations, and aging.
Dagger-sim adventuring and institutionsFollow rumors, travel, join institutions, bank, cast spells, and delve dungeons.
Dagger-sim civic life and propertyEarn civic reputation, access services, manage banking, and buy deeds.
Void-sim ships and space travelRun ship systems, dock, refuel, scan, answer signals, orbit, land, and jump.
Void-sim contracts, fabrication, and salvageWork contracts, fabricate parts, manage cargo, salvage claims, and stand watches.
Dino-sim fossils, eggs, companions, and kaiju incidentsIdentify fossils, prepare clone eggs, hatch dinos, and handle kaiju incidents.
Dino-sim ranching, feed, and creature productsFeed dinos, reduce stress, collect eggs, harvest products, and assign ranch work.
Neon-sim cyberpunk cityCase districts, defeat surveillance, hack devices, and manage intrusion traces.
Neon-sim streets, cyberware, and fixersHandle heat, cyberware, debts, bounties, fixer jobs, and corporate intrigue.
Nuke-sim wasteland survivalSurvive radiation, scavenge ruins, decontaminate, scrap junk, and manage mutation.
Nuke-sim settlements and old-world techClaim settlements, salvage sites, purify water, run generators, and restore tech.
Add-ons
Bunnyland 3D clientPlay Bunnyland through the 3D client, claim a character, move, act, and capture scenes.
RL-controlled charactersUnderstand characters controlled by trained RL models and how to hand control back.
Influencing an autonomous character story with Bunnyland StudioClaim one autonomous main character, shape influences and memories, observe activity, and preserve meaningful moments.
Admin Guides
World Building
World building in BunnylandBuild a static setting, make it interactive, bring its characters to life, and expand it safely.
Premise, plot, and settingTurn plot ideas into playable situations, pressures, setting identity, and durable consequences.
Regions, rooms, and routesOrganize regions, rooms, routes, containment, signs, and recoverable navigation.
Characters and dramatic rolesCreate characters with dramatic roles, persona, motives, limited knowledge, and durable identity.
Items, clues, and environmental storytellingUse props, resources, mechanisms, clues, custody, and consumption to tell stories through objects.
Affordances, actions, and handlersConnect affordances to actions, handlers, authoritative state, useful failures, and visible results.
Quests, goals, and obligationsKeep character goals, accepted quests, requests, obligations, objectives, and rewards distinct.
Relationships, factions, and social pressureModel directed bonds, categorical ties, factions, social pressure, agency, and consequences.
Events, scripts, and consequencesUse typed events, scripts, consequences, and incidents without building brittle cut scenes.
Needs, time, schedules, and routinesMake world time, needs, schedules, routines, interruptions, and recurring life create choices.
Memories, knowledge, and beliefSeparate public truth from private memory, seed useful context, and design safe automatic recall.
Autonomous characters and LLM controllersPrepare autonomous characters to pursue goals, follow routines, recall context, and act lawfully.
Playtesting a living narrativePlaytest comprehension, causality, autonomy, recovery, persistence, and long-running world health.
World Management
Expanding an existing worldExpand from existing narrative pressure while preserving geography, knowledge, history, and health.
Editing live and saved worldsEdit saved snapshots and live worlds safely with catalogue-driven components and graph edges.
Reading the world graphRead map, region, social, quest, containment, component, controller, and event structures.
LLM-assisted world patchesGenerate bounded room, character, item, and event patches, then review and integrate them.
Generating worldsChoose a generator, provide a seed, watch progress, and replace a world.
Server Setup
Server setupPlan a community server from loopback-only first run through secure public operations.
Install and run your first serverInstall Bunnyland, prove the offline loop, start a loopback API, and save the first world.
Config wizardCreate, validate, and protect repeatable server and browser configuration files.
Authentication, permissions, and moderationProvision human and automation identities, least-privilege scopes, rotation, and moderation.
Hosting the web client securelyRun Bunnyland with systemd and a same-origin nginx proxy, TLS, WebSockets, and a firewall.
Worlds, plugins, persistence, and snapshotsChoose worlds and plugins, persist every state store, and take consistent snapshots.
LLM providers and character controllersConfigure model providers and assign LLM, behavioral, scripted, human, or idle controllers.
Discord botConnect Discord with protected credentials, inbound allowlists, claims, and moderators.
MCP server and local agentsEnable scoped Streamable HTTP MCP and connect local agent clients safely.
Image and video generationAdd private ComfyUI or explicit OpenRouter image generation with durable media storage.
Backups, upgrades, observability, and recoveryEncrypt and restore backups, upgrade server and web together, observe, and roll back.
Web UI
Add-ons
Bunnyland 3D administrationInstall the 3D add-on, load its server plugin, deploy its web client, and inspect rooms.
Bunnyland RL administrationInstall the RL add-on, run offline training jobs, assign models, and review artifacts.
Hosting and administering Bunnyland StudioInstall Studio, secure influence claims, configure example story packs and media, and verify persistence.