{"id":15034537,"url":"https://github.com/grasscutters/grasscutter","last_synced_at":"2025-05-12T05:14:20.473Z","repository":{"id":36969688,"uuid":"482520194","full_name":"Grasscutters/Grasscutter","owner":"Grasscutters","description":"A server software reimplementation for a certain anime game.","archived":false,"fork":false,"pushed_at":"2025-04-27T02:05:59.000Z","size":101542,"stargazers_count":16493,"open_issues_count":146,"forks_count":4445,"subscribers_count":185,"default_branch":"development","last_synced_at":"2025-05-12T05:14:12.361Z","etag":null,"topics":["java","kcp","private-server","server"],"latest_commit_sha":null,"homepage":"https://grasscutter.io/","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Grasscutters.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2022-04-17T12:43:46.000Z","updated_at":"2025-05-12T03:50:55.000Z","dependencies_parsed_at":"2023-09-26T04:15:22.061Z","dependency_job_id":"72b01dd6-1559-493c-b552-b104ed3ff3dd","html_url":"https://github.com/Grasscutters/Grasscutter","commit_stats":null,"previous_names":[],"tags_count":22,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Grasscutters%2FGrasscutter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Grasscutters%2FGrasscutter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Grasscutters%2FGrasscutter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Grasscutters%2FGrasscutter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Grasscutters","download_url":"https://codeload.github.com/Grasscutters/Grasscutter/tar.gz/refs/heads/development","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253678903,"owners_count":21946319,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["java","kcp","private-server","server"],"created_at":"2024-09-24T20:25:25.966Z","updated_at":"2025-05-12T05:14:20.455Z","avatar_url":"https://github.com/Grasscutters.png","language":"Java","readme":"![Grasscutter](https://socialify.git.ci/Grasscutters/Grasscutter/image?description=1\u0026forks=1\u0026issues=1\u0026language=1\u0026logo=https%3A%2F%2Fs2.loli.net%2F2022%2F04%2F25%2FxOiJn7lCdcT5Mw1.png\u0026name=1\u0026owner=1\u0026pulls=1\u0026stargazers=1\u0026theme=Light)\n\u003cdiv align=\"center\"\u003e\u003cimg alt=\"Documentation\" src=\"https://img.shields.io/badge/Wiki-Grasscutter-blue?style=for-the-badge\u0026link=https://github.com/Grasscutters/Grasscutter/wiki\u0026link=https://github.com/Grasscutters/Grasscutter/wiki\"\u003e \u003cimg alt=\"GitHub release (latest by date)\" src=\"https://img.shields.io/github/v/release/Grasscutters/Grasscutter?logo=java\u0026style=for-the-badge\"\u003e \u003cimg alt=\"GitHub\" src=\"https://img.shields.io/github/license/Grasscutters/Grasscutter?style=for-the-badge\"\u003e \u003cimg alt=\"GitHub last commit\" src=\"https://img.shields.io/github/last-commit/Grasscutters/Grasscutter?style=for-the-badge\"\u003e \u003cimg alt=\"GitHub Workflow Status\" src=\"https://img.shields.io/github/actions/workflow/status/Grasscutters/Grasscutter/build.yml?branch=development\u0026logo=github\u0026style=for-the-badge\"\u003e\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\u003ca href=\"https://discord.gg/T5vZU6UyeG\"\u003e\u003cimg alt=\"Discord - Grasscutter\" src=\"https://img.shields.io/discord/965284035985305680?label=Discord\u0026logo=discord\u0026style=for-the-badge\"\u003e\u003c/a\u003e\u003c/div\u003e\n\n[EN](README.md) | [简中](docs/README_zh-CN.md) | [繁中](docs/README_zh-TW.md) | [FR](docs/README_fr-FR.md) | [ES](docs/README_es-ES.md) | [HE](docs/README_HE.md) | [RU](docs/README_ru-RU.md) | [PL](docs/README_pl-PL.md) | [ID](docs/README_id-ID.md) | [KR](docs/README_ko-KR.md) | [FIL/PH](docs/README_fil-PH.md) | [NL](docs/README_NL.md) | [JP](docs/README_ja-JP.md) | [IT](docs/README_it-IT.md) | [VI](docs/README_vi-VN.md)\n\n**Attention:** We always welcome contributors to the project. Before adding your contribution, please carefully read our [Code of Conduct](https://github.com/Grasscutters/Grasscutter/blob/stable/CONTRIBUTING.md).\n\n## Current features\n\n* Logging in\n* Combat\n* Friends list\n* Teleportation\n* Gacha system\n* Co-op *partially* works\n* Spawning monsters via console\n* Inventory features (receiving items/characters, upgrading items/characters, etc)\n\n## Foreward\n\n### **Grasscutter beyond the latest release will have no handholding in terms of instructions.**\n\nGrasscutter 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.\n\n## Quick setup guide\n\n**Note**: For support please join our [Discord](https://discord.gg/T5vZU6UyeG).\n\n### Quick Start (automatic)\n\n- Get [Java 17](https://www.oracle.com/java/technologies/javase/jdk17-archive-downloads.html)\n- Get [MongoDB Community Server](https://www.mongodb.com/try/download/community)\n- 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):\n[4.0.x Client-github](https://github.com/JRSKelvin/GenshinRepository/blob/main/Version%204.0.0.md)\n[4.0.x Client-cloud drive](https://www.123pan.com/s/HoqUVv-U7SBA.html)\n- ***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.***\n\n- Download the [latest Cultivation version](https://github.com/Grasscutters/Cultivation/releases/latest). Use the `.msi` installer.\n- After opening Cultivation (as admin), press the download button in the upper right corner. \n- Click `Download All-in-One`\n- Click the gear in the upper right corner\n- Set the game Install path to where your game is located.\n- Set the Custom Java Path to `C:\\Program Files\\Java\\jdk-17\\bin\\java.exe`\n- Leave all other settings on default\n\n- Click the small button next to launch.\n- Click the launch button.\n- Log in with whatever username you want. Password can be anything.\n\n### Building\n\nGrasscutter uses Gradle to handle dependencies \u0026 building.\n\n**Requirements:**\n\n- [Java Development Kit 17](https://www.oracle.com/java/technologies/javase/jdk17-archive-downloads.html) or higher\n- [Git](https://git-scm.com/downloads)\n- [NodeJS](https://nodejs.org/en/download) (Optional, for building the handbook)\n\n##### Clone\n\n```shell\ngit clone --recurse-submodules https://github.com/Grasscutters/Grasscutter.git\ncd Grasscutter\n```\n\n##### Compile\n\n**Note**: Handbook generation may fail on some systems. To disable the handbook generation, append `-PskipHandbook=1` to the `gradlew jar` command.\n\nWindows:\n\n```shell\n.\\gradlew.bat # Setting up environments\n.\\gradlew jar\n```\n\nLinux (GNU):\n\n```bash\nchmod +x gradlew\n./gradlew jar\n```\n\n##### Compiling the Handbook (Manually)\n\nWith Gradle:\n\n```shell\n./gradlew generateHandbook\n```\n\nWith NPM:\n\n```shell\ncd src/handbook\nnpm install\nnpm run build\n```\n\nYou can find the output jar in the root of the project folder.\n\n### Troubleshooting \n\nFor a list of common issues and solutions and to ask for help, please join [our Discord server](https://discord.gg/T5vZU6UyeG) and go to the support channel.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgrasscutters%2Fgrasscutter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgrasscutters%2Fgrasscutter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgrasscutters%2Fgrasscutter/lists"}