Skip to content

Commit

Permalink
Merge branch 'development' of https://github.com/XeonSucksLAB/Unknown…
Browse files Browse the repository at this point in the history
…AnimeGamePS into development
  • Loading branch information
WatchAndyTW committed Apr 18, 2024
2 parents 20c5582 + 520414f commit 31b5307
Showing 1 changed file with 35 additions and 40 deletions.
75 changes: 35 additions & 40 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,17 +12,15 @@
* Logging in
* Combat
* Friends list
* Teleportation
* Gacha system
* Co-op *partially* works
* Teleportation (?)
* Gacha system (-)
* Co-op *partially* works (-)
* Spawning monsters via console
* Inventory features (receiving items/characters, upgrading items/characters, etc)

## Quick setup guide
# Setup Guide

**Note**: For support please join our [Discord](https://discord.gg/T5vZU6UyeG).

### Quick Start (automatic)
## Main Requirements

- Get [Java 17](https://www.oracle.com/java/technologies/javase/jdk17-archive-downloads.html)
- Get [MongoDB Community Server](https://www.mongodb.com/try/download/community)
Expand All @@ -43,64 +41,61 @@

- Find the patch from somewhere on the internet.
- Put the `version.dll` in to the folder of your game client.
- Launch the server.
- Launch the client and login.
- Download the old version of [mihoyonet.dll](https://autopatchhk.yuanshen.com/client_app/download/pc_zip/20231030132335_iOEfPMcbrXpiA8Ca/ScatteredFiles/GenshinImpact_Data/Plugins/mihoyonet.dll) (4.2.0).
- Put the old version of `mihoyonet.dll` in `GenshinImpact_Data/Plugins` folder.

- Enjoy!
## Let's build the server

### Building
### 1. Clone the repository

Grasscutter uses Gradle to handle dependencies & building.
```shell
git clone --recurse-submodules https://github.com/XeonSucksLAB/UnknownAnimeGamePS.git
cd UnknownAnimeGamePS
```

**Requirements:**
**Curiosity**: Grasscutter uses Gradle to handle dependencies and building.

- [Java Development Kit 17](https://www.oracle.com/java/technologies/javase/jdk17-archive-downloads.html) or higher
- [Git](https://git-scm.com/downloads)
- [NodeJS](https://nodejs.org/en/download) (Optional, for building the handbook)
### 2. Compile the actual Server

##### Clone
**Sidenote**: Make sure to append the right prefix and suffix based on your operating system (./ for linux | .\ for windows | add .bat for windows systems when compiling server JAR/handbook).

```shell
git clone --recurse-submodules https://github.com/Grasscutters/Grasscutter.git
cd Grasscutter
```
**Requirements**:

##### Compile
[Java Development Kit 17 | JDK](https://oracle.com/java/technologies/javase/jdk17-archive-downloads.html) or higher

**Note**: Handbook generation may fail on some systems. To disable the handbook generation, append `-PskipHandbook=1` to the `gradlew jar` command.
[Git](https://git-scm.com/downloads)

Windows:
- **Sidenote**: Handbook generation may fail on some systems. To disable handbook generation, append `-PskipHandbook=1` to the `gradlew jar` command.

- **For Windows**:
```shell
.\gradlew.bat # Setting up environments
.\gradlew jar
.\gradlew.bat
.\gradlew.bat jar
```
*If you are wondering, the first command is to set up the environment while the 2nd one is for building the server JAR file.*

Linux (GNU):

- **For Linux**:
```bash
chmod +x gradlew
./gradlew jar
```
*If you are wondering, the first command is to make the file executeable and for the rest refer to the windows explanation.*

##### Compiling the Handbook (Manually)

With Gradle:
### You can find the output JAR in the project root folder.

### Manually compile the handbook
```shell
./gradlew generateHandbook
```

With NPM:

```shell
cd src/handbook
npm install
npm run build
```
## You're done with the building part!

You can find the output jar in the root of the project folder.
- Launch the server.
- Launch the client and login.

- Enjoy!

### Troubleshooting
### Troubleshooting

For a list of common issues and solutions and to ask for help, please join [our Discord server](https://discord.gg/T5vZU6UyeG) and go to the support channel.
TO DO

0 comments on commit 31b5307

Please sign in to comment.