Go to file
2022-05-15 12:40:36 -07:00
.github Update build.yml 2022-05-08 01:45:39 -07:00
data Move gacha files to separate directory and refactor file serving 2022-05-14 20:07:08 -07:00
gradle/wrapper Update gradle + Work gacha reload (gs broken atm) 2022-04-20 16:05:53 +08:00
keys Initial commit 2022-04-17 05:43:07 -07:00
lib Update kcp netty 2022-05-02 15:24:09 -07:00
proto Add support for codexQuests (#870) 2022-05-13 16:33:07 -07:00
src/main fix the dynamic group loading 2022-05-15 12:40:36 -07:00
.gitignore Add new gacha mappings and lombok generated files to gitignore 2022-05-15 03:48:31 -07:00
build.gradle Enable script in big world (#884) 2022-05-15 04:19:24 -07:00
CODE_OF_CONDUCT.md Update CODE_OF_CONDUCT.md 2022-04-24 19:24:23 +06:00
CONTRIBUTING.md Fix another weird line break 2022-04-24 00:06:56 +02:00
gradlew Make gradlew executable 2022-04-22 22:53:54 -04:00
gradlew.bat Initial commit 2022-04-17 05:43:07 -07:00
keystore.p12 Update the keystore 2022-04-22 22:34:00 -04:00
LICENSE Change LICENSE to GNU Affero 2022-05-08 13:09:22 -07:00
plugin-schema.json Add a plugin schema 2022-05-07 23:12:19 -07:00
proxy_config.py Allow overriding config with ENV (#506) 2022-05-05 15:22:29 +02:00
proxy.py Update proxy.py 2022-04-22 22:00:13 +08:00
README_zh-CN.md fix join command and remove command bug and update docs (#904) 2022-05-14 23:27:23 -07:00
README.md fix join command and remove command bug and update docs (#904) 2022-05-14 23:27:23 -07:00
settings.gradle Initial commit 2022-04-17 05:43:07 -07:00
start_config.cmd Allow configuration overrides 2022-04-22 11:34:22 +08:00
start.cmd Fix start.cmd can't find grasscutter when modify SERVER_JAR_NAME in start_config.cmd 2022-04-27 19:06:30 +02:00

Grasscutter

Documention GitHub release (latest by date) GitHub GitHub last commit GitHub Workflow Status
Discord - Grasscutter

EN | 中文

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 (recieving items/characters, upgrading items/characters, etc)

Quick setup guide

Note: For support please join our Discord.

Requirements

  • Java SE - 17 (link)

    Note: If you just want to run it, then jre only is fine.

  • MongoDB (recommended 4.0+)

  • Proxy daemon: mitmproxy (mitmdump, recommended), Fiddler Classic, etc.

Running

Note: If you updated from an older version, delete config.json to regenerate it.

  1. Get grasscutter.jar
  2. Create a resources folder in the directory where grasscutter.jar is located and move your BinOutput and ExcelBinOutput folders there (Check the wiki for more details how to get those.)
  3. Run Grasscutter with java -jar grasscutter.jar. Make sure mongodb service is running as well.

Connecting with the client

½. Create an account using server console command.

  1. Redirect traffic: (choose one)

    • mitmdump: mitmdump -s proxy.py -k

      Trust CA certificate:

      **Note:**The CA certificate is usually stored in % USERPROFILE%\ .mitmproxy, or you can download it from http://mitm.it

      Double click for install or ...

      • Via command line

        certutil -addstore root %USERPROFILE%\.mitmproxy\mitmproxy-ca-cert.cer
        
    • 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

  2. Set network proxy to 127.0.0.1:8080 or the proxy port you specified.

you can also use start.cmd to start servers and proxy daemons automatically

Building

Grasscutter uses Gradle to handle dependencies & building.

Requirements:

  • Java SE Development Kits - 17
  • Git
Windows
git clone https://github.com/Grasscutters/Grasscutter.git
cd Grasscutter
.\gradlew.bat # Setting up environments
.\gradlew jar # Compile
Linux
git clone 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.

Commands

You might want to use this command (java -jar grasscutter.jar -handbook) in a cmd that is in the grasscutter folder. It will create a handbook file (GM Handbook.txt) where you can find the item IDs for stuff you want

You may want to use this command (java -jar grasscutter.jar -gachamap) to generate a mapping file for the gacha record subsystem. The file will be generated to GRASSCUTTER_RESOURCE/gcstatic folder. Otherwise you may only see number IDs in the gacha record page.

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. to run commands ingame, you need to add prefix / or ! such as /pos

Commands Usage Permission node Availability description Alias
account account <create|delete> <username> [UID] Server only Creates an account with the specified username and the in-game UID for that account. The UID will be auto generated if not set.
broadcast broadcast <message> server.broadcast Both side Sends a message to all the players. b
coop coop <playerId> <target playerId> server.coop Both side Forces someone to join the world of others.
changescene changescene <scene id> player.changescene Client only Switch scenes by scene ID. scene
clear clear <all|wp| art\ mat> [UID] player.clearinv Client only Deletes all unequipped and unlocked level 0 artifacts(art)/weapons(wp)/material(all) or all, including 5-star rarity ones from your inventory.
drop drop <itemID|itemName> [amount] server.drop Client only Drops an item around you. d dropitem
enterdungeon enterdungeon <dungeon id> player.enterdungeon Client only Enter a dungeon by dungeon ID
give give [player] <itemId|itemName> [amount] [level] [finement] player.give Both side Gives item(s) to you or the specified player. (finement option only weapon.) g item giveitem
givechar givechar <uid> <avatarId> player.givechar Both side Gives the player a specified character. givec
giveart giveart [player] <artifactId> <mainPropId> [<appendPropId>[,<times>]]... [level] player.giveart Both side Gives the player a specified artifact. gart
giveall giveall [uid] [amount] player.giveall Both side Gives all items. givea
godmode godmode [uid] player.godmode Client only Prevents you from taking damage.
heal heal player.heal Client only Heals all characters in your current team. h
help help [command] Both side Sends the help message or shows information about a specified command.
join join [avatarIds] player.join Client only Force let avatars to join into your current team. Such as join 10000020 10000021.
kick kick <player> server.kick Both side Kicks the specified player from the server. (WIP) k
killall killall [playerUid] [sceneId] server.killall Both side Kills all entities in the current scene or specified scene of the corresponding player.
list list Both side Lists online players.
permission permission <add|remove> <UID> <permission> permission Both side Grants or removes a permission for a user.
position position Client only Sends your current coordinates. pos
reload reload server.reload Both side Reloads the server config
remove remove [avatarIndexInYourTeams] player.remove Client only Force remove avatar in your current team. Index start from 1.Such as remove 1 2.
resetconst resetconst [all] player.resetconstellation Client only Resets the constellation level on your currently selected character, will need to relog after using the command to see any changes. resetconstellation
restart Both side Restarts the current session
say say <player> <message> server.sendmessage Both side Sends a message to a player as the server sendservmsg sendservermessage sendmessage
setfetterlevel setfetterlevel <level> player.setfetterlevel Client only Sets the friendship level for your currently selected character setfetterlvl
setstats setstats <stat> <value> player.setstats Client only Sets a stat for your currently selected character stats
setworldlevel setworldlevel <level> player.setworldlevel Client only Sets your world level (Relog to see proper effects) setworldlvl
spawn spawn <entityId> [amount] [level(monster only)] server.spawn Client only Spawns some entities around you
stop stop server.stop Both side Stops the server
talent talent <talentID> <value> player.settalent Client only Sets talent level for your currently selected character
teleport teleport [@playerUid] <x> <y> <z> [sceneId] player.teleport Both side Change the player's position. tp
tpall player.tpall Client only Teleports all players in your world to your position
unlocktower player.tower Client only Unlock the all floors of abyss ut
weather weather <weatherID> <climateID> player.weather Client only Changes the weather w

Bonus

  • Teleporting
    • When you want to teleport to somewhere, use the in-game marking function on Map.
      • Mark a point on the map using the fish hook marking (the last one.)
      • (Optional) rename the map marker to a number to override the default Y coordinate (height, default 300.)
      • Confirm and close the map.
      • You will see your character falling from a very high destination, exact location that you marked.

Quick Troubleshooting

  • If compiling wasn't successful, please check your JDK installation (JDK 17 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.) > Game