Grasscutter

A WIP server emulator for Genshin Impact 2.3-2.6

Note: For support please join the Discord server.

Current features

Logging in
Spawning monsters via console
Combat
Inventory features (recieving items/characters, upgrading items/characters, etc)
Co-op does work, but movement is kind of buggy and some player ults do not spawn properly
Friends list
Gacha system

Quick setup guide

For more information, we now have Grasscutter Wiki page !

Prerequisites

JDK-8u202 (mirror link since Oracle required an account to download old builds)
Mongodb (recommended 4.0+)
Proxy daemon: mitmproxy (mitmdump, recommended), Fiddler Classic, etc.

Starting up the server (Assuming you are on Windows)

Setup compile environment gradlew.bat
Compile the server with gradlew jar
Create a folder named resources in your Grasscutter directory, bring your BinOutput and ExcelBinOutput folders into it (Check the wiki for more details where to get those.)
Run the server with java -jar grasscutter.jar. Make sure mongodb is running as well.

Connecting with the client

½. Create an account using command below

Run a proxy daemon:
- mitmdump: mitmdump -s proxy.py --ssl-insecure
- Fiddler Classic: Run Fiddler Classic, turn on Decrypt https traffic in setting and change the default port there (Tools -> Options -> Connections) to anything other than 8888, and load this script.
- Hosts file
Trust CA certificate:
- mitmdump: certutil -addstore root %USERPROFILE%\.mitmproxy\mitmproxy-ca-cert.cer
Set network proxy to 127.0.0.1:8080 or the proxy port you specified.
yoink

or you can use run.cmd to start Server & Proxy daemon with one click

Grasscutter server console commands

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.

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.

!spawn [monster id] [level] [amount]

!give [item id] [amount]

!drop [item id] [amount]

!killall

!godmode - Prevents you from taking damage

!resetconst - Resets the constellation level on your current active character, will need to relog after using the command to see any changes.

!sethp [hp]

!clearartifacts - Deletes all unequipped and unlocked level 0 artifacts, including yellow rarity ones from your inventory

Quick Troubleshooting

If compiling wasnt successful, please check your JDK installation (must be JDK 8 and validated JDK's bin PATH variable)
My client doesn't connect, doesn't login, 4206, etc... - Mostly your proxy daemon setup is the issue, if using Fiddler make sure it running on another port except 8888
Startup sequence: Mongodb > Grasscutter > Proxy daemon (mitmdump, fiddler, etc.) > Client
If 4206 error constantly prompt up, try to use jdk-8u202-b08 instead of other versions of JDK

3.4 KiB Raw Blame History