How shenjai47/ninjasaga works
This repository is an offline Ninja Saga Flash private server: the player requests game content through a local HTTPS gateway, which routes AMF calls to reconstructed handlers and serves local SWFs. Missing SWFs can be cloned from donors or answered with stubs. Character state and extracted game tables support server responses, while separate bytecode patchers modify client SWFs. The main routing and fallback relationships are documented in the README; source excerpts show codec, state, data, clone, and stub responsibilities, but do not expose all handler calls.
Main entry points: index.js Node Gateway · chardata.js Character State · latest Local SWF Assets · library Client SWFs
Components 15
Local Gateway
- Caddy HTTPS
- Node Gateway
server/index.js - AMF Codec
server/amf.js
Game Responses
- AMF Handlers
server/index.js - Character State
server/chardata.js - Character Records
server/characters.json - Game Data Tables
server
Asset Serving
- Local SWF Assets
web/cdn/swf/latest - Missing Asset Fallback
server/index.js - SWF Cloner
server/assetclone.js - SWF Stub
server/stub.js
Client Patches
- SWF Patch Tools
server - Library Patchers
web/cdn/swf/latest/swf/library - Client SWFs
web/cdn/swf/latest/swf/library
Other components
- Flash Player
Connections 14
- Flash Player → Caddy HTTPS: requests HTTPS
README.md - Caddy HTTPS → Node Gateway: reverse proxies
README.md - Node Gateway → AMF Codec: decodes AMF
server/index.js - Node Gateway → AMF Handlers: dispatches POST
README.md - Node Gateway → Local SWF Assets: serves GET
README.md - AMF Handlers → Character State: uses character data
server/index.js - Character State → Character Records: persists state
- AMF Handlers → Game Data Tables: uses game tables
server/index.js - Node Gateway → Missing Asset Fallback: handles missing SWF
README.md - Missing Asset Fallback → SWF Cloner: clones donor
server/index.js - Missing Asset Fallback → SWF Stub: creates fallback
server/index.js - Missing Asset Fallback → Local SWF Assets: scans donors
server/index.js - SWF Patch Tools → Client SWFs: patches bytecode
README.md - Library Patchers → Client SWFs: patches library SWF
web/cdn/swf/latest/swf/library/patch_ns_swf.py