Grasscutter: A Java repository from wizard872

EN | 简中 | 繁中 | FR | ES | HE | RU | PL | ID | KR | FIL/PH | NL | JP | IT | VI

Attention: We always welcome contributors to the project. Before adding your contribution, please carefully read our Code of Conduct.

Current features

Logging in
Combat
Friends list
Teleportation
Gacha system
Co-op partially works
Spawning monsters via console
Inventory features (receiving items/characters, upgrading items/characters, etc)

Quick setup guide

Note: For support please join our Discord.

Quick Start (automatic)

Get Java 17: https://www.oracle.com/java/technologies/javase/jdk17-archive-downloads.html
Get MongoDB Community Server
Get game version REL3.7 (3.7 client can be found here if you don't have it): https://github.com/MAnggiarMustofa/GI-Download-Library/blob/main/GenshinImpact/Client/3.7.0.md)
Download the latest Cultivation version. Use the .msi installer.
After opening Culivation (as admin), press the download button in the upper right corner.
Click Download All-in-One
Click the gear in the upper right corner
Set the game Install path to where your game is located.
Set the Custom Java Path to C:\Program Files\Java\jdk-17\bin\java.exe
Leave all other settings on default
Click the small button next to launch.
Click the launch button.
Log in with whatever username you want. Password doesn't matter.

Building

Grasscutter uses Gradle to handle dependencies & building.

Requirements:

Java SE Development Kits - 17 or higher
Git

Windows

git clone --recurse-submodules https://github.com/Grasscutters/Grasscutter.git
cd Grasscutter
.\gradlew.bat # Setting up environments
.\gradlew jar # Compile

Linux (GNU)

git clone --recurse-submodules https://github.com/Grasscutters/Grasscutter.git
cd Grasscutter
chmod +x gradlew
./gradlew jar # Compile

You can find the output jar in the root of the project folder.

Troubleshooting

For a list of common issues and solutions and to ask for help, please join our Discord server and go to the support channel.