Mirror/LunarCore
1
0
Fork 0
mirror of https://github.com/Melledy/LunarCore.git synced 2025-12-12 13:24:36 +01:00
Code Issues Packages Projects Releases Wiki Activity

Update to 1.5.0

Browse Source 
Some protos (mostly SU related) might be broken
This commit is contained in:
Melledy
2023-11-18 04:27:30 -08:00
parent 04ed507796
commit f8c0ce2c11
231 changed files with 18542 additions and 26601 deletions
Download Patch File Download Diff File Expand all files Collapse all files

69
README.md
View File

@@ -1,31 +1,68 @@
# Lunar Core
A server emulator for version 1.4.0 of a certain turn based anime game.
A game server reimplementation for version 1.5.0 of a certain turn based anime game for educational purposes. For any extra support, questions, or discussions, check out our [discord](https://discord.gg/cfPKJ6N5hw).
### Notable features
- Basic game features: Logging in, team setup, inventory, basic scene/entity management
- Monster battles working
- Natural world monster/prop/npc spawns
- Most character techniques are handled
- Npc shops handled
- Gacha system
- Mail system
- Forgotten hall (with 1.4.0 features)
- Simulated universe (Runs can be finished, but many features are missing)
# Running the server and client
### Prerequisites
* Java 17 JDK
* [Java 17 JDK](https://www.oracle.com/java/technologies/javase/jdk17-archive-downloads.html)
### Recommended
* Mongodb (4.0+)
* [MongoDB 4.0+](https://www.mongodb.com/try/download/community)
### Starting up the server
1. Compile the server with `./gradlew jar`
2. Create a folder named `resources` in your server directory, you will need to downlaod `TextMap` and `ExcelBin` folders which you can get from a repo like [https://github.com/Dimbreath/StarRailData](https://github.com/Dimbreath/StarRailData) into your resources folder.
3. Run the server with `java -jar LunarRail.jar`. Lunar Rail comes with a built in internal mongo server for its database, so no Mongodb installation is required. However, it is highly recomended to install Mongodb anyways.
2. Create a folder named `resources` in your server directory, you will need to download the `TextMap` and `ExcelBin` folders which you can get from a repo like [https://github.com/Dimbreath/StarRailData](https://github.com/Dimbreath/StarRailData) into your resources folder.
3. Run the server with `java -jar LunarCore.jar`. Lunar Core comes with a built in internal mongo server for its database, so no Mongodb installation is required. However, it is highly recomended to install Mongodb anyways.
4. Create an account if you haven't already using the `/account` command
### Connecting with the client
1. Login with the client to an official server at least once to download game data.
2. If you are using the provided keystore, you will need to install and have [Fiddler](https://www.telerik.com/fiddler) running. Make sure fiddler is set to decrypt https traffic.
3. Set your hosts file to redirect at least `hkrpg-sdk-os-static.hoyoverse.com` and `globaldp-prod-os01.starrails.com` to your http (dispatch) server ip.
### Connecting with the client (Fiddler)
1. Login with the client to an official server and hoyo account **at least once** to download game data.
2. Install and have [Fiddler Classic](https://www.telerik.com/fiddler) running.
3. Set fiddler to decrypt https traffic. (Tools -> Options -> HTTPS -> Decrypt HTTPS traffic) Make sure `ignore server certificate errors` is checked as well.
4. Copy and paste the following code into the fiddlerscript tab of fiddler classic:
### Server console commands
```
import System;
import System.Windows.Forms;
import Fiddler;
import System.Text.RegularExpressions;
`/account create [username] {playerid}` - Creates an account with the specified username and the in-game uid for that account. The playerid parameter is optional and will be auto generated if not set.
class Handlers
{
static function OnBeforeRequest(oS: Session) {
if (oS.host.EndsWith(".starrails.com") || oS.host.EndsWith(".hoyoverse.com") || oS.host.EndsWith(".mihoyo.com") || oS.host.EndsWith(".bhsr.com")) {
oS.host = "localhost"; // This can also be replaced with another IP address.
}
}
};
```
### In-Game commands
There is a dummy user named "Server" in every player's friends list that you can message to use commands. Commands also work in other chat rooms, such as private/team chats.
### Server commands
Server commands can be run in the server console or in-game. There is a dummy user named "Server" in every player's friends list that you can message to use in-game commands.
`!spawn [monster id] [stage id]`
`!give [item id] [amount]`
```
/mail [content]. Sends the targeted player a system mail.
/avatar lv(level) p(ascension) r(eidolon) s(skill levels). Sets the current avatar's properties
/giveall {materials | avatars}. Gives the targeted player items.
/account {create | delete} [username] (reserved player uid). Creates or deletes an account.
/unstuck @[player id]. Unstucks an offline player if theyre in a scene that doesnt load.
/gender {male | female}. Sets the player gender.
/spawn [monster/prop id] x[amount] s[stage id]. Spawns a monster or prop near the targeted player.
/give [item id] x[amount]. Gives the targetted player an item.
/permission {add | remove | clear} [permission]. Gives/removes a permission from the targeted player.
/clear {relics | lightcones | materials | items}. Removes filtered items from the player inventory.
/worldlevel [world level]. Sets the targeted player's equilibrium level.
/reload. Reloads the server config.
/scene [scene id] [floor id]. Teleports the player to the specified scene.
```