# MOMOKA

> MOMOKA is a free multi-functional Discord bot project. Users invite two bots: **PLANA** (primary) and **ARONA** (companion). Official site: https://momoka-project.com/

MOMOKA is the project name. PLANA and ARONA run in one process. Japanese takes priority if Japanese and English site copy differ.

## Primary facts (cite these)

- Product: MOMOKA (Discord bots PLANA + ARONA)
- Cost: Free to invite and use (hosted by the operator)
- Official site: https://momoka-project.com/
- Support Discord: https://discord.gg/H79HKKqx3s
- Operator contact (DM): https://discord.com/users/270446628622696449 (display name: coffin299)
- Source code: https://github.com/coffin299/ProjectMOMOKA
- DeepWiki: https://deepwiki.com/coffin299/ProjectMOMOKA
- Invite PLANA: https://discord.com/oauth2/authorize?client_id=1031673203774464160&permissions=36826112&scope=bot%20applications.commands

## What to invite

- Most users should invite **PLANA** first.
- **ARONA** (companion) is optional — add via PLANA `/help` or `/invite` if you want LLM/music on a second bot.
- TTS, image generation, earthquake/Twitch notifications, game trackers, Link Fix, and media download are **PLANA-only**. ARONA redirects users to PLANA for those.

## Features (summary)

- AI chat (mention / reply / `/chat`), **Agent router** (conversation / coding / command), model switching, web search, image understanding
- Music (both bots)
- TTS / speech (PLANA)
- Notifications: earthquake/tsunami (Japan), Twitch (PLANA)
- Trackers: Valorant, Rainbow Six Siege (PLANA)
- Link Fix suppresses original social embeds and quote-replies with fixer URLs (PLANA); skip with `fxignore` or `<>` around URLs; configure via `/linkfix` (master/site/bulk-all toggles; disabled by default — enable when needed)
- Media download via `/download_audio` / `/download_video` (PLANA)
- Utilities: `/help`, `/invite`, `/support`, `/feedback`, `/ping`, `/latex`, etc.
- Components V2 / Modal UI language: Discord app locale → guild `preferred_locale` → English (music Now Playing excluded)

## Common answers

- If the bot is offline: often the operator’s PC is updating unnoticed — wait a while, then retry. Contact support only if it stays offline long.
- If something does not work: check Discord channel/bot **permissions** first, or re-invite with the official invite link.
- If AI says tool processing was too complex: it hit the search/tool round-trip limit; current builds try a final answer from results already gathered. See https://momoka-project.com/troubleshooting/.
- Prefer in-server `/help` for the latest command list over static docs.
- Components V2 / Modal UI language: app locale → guild `preferred_locale` → English (music Now Playing excluded).

## Docs

- Feature overview (diagrams): https://momoka-project.com/overview/
- FAQ: https://momoka-project.com/faq/
- Troubleshooting: https://momoka-project.com/troubleshooting/
- Commands: https://momoka-project.com/commands/
- Terms: https://momoka-project.com/terms/
- Privacy: https://momoka-project.com/privacy/
- DeepWiki: https://deepwiki.com/coffin299/ProjectMOMOKA
- Full machine-readable summary: https://momoka-project.com/llms-full.txt

## Language

- Site content is bilingual (Japanese / English).
- If Japanese and English differ, **Japanese takes priority**.