echium-server

Honkai: Star Rail private server (4.6.53)

General Showcase

Screenshots

---

---

Features

---

• Battle through calyx with freesr-data.json (from https://srtools.neonteam.dev/) support, special blessings (toggleable), etc.

• Overworld lineup works and there is custom battle lineup support (like the 10 sparxie screenshot).

• Lua helper.

• Some commands through user signature/bio:

  Command	Arguments	Description	Example
  tb	<id / path>	Change Trailblazer path	tb 8002, tb stelle_destruction
  m7	<id / path>	Change March 7th path	m7 1224, m7 march_hunt
  sb	cast <on/off>	Toggle Castorice global buff	sb cast on
  sb	sw <on/off>	Toggle Silver Wolf global buff	sb sw off
  sb	vore <on/off>	Toggle whether server should override voracity blessing from srtools json	sb vore on
  sb	vorelvl <0-3>	Set voracity blessing level	sb vorelvl 2
  ex	<id/name> [on/off]	Toggle ExRank (Ex-Eidolon) for an avatar; enabled by default	ex acheron off
  cl	add <id1> <id2>...	Add characters to custom battle lineup	cl add 1001 1001
  cl	clear	Reset custom battle lineup	cl clear
  sync	-	Sync relics, lightcones, and inventory from freesr-data.json	sync

---

Known Limitations

---

• You cannot change lightcones, relics, etc. in the game. You can preview them ingame and change them by updating the freesr-data.json and then running the sync command to update the preview.

• Changing multi path (trailblazer, march) uses commands.

• Some buffs are hardcoded, like Cerydra's and DHPT's technique being hardcoded to the first in lineup.

• Many things aren't implemented like maps, etc.

Setup (Windows)

Prerequisites

---

• uv: https://docs.astral.sh/uv/getting-started/installation/ follow the instructions there
• protoc: https://github.com/protocolbuffers/protobuf/releases/download/v35.1/protoc-35.1-win64.zip extract and be sure to put it in PATH environment variable

---

Running

---

Everything below assumes PowerShell

1. git clone https://github.com/yuvlian/echium-server --recursive

   MAKE SURE YOU CLONE RECURSIVELY

2. cd echium-server

3. ./setup

4. ./start

For hotfix stuff, check common/__init__.py

---

Playing

---

1. Download https://github.com/yuvlian/echium/releases/download/0.1.0/win-x64.7z

2. Extract & copy .dll and .json to same folder as StarRail.exe

3. Rename .dll file to umpdc.dll

4. Edit .json file content if needed

5. Run game

Project Meta

Structure

---

echium-server/
├── StarRail.proto         # hsr protobufs
├── CmdId.json             # cmd ids
├── common/                # shared stuff
│   ├── db.py              # db.json stuff
│   ├── res.py             # resource loader
│   ├── res/               # resource data
│   ├── srtools.py         # freesr-data.json stuff
│   └── util.py            # utils
├── gameserver/            # game server
│   ├── client.py          # client connection
│   ├── connection.py      # packet framing
│   ├── packet.py          # packet encode/decode
│   ├── handler.py         # handler base
│   ├── faker.py           # fake connection thingy
│   └── handlers/          # handlers (avatar, battle, scene, ...)
├── sdkserver/             # sdk/dispatch server
├── kcpshimmy/             # kcp -> tcp shimmer
├── proto/                 # proto lib output
├── main.lua               # lua that the server can send
├── setup.bat              # setup script
├── start.bat              # start servers
└── tidy.bat               # for dev

---

License

---

Unlicense