# 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](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](MikuSB): entry point
- [SdkServer](SdkServer): HTTP server and dispatch
- [GameServer](GameServer): main game server
- [Proxy](Proxy): local proxy
- [Common](Common): config, database, and shared utilities
- [Proto](Proto): protobuf definitions

## Requirements

- .NET SDK 9.0

## Running

1. Restore dependencies and build.

```powershell
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

**Legend:** `[x]` - Implemented, `[✓]` - Partially Implemented, `[ ]` - Not Started