MikuSB

MikuSB is a server emulator of a certain dungeon anime game.
SdkServer, GameServer, and an optional local HTTP/HTTPS proxy are started from a single net9.0 application.

Discord

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

Scam Warning

MikuSB is completely free and open source. If anyone sold you this server or charged money to provide it, that was a scam. Request a refund immediately and report the seller to us on Discord with any relevant proof or purchase details.

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 10.0

Running

1. Restore dependencies and build.

dotnet build

2. Set GamePath in Config.json to the path of your game executable.
3. Start the server and run the game command.
4. Create an account in the server console.
5. 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

Contributors

• Naruse
• Kei-Luna

License

This repository is licensed under the MIT License.

Notes on use

This software is intended for research and testing purposes in a local environment.
It is not intended for unauthorized access to, interference with, or commercial use of official services.

Legal Disclaimer

MikuSB was developed for educational and research purposes.
- All trademarks, copyrights, and other intellectual property related to the original game and its associated franchise belong to their respective owners.
- This repository does not include any copyrighted game assets, binaries, or master data.
- Use this software at your own risk. The authors assume no responsibility for any damages or legal consequences resulting from its use.

If you are a rights holder and have any concerns regarding this software, please contact devilpromt or kei_luna_re on Discord.