From download and installation to gameplay, from Virtual Phone to memory system — step-by-step guides to bring them home
New to KOA? Follow these three guides in order and you'll be all set
A complete walkthrough: install the launcher, activate, configure your API, create a character, and say your first words to them in Minecraft.
What APIs and keys are, how to sign up with different providers and get your key, how to choose a model, and how to troubleshoot errors.
How to write vivid profiles for "Myself" and "My Lover": character card fields explained, the setup wizard, world book imports, and skin uploads.
One guide per game, from zero to running: prerequisites, mod installation, and in-game interactions
Setting up NeoForge, one-click mod install, changing their skin, plus chatting, inventory, commands, and everything they can do.
Mod installation and in-world setup, chat and voice call, inventory and feeding, plus gathering, combat, crafting, expeditions, and character abilities.
SMAPI setup and one-click mod install, farming, fishing, mining, and petting animals, plus three ways to customize their look and the official sprite spec for artists.
KOA will continue to support more game worlds. Tutorials will be added here as soon as new modules are released.
Even after you close the game, they're still here — Virtual Phone, Offline Scenes, and special modes
Texting, phone calls, Watch Together, social feed, couple diary, calendar, playlists, tarot, literature... and more apps in development.
Immersive text-based companionship: adjusting length, perspective, and language preferences, what side dishes and the toybox are, and how "Return Home" bridges the narrative.
They watch you from a place you can't see, writing their heart out on a forum you'll never find — a heartbreaking meta experience that breaks the fourth wall.
Be pen pals who can never meet, on opposite sides of a dimensional rift — sending letters through the mist, carrying longing in every stroke of the pen.
Open app.koasystem.com on your phone to use KOA anywhere. Before your first use, log in on your PC, bind your email, and enable cloud sync — only then can the mobile app pull your data. We recommend adding it to your home screen for a native app-like experience.
Fine-tune your experience: memory, voice, and data safety
How the AI reads your character settings, why longer doesn't mean better, writing principles for character cards and memory entries, and why regular updates matter.
How their memories form: conversation extraction, in-game event logging and confirmation, storybook entry editing, and cross-world memory.
Speech recognition trigger modes and language selection, Edge / MiniMax / OpenAI-compatible / GPT-SoVITS local TTS configuration, and bilingual mode.
Backup and restore, how to use the log page properly, exporting diagnostic packages for feedback, and the auto-update mechanism.
Local reverse proxies and local models on your PC, available on mobile anywhere — how the secure cloud tunnel works, setup on both ends, and troubleshooting.
The Help Center has common questions and troubleshooting organized in Q&A format, with keyword search.