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 にあります。

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

• Login and basic account entry
• Player data loading
• Inventory loading
• Character loading
• Skin loading
• Weapon loading
• Lobby display character switching
• Character skin switching
• Character skin form switching
• Weapon replacement
• Weapon upgrade
• Player rename
• 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

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 on Discord.