Grasscutters /Grasscutter
A server software reimplementation for a certain anime game.
★ 16,816⑂ 4,240👁 177⑃ 1,236● 1,091▤ 20
+1
日增长
16,816
stars
4,240
forks
177
watchers
1,236
prs
1,091
issues
20
releases
README
!Grasscutter
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)
Foreward
Grasscutter beyond the latest release will have no handholding in terms of instructions.
Grasscutter has not been actively maintained and currently (as of January 12th, 2025) only works up to version REL4.0.1 (introduction to Fontaine). If you have a beta version/unofficial version of Grasscutter, this guide should theoretically still work, however, we will not provide official support these versions. You can still try your luck in the Discord if you are stuck, but please don't act entitled.
Quick setup guide
Note: For support please join our Discord.
Quick Start (automatic)
- Get Java 17
- Get MongoDB Community Server
- Get game version REL4.0.x (If you don't have a 4.0.x client, you can find it here and open any of the links to download it):
4.0.x Client-github
4.0.x Client-cloud drive
- UPDATE JAN 12, 2025: YOU CANNOT MIX AND MATCH GAME VERSIONS AND SERVER VERSIONS, PLEASE DOWNLOAD THE CORRECT VERSION OF GRASSCUTTER FOR YOUR VERSION OF THE GAME.
- Download the latest Cultivation version. Use the .msi installer.
- After opening Cultivation (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 can be anything.
Building
Grasscutter uses Gradle to handle dependencies & building.
Requirements:
- Java Development Kit 17 or higher
- Git
- NodeJS (Optional, for building the handbook)
Clone
shell
git clone --recurse-submodules https://github.com/Grasscutters/Grasscutter.git
cd Grasscutter
Compile
Note: Handbook generation may fail on some systems. To disable the handbook generation, append -PskipHandbook=1 to the gradlew jar command.
Windows:
shell
.\gradlew.bat Setting up environments
.\gradlew jar
Linux (GNU):
bash
chmod +x gradlew
./gradlew jar
Compiling the Handbook (Manually)
With Gradle:
shell
./gradlew generateHandbook
With NPM:
shell
cd src/handbook
npm install
npm run build
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.Top issues
#2559[Question] 我尝试将该项目移植到4.8,目前账号登录正常工作,但进门后白屏,然后提示“服务器响应超时,请重新登录”。我还应该改些什么才能让它正常工作?22 comments · 2026-05-06#2315[Bug] Is it normal for GC4.0dev to consume a lot of CPU?15 comments · 2023-08-28#2204[Bug] Random character deaths15 comments · 2023-06-10#2482版本更新请求12 comments · 2024-03-08#980[Bug] Damage determination may override shields in some cases10 comments · 2022-05-18#2419[Bug]首次运行出现9 comments · 2023-11-01#2340可以加一个能关闭剧情的嘛!如果我只想体验指令不想要剧情9 comments · 2023-09-04#2038[Feature Request] 可不可以添加Docker一键部署?9 comments · 2023-01-30
Discussions
#2545为什么我抽出来的武器不可以精炼?1 comments · 2025-01-14#25445.3胡桃新皮肤1 comments · 2025-01-13#2541why i can't connet?1 comments · 2024-12-25#2539这个服务端可以搭建5.2的剧情服吗(可以过活动以及主线那种)2 comments · 2024-12-14#2503Project is DEAD....?2 comments · 2024-04-24#2491账号密码问题1 comments · 2024-03-29#2481Contributions to Grasscutter0 comments · 2024-02-25#2480最低需要哪些java组件1 comments · 2024-02-20
Latest release
Grasscutter | v1.7.4 v1.7.4 2023-12-01Changelog most likely the last update for a while; the game hasn't had any recent innovations & protocol defs are harder to come by - more spiral abyss fixes - finally fixing the year-old bug of elemental energy being taken away without activating an avatar's burst - bug fixes related to the player's home realm - bug fixes with enemies (specifically substates) What's Changed Implement abyss defense objective by @longfruit in https://github.com/Grasscutters/Grasscutter/pull/2422 Only deduct energy when elemental burst actually fires by @longfruit in https://github.com/Grasscutters/