# GunBound Java Emulator: reconstructing Thor's Hammer servers

> GunBound Java Emulator recreates Broker, Game, and Buddy services for the Thor's Hammer versions of GunBound using Java and Netty. It documents the client protocol's packet framing, command opcodes, AES-based session encryption, and sequence checks, with handlers for authentication, lobbies, rooms, gameplay, and friends.

- Type: Case study
- Targets: Game · Protocol
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-08
- Added to the catalog: 2026-11-08
- Original resource: <https://github.com/kyll3r/GunBound-Java-Server>
- Primary source: <https://github.com/kyll3r/GunBound-Java-Server/blob/421930cf69be564727269bb8126f251df04bdce4/readme.md>
- Catalog page: <https://awesomerea.org/resources/gunbound-java-server-case/>
- Record JSON: <https://awesomerea.org/resources/gunbound-java-server-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/gunbound-java-server-case/index.md)

## Requirements & limits

- **Prerequisites:** GunBound Thor's Hammer client, specifically GIS v376 or GBS v404.
- **Prerequisites:** Java 21 and MariaDB or MySQL.
- **License:** MIT License.

## Primary sources

1. <https://github.com/kyll3r/GunBound-Java-Server/blob/421930cf69be564727269bb8126f251df04bdce4/readme.md>
2. <https://github.com/kyll3r/GunBound-Java-Server/blob/421930cf69be564727269bb8126f251df04bdce4/LICENSE.txt>

## More in Games

- [GunBound: a Swift server reconstruction of GunBound Classic](https://awesomerea.org/resources/gunbound-classic-server-case/index.md) · Case study
- [guzzler-disasm: a commented game disassembly](https://awesomerea.org/resources/guzzler-disasm-case/index.md) · Case study
- [Habbo: a Flash-client server emulator](https://awesomerea.org/resources/habbo-flash-server-case/index.md) · Case study
- [HamHamGamesDecomp: an early Hamtaro GBA disassembly](https://awesomerea.org/resources/hamhamgames-decomp-case/index.md) · Case study
- [Hamtaro in Pieces: an incomplete Game Boy Color disassembly](https://awesomerea.org/resources/hamtaro-in-pieces-case/index.md) · Case study
- [Harrier Attack: a SkoolKit ZX Spectrum disassembly](https://awesomerea.org/resources/harrier-attack-disassembly-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.