No description
  • TypeScript 94.4%
  • C++ 1.4%
  • Python 1.3%
  • CSS 1.2%
  • JavaScript 0.5%
  • Other 1.1%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Xmarchy 28198f3bbe feat(mcp): add stdio MCP server for play.piovium.org
Add packages/mcp (@gi-tcg/mcp), a local stdio Model Context Protocol
server that lets an LLM play Genius Invokation TCG on play.piovium.org.

- 18 tools covering room lifecycle (create/join/list/restore/leave) and
  the game loop (wait_for_request/get_pending_request/get_game_state,
  submit_action, choose_active_character, reroll_dice, switch_hands,
  select_card, get_definition_info, get_game_log)
- guest sessions with persisted tokens and restore_session on restart
- responses validated client-side (dice pool, cost, energy, legend)
- board/action rendering and mutation summaries for model consumption
- live end-to-end script (scripts/e2e.ts) that plays a full game
- build with @modelcontextprotocol/server v2 (MCP 2026-07-28)

Lockfile: add @modelcontextprotocol/server, @modelcontextprotocol/core
and zod 4.6.1 for the new workspace package.
2026-09-12 04:03:14 +08:00
.github feat(core/gts/typings): Literal HandleT (#930) 2026-09-03 19:09:54 +08:00
docs refactor(core): Variable Range (#954) 2026-09-08 23:51:34 +08:00
packages feat(mcp): add stdio MCP server for play.piovium.org 2026-09-12 04:03:14 +08:00
patches refactor(core, data): Remove legacy features (#820) 2026-07-29 00:27:59 +08:00
proto refactor(core, web-ui): Dice-based legend (#880) 2026-08-14 14:36:25 +08:00
scripts chore(*): Remove Bun. (#718) 2026-05-14 01:02:51 +08:00
.dockerignore feat(server): onboard railway (#554) 2025-10-14 16:34:14 +08:00
.editorconfig Python Build CI improvement (#19) 2024-12-11 14:01:43 +08:00
.gitignore fix(data,web-ui-core): hintText fixing (#271) 2025-05-26 22:24:04 +08:00
buf.gen.yaml fix(typing): adjust typing to prepare a more useful frontend (#122) 2025-02-02 16:48:39 +08:00
buf.yaml move proto files to the root directory 2024-11-28 00:16:55 +08:00
CHANGELOG.md chore(release): 0.20.0 2026-05-15 17:36:14 +08:00
LICENSE add license 2024-02-17 21:23:05 +08:00
mise.toml chore(deps): upgrade pnpm to 12.0.0 (#909) 2026-08-27 20:00:07 +08:00
opencode.jsonc feat(mcp): add stdio MCP server for play.piovium.org 2026-09-12 04:03:14 +08:00
package.json chore(deps): upgrade pnpm to 12.0.0 (#909) 2026-08-27 20:00:07 +08:00
pnpm-lock.yaml feat(mcp): add stdio MCP server for play.piovium.org 2026-09-12 04:03:14 +08:00
pnpm-workspace.yaml chore(core): We can have more typings... (#961) 2026-09-11 09:00:01 +08:00
prettier.config.ts chore: prettier plugin for gts (#792) 2026-07-17 15:39:33 +08:00
README.en.md fix(docs): revert back discord server link 2026-06-27 21:01:13 +08:00
README.jp.md chore: update README server credits (#755) 2026-06-14 18:58:53 +08:00
README.md docs(README): remove DeepWiki (outdated) 2026-09-04 13:34:56 +08:00
tsconfig.json chore(*): Remove Bun. (#718) 2026-05-14 01:02:51 +08:00
tsconfig.vitest.json chore(test): Correctly configure vitest checktype (#951) 2026-09-06 22:41:25 +08:00
vitest.config.ts chore(test): Correctly configure vitest checktype (#951) 2026-09-06 22:41:25 +08:00
vitest.setup.ts chore(*): Remove Bun. (#718) 2026-05-14 01:02:51 +08:00

Genius Invokation TCG Simulator

中文版 | English Version | 日本語版

Sample deployments are available at following links: https://standalone.piovium.org

Features of This Project

  • Fully open source (main body uses AGPLv3.0 or later)
  • The core implementations try to be the closest to the official rules
  • Full card definitions as of Version of Genshin Impact
    • Definition format is concise and easy to read
    • Easy maintenance
  • Definition of all old version cards (before balance adjustments)
    • Supports self-selected game version to start the game
  • Front-end Features:
    • Game visualization and local simulation
    • Historical retrospective (replay) and mid-game continuation
    • Game import and export
    • View detailed settlement logs
  • Battle Platform (In public beta)
  • Cross Programming Language Support
  • Sneak peeks at the beta cards
  • Currently there are still a lot of bugs, need more testing

About Development

The above link provides access to (possibly outdated) development documentation and notes.

If you are interested in our project or want to have more information, welcome to join our Discord server.

All English content should refer to the Chinese content.