Go to file
Scald 4647d528e2
Gm handbook lmao (#2149)
* Fix font issue

* Fix avatars

* Fix text overflow in commands

* Fix virtualized lists and items page 😭😭

* magix why 💀

* use hover style in all minicards

* button

* remove console.log

* lint

* Add icons

* magix asked

* Fix overflow padding issue

* Fix achievement text overflow

* remove icons from repo

* Change command icon

* Add the wiki page as a submodule

* total magix moment

* fix text overflow in commands

* Fix discord button

* Make text scale on Minicard

* import icons and font from another source

* Add hover effects to siebar buttons

* move font and readme to submodule repo

* Make data folder a submodule

* import icons and font from data submodule

* Update README.md

* total magix moment

* magix moment v2

* submodule change

* Import `.webp` files

* Resize `HomeButton`

* Fix 'Copy Command' reappearing after changing pages

---------

Co-authored-by: KingRainbow44 <kobedo11@gmail.com>
2023-05-15 03:55:44 -04:00
.github Update GitHub Actions to use 'download-file' over 'wget' 2023-05-15 03:46:23 -04:00
buildSrc/src/main/java/emu/grasscutter/gen Create files from Grasscutter-Quests 2023-03-31 23:58:12 -04:00
docs Add the wiki page as a submodule 2023-05-14 03:40:27 -04:00
gradle/wrapper Update gradle wrapper (closes #1076) 2022-11-05 15:03:00 +10:30
lib Add the improved KCP library 2023-03-31 23:37:25 -04:00
scripts Move scripts away from the root directory 2023-03-31 17:05:12 -04:00
src Gm handbook lmao (#2149) 2023-05-15 03:55:44 -04:00
.editorconfig Add building for handbook 2023-04-04 21:41:06 -04:00
.gitattributes Run spotlessApply 2023-05-07 22:53:55 -04:00
.gitignore Remove artifact signatures from VCS 2023-05-13 17:38:35 -04:00
.gitmodules Gm handbook lmao (#2149) 2023-05-15 03:55:44 -04:00
build.gradle Separate the dispatch and game servers (pt. 1) 2023-05-15 00:43:16 -04:00
CODE_OF_CONDUCT.md Update CODE_OF_CONDUCT.md 2022-04-24 19:24:23 +06:00
CONTRIBUTING.md Update banners (closes #1760) 2022-09-11 21:05:16 +09:30
gradle.properties forever engraved (#2120) 2023-04-15 02:35:15 -04:00
gradlew Update gradle wrapper (closes #1076) 2022-11-05 15:03:00 +10:30
gradlew.bat Merge packet handlers from quests/quests 2023-04-14 21:59:15 -04: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 loadAfter plugin setting 2022-06-22 00:19:43 -04:00
README.md Gm handbook lmao (#2149) 2023-05-15 03:55:44 -04:00
settings.gradle Initial commit 2022-04-17 05:43:07 -07:00
start_config.cmd fix java search in start.cmd 2022-05-24 05:34:04 -07:00
start.cmd fix java search in start.cmd 2022-05-24 05:34:04 -07:00

Grasscutter

Documentation GitHub release (latest by date) GitHub GitHub last commit GitHub Workflow Status
Discord - 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)

Quick setup guide

Note: For support please join our Discord.

Requirements

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, ExcelBinOutput, Readables, Scripts, Subtitle, TextMap 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 in the server console using this command.

  1. Redirect traffic: (choose one only)

    • mitmdump: mitmdump -s proxy.py -k

      • Trust CA certificate:

        • The CA certificate is usually stored in %USERPROFILE%\.mitmproxy, double click mitmproxy-ca-cert.cer to install or...

        • Via command line (needs administration privileges)

          certutil -addstore root %USERPROFILE%\.mitmproxy\mitmproxy-ca-cert.cer
          
    • Fiddler Classic: Run Fiddler Classic, turn on Decrypt HTTPS traffic in (Tools -> Options -> HTTPS) and change the default port in (Tools -> Options -> Connections) to anything other than 8888, load this script (copy and paste the script in the FiddlerScript tab) and click the Save Script button.

    • Hosts file

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

  • For mitmproxy: After setting up the network proxy and installing the certificate, check http://mitm.it/ if traffic is passing through mitmproxy.

You can also use start.cmd to start servers and proxy daemons automatically, but you have to set up JAVA_HOME environment and configure the start_config.cmd file.

Building

Grasscutter uses Gradle to handle dependencies & building.

Requirements:

Windows
git clone --recurse-submodules -b unstable https://github.com/Grasscutters/Grasscutter.git
cd Grasscutter
.\gradlew.bat # Setting up environments
.\gradlew jar # Compile
Linux (GNU)
git clone --recurse-submodules -b unstable 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.