How leegunwoooo/nikke-api works
nikke-api is a Cloudflare-served REST and MCP API for NIKKE game data, story scripts, burst cutscenes, and BlablaLink account features. Users request REST resources or MCP tools; the Worker dispatches requests into the shared app, which reads normalized static data or queries BlablaLink for live account and leaderboard results. Supporting branches enrich cutscenes and expose API guidance. The README documents broad endpoint coverage, but sampled factory excerpts show only selected routes, so the graph avoids claims about unsampled route internals.
Main entry points: factory.ts Route Application · index.ts Cloudflare Worker · storage.ts Data Storage · burst.ts Cutscene Catalog
Components 20
API Runtime
- Cloudflare Worker
worker/index.ts - Route Application
src/factory.ts - Data Storage
src/storage.ts
Game Data
- Static Game Data
- CDN Data Sync
src/cdn.ts - Story Events
src/events.ts - Character Families
src/family.ts - Story Ordering
src/story-route.ts - Library Stories
scripts/library-stories.ts
Burst Cutscenes
- Cutscene Catalog
src/burst.ts - Playback Composer
src/burst-playback.ts - Cutscene Viewer
src/burst-viewer.ts - Spine Scene
viewer/burst-scene.ts - Spine Player
viewer/player.ts
API Interfaces
- MCP Tools
src/mcp.ts - OpenAPI Schema
src/openapi.ts - LLM Guides
src/llms.ts
External Data
- BlablaLink Client
src/blabla.ts
Other components
- API Consumer
- BlablaLink Service
Connections 20
- API Consumer → Cloudflare Worker: requests API
worker/index.ts - Cloudflare Worker → Route Application: dispatches to
worker/index.ts - Cloudflare Worker → Data Storage: configures
worker/index.ts - Route Application → Data Storage: reads data
src/factory.ts - Data Storage → Static Game Data: fetches files
src/storage.ts - Route Application → Story Events: groups scenes
src/factory.ts - Route Application → Character Families: builds families
src/factory.ts - Route Application → BlablaLink Client: queries service
src/factory.ts - BlablaLink Client → BlablaLink Service: calls API
- Route Application → Cutscene Catalog: enriches bursts
src/factory.ts - Cutscene Catalog → Playback Composer: composes tracks
src/burst.ts - Cutscene Viewer → Cutscene Catalog: loads cutscenes
src/burst-viewer.ts - Spine Player → Spine Scene: renders scene
viewer/player.ts - Spine Scene → Playback Composer: uses playback
- MCP Tools → Route Application: wraps routes
src/mcp.ts - Route Application → Story Ordering: serves story order
src/factory.ts - Route Application → Library Stories: serves library scripts
- Route Application → OpenAPI Schema: serves schema
src/factory.ts - Route Application → LLM Guides: serves guides
src/factory.ts - API Consumer → MCP Tools: uses tools