MikuSB/README.md

MikuSB

Snowbreak: Containment Zone private server reimplementation written in C#.
SdkServer, GameServer, and an optional local HTTP/HTTPS proxy are started from a single net9.0 application.

日本語のドキュメントは README_jp.md にあります。

Overview

• SdkServer
  • Serves HTTP APIs and dispatch responses
  • Returns server lists, version queries, and fallback responses
• GameServer
  • Accepts TCP-based game connections
  • Handles ReqCallGS and some normal packets
• Proxy
  • Listens on 127.0.0.1:8888 when enabled
  • Redirects some Snowbreak-related domains to the local SdkServer
• Common / Proto / TcpSharp
  • Shared data, protobuf definitions, and networking infrastructure

Project Layout

• MikuSB: entry point
• SdkServer: HTTP server and dispatch
• GameServer: main game server
• Proxy: local proxy
• Common: config, database, and shared utilities
• Proto: protobuf definitions

Requirements

• .NET SDK 9.0

Running

1. Restore dependencies and build.

dotnet build

2. Enjoy.

Feature List

• [x] Login and basic account entry
• [x] Player data loading
• [x] Inventory loading
• [x] Character loading
• [x] Skin loading
• [x] Weapon loading
• [x] Lobby display character switching
• [x] Character skin switching
• [x] Character skin form switching
• [x] Weapon replacement
• [x] Weapon upgrade
• [x] Player rename
• [x] Basic saving of currently supported lobby state
• [✓] Main chapter stage entry and related flow
• [✓] Daily stage entry and related flow
• [✓] Basic player setting synchronization
• [✓] Basic profile synchronization
• [✓] Activity-related requests
• [✓] Achievement-related requests
• [✓] Lineup-related requests
• [✓] Preview-related requests
• [✓] Some shop-related requests
• [ ] Full combat flow
• [ ] Mission / quest progression
• [ ] Gacha / recruitment systems
• [ ] Complete shop behavior
• [ ] Multiplayer systems
• [ ] Base / dorm systems
• [ ] Full client API coverage