KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #dsh #dsh-plugin #ai-agent #claude-code #codex #typescript #ai-agents #mcp #cli #rust #deepseek-harness

mgsv_emulator

★ 36 Open GitHub ↗

mgsv client/server emulator

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# You are looking for [fuse](https://github.com/unknown321/fuse)

### mgsv_emulator

this is an unfinished mgsv client/server emulator. This repo has been abandoned, but you can still ask questions.

You should take a look at:

- https://github.com/mxmstr/NucleusGameFixes
  - https://github.com/mxmstr/mgsv_emulator
  - https://github.com/alicealys/tpp-server-emulator

if you are looking for working implementations.

Code in master is clunky and hard to extend, v2 branch looks a little better.

Look for `*.bin` files if you need encryption keys.

Types of encryption implemented: COMMON, COMPOUND.

## Requirements

Python 3, Percona Server 5.7 (or some alternative with json support), Apache 2 + mod_wsgi or something that can handle python wsgi scripts

## Encryption details
Every message between server and client is encrypted using blowfish algorythm.
Unfortunately it slightly differs from realisation provided here (https://www.schneier.com/academic/blowfish/download.html), so I had to rewrite it from scratch.

Decryption process:

* decode base64-encoded message into bytestream
 * decode bytestream using static blowfish key (hardcoded into exe) into json message
 * message['data'] is usually base64-decoded message
 * if 'session_crypto' is true, then contents of message['data'] are encrypted with blowfish using session cryptokey provided by server during auth phase
 * if 'compress' is true, then decoded message['data'] is also compressed using zlib

Message with compression and encryption:

base64 (
        blowfish_static (
            base64 (
                blowfish_session (
                    zlib('test')
                )
            )
        )

Encryption process is the same, but backwards.

## How to use
Provide your credentials in settings.py (steamid and magic_hash parsed from previously captured session). Steam_ticket is not required.

Client:

from emulator import Client
    c = Client()
    c.login()

login() will automatically parse requests and save session cryptokey (so you won't have to manually use it every time).
Afterwards, feel free to call any command available, see https://github.com/unknown321/mgsv_nuke_watcher as an example.

## Server status:

Done:
 * CMD_GET_URLLIST
 * CMD_GET_SVRLIST
 * CMD_GET_INFORMATIONLIST - Online messages that pop up after logging in
 * CMD_GET_FOB_STATUS - Your win-lose records for attack and defense
 * CMD_GET_SVRTIME - speaks for itself
 * CMD_GET_CHALLENGE_TASK_TARGET_VALUES - FOB and PF records

Todo list:

* Login procedure, which includes generation of crypto keys, session id, etc (CMD_AUTH_STEAMTICKET, CMD_REQAUTH_HTTPS). Note: a new steam ticket is issued every time you connect to server.
 * Player list stuff (CMD_GET_PLAYERLIST, CMD_SET_PLAYERLIST)
 * Challenge task rewards (414 tasks from konami)
 * Login params (CMD_GET_LOGIN_PARAM), which includes cluster_build_costs, fob_event_task_list, online_challenge_task, server_product_params, server_texts and staff_rank_bonus_rates.
 * Figure out parameters sent by client in CMD_SEND_BOOT
 * Figure out parameters sent by client in CMD_SYNC_MOTHER_BASE
 * CMD_SYNC_RESOURCE - order of parameters is unknown
 * CMD_SYNC_SOLDIER_BIN - figure out how to decode list of soldiers, there was some info on cheatengine forums
 * CMD_GET_OWN_FOB_LIST - parameters construct_param and mother_base_id look weird 
 * CMD_MINING_RESOURCE - break_time parameter?

Low-priority:

* CMD_GET_COMBAT_DEPLOY_RESULT - need to send troops and parse the response first
 * CMD_GET_ONLINE_PRISON_LIST - same as above

CMD_GET_URLLIST
    CMD_GET_SVRLIST
    CMD_GET_SVRTIME
    CMD_AUTH_STEAMTICKET
    CMD_REQAUTH_HTTPS
    CMD_SEND_IPANDPORT
    CMD_GET_PLAYERLIST
    CMD_SET_CURRENTPLAYER
    CMD_GET_ABOLITION_COUNT
    CMD_GET_CHALLENGE_TASK_REWARDS
    CMD_GET_LOGIN_PARAM
    CMD_GET_INFORMATIONLIST
    CMD_SEND_BOOT
    CMD_GET_COMBAT_DEPLOY_RESULT
    CMD_GET_SERVER_ITEM_LIST
    CMD_SYNC_MOTHER_BASE
    CMD_SYNC_RESOURCE
    CMD_SYNC_SOLDIER_BIN
    CMD_GET_FOB_STATUS
    CMD_GET_ONLINE_PRISON_LIST
    CMD_GET_OWN_FOB_LIST
    CMD_MINING_RESOURCE
    CMD_GET_SVRTIME
    CMD_GET_CHALLENGE_TASK_TARGET_VALUES

completely unrelated - konami uses svn and rarely updates their webserver

mgsv_emulator

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README