Frens wiki¶
Frens adds companions ("frens") to Minecraft Java: full fake players that follow you, gather, farm, mine, build and defend, with their own inventory and stats. Everything works with no AI model. Talking back in their own words (Souls, through a local Ollama model) is optional.
Download: Modrinth. Source and issues: GitHub.
Pages¶
- Getting started: install, pick a world mode, spawn your first fren.
- FAQ: common questions and fixes.
- Work loops: frens that go back to the same job every morning.
- Fast travel: what lets a fren skip the walk, how long it takes and what it costs.
- Bases and home: bases, beds and the preferred home, and where a fren goes at sunset.
- Protected zones: where frens won't break blocks or gather, and why.
- Storage and chests: putting items in chests and taking them out, and when frens ask before taking your supplies.
- Guard and patrol: guard, patrol and stay, what a fren fights, and how the orders end.
- Farming: building a farm, planting and harvesting, and where the crops go.
- Hunting and cooking: starting a hunt, what frens won't hunt, loot, how a hunt ends and cooking.
- Fortifying a village: the wall, towers, gate and moat, materials, and looking after a saved wall.
- Talking with frens (AI chat): setting up Ollama and Soul Chat, talking to frens, memory and what to do when they don't answer.
- Multiplayer and ownership: owners, operators and the host, sharing bases and walls, and dedicated servers.
- Spells: every spell, what unlocks it and what it costs, and the Wizard's Tome.
- In-game Guide: every card from the Guide screen (press ] in game), grouped by topic.
- Companion questing guide: how recruiting works in Questing mode.
- Crafting cheatsheet
- README: install and requirements.
How these pages are made¶
The Guide*.md pages are generated from src/main/resources/assets/frens/guide/topics.json, the same file the in-game Guide reads, so the two always match. To change a Guide card, edit that file, run ./gradlew wikiExport, and commit both. GuideWikiExportTest fails if they differ.
Pages without the Guide prefix, like this one, are written by hand.
The site at https://wcfcarolina13.github.io/Frens/ is built from these files by .github/workflows/wiki-pages.yml on each push to main (mkdocs.yml holds the navigation). A new page needs a line in that file's nav.