# swemu: reconstructing a SoulWorker server from client packet readers

> swemu reconstructs a server for the SoulWorker GB/Steam 2.3.34.7 game client in Rust. Its research log reports REA/Ghidra decompilation and Unicorn execution of client routines to recover packet layouts, encryption, and exchanges used for login, characters, world entry, and early combat.

- Type: Case study
- Targets: Game · Protocol
- Category: Community REA investigations
- Relationship: Author-reported mixed workflow
- Sources reviewed: 2026-11-07
- Added to the catalog: 2026-11-09
- Original resource: <https://github.com/BocchiV/swemu>
- Primary source: <https://github.com/BocchiV/swemu/blob/268a167d8d89a4f669d65a58d42f558731608d54/README.md>
- Catalog page: <https://awesomerea.org/resources/swemu-case/>
- Record JSON: <https://awesomerea.org/resources/swemu-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/swemu-case/index.md)

## Requirements & limits

- **Prerequisites:** Provide your own SoulWorker 2.3.34.7 client for generated tables and testing.
- **Prerequisites:** The server uses stable Rust edition 2024; research tools require Python 3.12 and documented Python packages.
- **Prerequisites:** Some game data requires separate server-side tables; fallbacks are used where possible.
- **Limits:** Combat is buggy and quests, parties, friends, guilds, and PvP are missing.
- **License:** AGPL-3.0 license.

## Primary sources

1. <https://github.com/BocchiV/swemu/blob/268a167d8d89a4f669d65a58d42f558731608d54/README.md>
2. <https://github.com/BocchiV/swemu/blob/268a167d8d89a4f669d65a58d42f558731608d54/docs/re-log.md>

## More in Games

- [SWGEmu Core3: reconstructing the classic Star Wars Galaxies server](https://awesomerea.org/resources/swgemu-core3-case/index.md) · Case study
- [Tales of Eternia: structural analysis of the Japanese PlayStation disc](https://awesomerea.org/resources/ps1-talesofeternia-doc-case/index.md) · Case study
- [TamagoC: a Tamagotchi implementation from observation](https://awesomerea.org/resources/tamagoc-case/index.md) · Case study
- [Tamagotchi P1 for FPGAs: reconstructing the handheld hardware](https://awesomerea.org/resources/fpga-tamagotchi-p1-case/index.md) · Case study
- [Tekken 3 Recompiled: hybrid recompilation and native port research](https://awesomerea.org/resources/tekken3recompiled-case/index.md) · Case study
- [TF15-Client: rebuilding the Team Fortress Classic client](https://awesomerea.org/resources/tf15-client-case/index.md) · Case study

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.