# LunarCore: reimplementing a Star Rail 4.2.0 game server

> LunarCore is a Java reimplementation of the Star Rail game server for a 4.2.0 client. ./gradlew jar builds LunarCore.jar, and java -jar LunarCore.jar starts it. The resources directory needs the Config, TextMap, and ExcelBin folders from the StarRailData set. Java 21 is required. The server can use its built-in database, and the README also recommends MongoDB 4.0 or newer. Login, teams, inventory, monster battles, shops, gacha, mail, Forgotten Hall, Pure Fiction, and a partial Simulated Universe are listed as present.

- Type: Case study
- Targets: Game
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-07
- Added to the catalog: 2026-11-09
- Original resource: <https://github.com/Melledy/LunarCore>
- Primary source: <https://github.com/Melledy/LunarCore/blob/04b5de871c62895091c4d65243b2e03997e66f23/README.md>
- Catalog page: <https://awesomerea.org/resources/lunarcore/>
- Record JSON: <https://awesomerea.org/resources/lunarcore/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/lunarcore/index.md)

## Requirements & limits

- Java 21. Place the Config, TextMap, and ExcelBin folders in resources, then run ./gradlew jar.
- The README names no license.

## Primary sources

1. <https://github.com/Melledy/LunarCore/blob/04b5de871c62895091c4d65243b2e03997e66f23/README.md>

## More in Games

- [Major Havoc: an arcade game disassembly](https://awesomerea.org/resources/major-havoc-disassembly-case/index.md) · Case study
- [MangosZero: reconstructing Vanilla World of Warcraft servers](https://awesomerea.org/resources/mangoszero-server-case/index.md) · Case study
- [Maniac Mansion: a commented C64 engine and loader disassembly](https://awesomerea.org/resources/maniac-mansion-c64-explained-case/index.md) · Case study
- [Maniac Mansion: annotated demo and retail script disassembly](https://awesomerea.org/resources/maniac-mansion-disasm/index.md) · Case study
- [MapleStory2: reconstructing server packet structures](https://awesomerea.org/resources/maple2-server-packet-case/index.md) · Case study
- [Mario Golf: a Game Boy Color disassembly](https://awesomerea.org/resources/mgolf-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.