Chaya
Chaya is a local-first toolkit for RPG Maker games: translation (extract, seed, live / subtitle), in-game edits (gold, items, variables, actors), and a shared NW.js shell for launch — with the same console and in-game plugins.
Console editions (the in-game layer is plugin):
| Mode | How | Disk access |
|---|
| Local | Node next to your game folders | Full (bind, shell, plugins, cache) |
| Toolkit App | Electron + Next (CHAYA_SERVICE=app) | Full |
| Cloud | Vercel / browser (VERCEL=1 or CHAYA_SERVICE=remote) | No server disk — prepare games in Chrome via the File System Access API |
Inspired by the MagickMonkey / vercel-web-scripts layout: Next.js UI + plugins/ game scripts.
Features
- Game Library — Centralized multi-title management; track NW.js shell, plugins, window settings, and saves at a glance.
- Comprehensive Translation Pipeline — Full-script extraction, bidirectional alignment, dialogue placeholder restoration, shared SQLite translation cache, and in-game real-time / subtitle overlays.
- macOS Apple Native Offline Neural Translation — Direct integration with macOS 15+ Translation Framework accelerated by Apple Neural Engine (ANE); zero network latency, zero bandwidth consumption, and privacy-first on-device fallback.
- Game Locales Detection & Corpus Feedback — Automatic detection of in-game
locales/ multi-language structures, bidirectional corpus matrix ingestion, and atomic file updates with safe .bak backups.
- Model Context Protocol (MCP) & AI Agent Integration — 50+ built-in MCP tools and 15+ WebMCP endpoints allowing Claude, Cursor, Codex, Windsurf, and other LLM agents to inspect maps, events, battle data, and control games programmatically.
- Cross-Platform AI Translation via CPA & ChatGPT — Seamlessly leverage your existing ChatGPT subscription through CPA (CLIProxyAPI) to enable high-quality LLM translation across macOS, Windows, and Linux without per-token API fees.
- In-Game Modifications — Live editing of gold, inventory items, switches, variables, actors, and party stats; bidirectional sync between console workbench and in-game floating overlay.
- 10 Core Languages Localization — Complete internationalization across the web console, MCP tool catalog, skill documentation, and in-game overlay for English, Simplified Chinese, Traditional Chinese, Japanese, Korean, French, German, Spanish, Russian, and Brazilian Portuguese.
- 100% Local-First Data — Translations, caches, and workbench settings stay strictly on your local machine.
AI Translation & Ecosystem Integration
Chaya provides a multi-tier translation hierarchy that balances zero-latency local fallback with deep literary context:
- Offline Translation — macOS Apple Translation Framework and an optional Bergamot daemon for Linux/macOS. Bergamot requires a native build and a compatible language pack; see the setup guide.
- ChatGPT via CPA Integration — By pairing Chaya with CPA (CLIProxyAPI) (Official Docs), you can bridge your personal or workspace ChatGPT (Plus / Team / Pro / Codex) subscriptions as unified OpenAI-compatible endpoints. This unlocks high-quality script translation and nuance polishing across macOS, Windows, Linux, and remote setups without recurring per-token API costs.
- OpenAI & DeepSeek Direct APIs — Direct support for DeepSeek, OpenAI, Claude, and local Ollama model providers.
Deploy to Vercel (Cloud)
On Vercel, VERCEL=1 uses Cloud (CHAYA_SERVICE=remote): the marketing / console UI is served from the cloud; installing shells and writing into game trees happens in the browser (Chromium + directory picker), not on the server.
- Import DavidKk/chaya into Vercel (or use the button above).
- Framework preset: Next.js. Build command:
pnpm build (runs build:plugins then next build).
- Deploy. Open the deployment URL —
/ shows the product page; Open console goes to /game.
- Use Chrome / Microsoft Edge on the client machine to grant folder access and prepare games.
Optional local simulation of cloud (no Vercel account): run pnpm dev and pick Cloud in the dev switcher (top right); DiskOps APIs return 501.
Cloud has no sign-in and no server-side MCP. External agents connect to the unified MCP address http://127.0.0.1:39271/mcp, served by the open game (or the local server) — see docs/mcp-plugin.md and docs/mcp-remote.md.
Build the app
Desktop toolkit shell (Electron) + Next in app mode:
This is the beginning of the README. Read the rest at the original. Read the full README ↗
