mirror of
https://github.com/Melledy/Grasscutter.git
synced 2024-11-22 01:55:34 +00:00
128 lines
6.7 KiB
Markdown
128 lines
6.7 KiB
Markdown
![Grasscutter](https://socialify.git.ci/Grasscutters/Grasscutter/image?description=1&forks=1&issues=1&language=1&logo=https%3A%2F%2Fs2.loli.net%2F2022%2F04%2F25%2FxOiJn7lCdcT5Mw1.png&name=1&owner=1&pulls=1&stargazers=1&theme=Light)
|
|
<div align="center"><img alt="Documentation" src="https://img.shields.io/badge/Wiki-Grasscutter-blue?style=for-the-badge&link=https://github.com/Grasscutters/Grasscutter/wiki&link=https://github.com/Grasscutters/Grasscutter/wiki"> <img alt="GitHub release (latest by date)" src="https://img.shields.io/github/v/release/Grasscutters/Grasscutter?logo=java&style=for-the-badge"> <img alt="GitHub" src="https://img.shields.io/github/license/Grasscutters/Grasscutter?style=for-the-badge"> <img alt="GitHub last commit" src="https://img.shields.io/github/last-commit/Grasscutters/Grasscutter?style=for-the-badge"> <img alt="GitHub Workflow Status" src="https://img.shields.io/github/workflow/status/Grasscutters/Grasscutter/Build?logo=github&style=for-the-badge"></div>
|
|
|
|
<div align="center"><a href="https://discord.gg/T5vZU6UyeG"><img alt="Discord - Grasscutter" src="https://img.shields.io/discord/965284035985305680?label=Discord&logo=discord&style=for-the-badge"></a></div>
|
|
|
|
[EN](README.md) | [简中](README_zh-CN.md) | [繁中](README_zh-TW.md) | [FR](README_fr-FR.md) | [ES](README_es-ES.md) | [HE](README_HE.md) | [RU](README_ru-RU.md) | [PL](README_pl-PL.md) | [ID](README_id-ID.md) | [KR](README_ko-KR.md) | [FIL/PH](README_fil-PH.md) | [NL](README_NL.md) | [JP](README_ja-JP.md)
|
|
|
|
**Aantekening:** We verwelkomen altijd bijdragers aan het project. Lees onze [Gedragscode](https://github.com/Grasscutters/Grasscutter/blob/development/README_NL.md#bijdragen-aan-het-project) zorgvuldig door voordat u uw bijdrage toevoegt.
|
|
|
|
## Huidige functies
|
|
|
|
* inloggen
|
|
* Combat
|
|
* Vriendenlijst
|
|
* Teleportatie
|
|
* Gacha systeem
|
|
* Co-op werkt (gedeeltelijk)
|
|
* Monsters spawnen via console
|
|
* Inventaris functies (ontvangen van items / karakters, upgraden van items / karakters, enz.)
|
|
|
|
|
|
## Snelle installatie gids
|
|
|
|
**Note:** Voor ondersteuning kunt u lid worden van onze [Discord](https://discord.gg/T5vZU6UyeG).
|
|
|
|
### Vereisten
|
|
|
|
* [Java SE - 17](https://www.oracle.com/java/technologies/javase/jdk17-archive-downloads.html)
|
|
|
|
**Note:** Als u het alleen wilt **draaien**, dan is **jre** alleen prima.
|
|
|
|
* [MongoDB](https://www.mongodb.com/try/download/community) (aanbevolen 4.0+)
|
|
|
|
* Proxy Daemon: [mitmproxy](https://mitmproxy.org/) (mitmdump, aanbevolen), [Fiddler Classic](https://telerik-fiddler.s3.amazonaws.com/fiddler/FiddlerSetup.exe), enz.
|
|
|
|
### Opstarten
|
|
|
|
**Note:** Als u vanaf een oudere versie heeft geupdate, verwijder dan `config.json` om het te regenereren.
|
|
|
|
1. Verkrijg `grasscutter.jar`
|
|
- Download van [actions](https://github.com/Grasscutters/Grasscutter/actions) of [bouw de jar zelf](https://github.com/Grasscutters/Grasscutter/blob/development/README_NL.md#building)
|
|
2. Maak een `resources` map aan in de directory waar grasscutter.jar staat en verplaats je `BinOutput, ExcelBinOutput, Readables, Scripts, Subtitle, TextMap` mappen daarheen *(Check de [wiki](https://github.com/Grasscutters/Grasscutter/wiki) voor meer details hoe je die krijgt.)*
|
|
3. Start Grasscutter met `java -jar grasscutter.jar`. **Zorg ervoor dat de mongodb service ook draait.**
|
|
|
|
### Verbinden met de client
|
|
|
|
½. Maak een account aan met [server console command](https://github.com/Grasscutters/Grasscutter/wiki/Commands#targeting).
|
|
|
|
1. Verkeer omleiden: (kies er een)
|
|
- mitmdump: `mitmdump -s proxy.py -k`
|
|
|
|
Vertrouw CA certificaat:
|
|
|
|
**Note:** Het CA certificaat is meestal opgeslagen in `%USERPROFILE%.mitmproxy`, of je kan het downloaden van `http://mitm.it`
|
|
|
|
Dubbelklik voor [install](https://docs.microsoft.com/en-us/skype-sdk/sdn/articles/installing-the-trusted-root-certificate#installing-a-trusted-root-certificate) of ...
|
|
|
|
- Via de commandoregel
|
|
|
|
```Shell
|
|
certutil -addstore root %USERPROFILE%%%.mitmproxymitmproxy-ca-cert.cer
|
|
```
|
|
|
|
- Fiddler Classic: Start Fiddler Classic, zet `Decrypt https traffic` aan in setting en verander de standaard poort daar (Tools -> Options -> Connections) in iets anders dan `8888`, en laad [dit script](https://github.com/Grasscutters/Grasscutter/wiki/Resources#fiddler-classic-jscript).
|
|
|
|
- [Hosts file](https://github.com/Grasscutters/Grasscutter/wiki/Resources#hosts-file)
|
|
|
|
2. Stel de netwerk proxy in op `127.0.0.1:8080` of de proxy poort die u heeft opgegeven.
|
|
|
|
**U kunt ook `start.cmd` gebruiken om servers en proxy daemons automatisch te starten, maar dan moet u JAVA_HOME enviroment en `start_config.cmd` instellen.**
|
|
|
|
### Bouwen
|
|
|
|
Grasscutter gebruikt Gradle om afhankelijkheden en bouwen af te handelen.
|
|
|
|
**Vereisten:**
|
|
|
|
- [Java SE Development Kits - 17](https://www.oracle.com/java/technologies/javase/jdk17-archive-downloads.html)
|
|
- [Git](https://git-scm.com/downloads)
|
|
|
|
##### Windows
|
|
|
|
```Shell
|
|
git clone https://github.com/Grasscutters/Grasscutter.git
|
|
cd Grasscutter
|
|
.\gradlew.bat # Instellen van omgevingen
|
|
.gradlew jar # Compileren
|
|
```
|
|
|
|
##### Linux
|
|
|
|
```bash
|
|
git clone https://github.com/Grasscutters/Grasscutter.git
|
|
cd Grasscutter
|
|
chmod +x gradlew
|
|
./gradlew jar # Compileer
|
|
```
|
|
|
|
U kunt de output jar vinden in de root van de project map.
|
|
|
|
### Commando's zijn verplaatst naar de [wiki](https://github.com/Grasscutters/Grasscutter/wiki/Commands)!
|
|
|
|
# Quick Troubleshooting
|
|
|
|
* Als het compileren niet succesvol was, controleer dan je JDK installatie (JDK 17 en gevalideerde JDK's bin PATH variabele)
|
|
* Mijn client maakt geen verbinding, logt niet in, 4206, etc... - Meestal is je proxy daemon setup *het probleem*, als je
|
|
Fiddler gebruik, zorg ervoor dat het op een andere poort draait behalve 8888
|
|
* Opstart volgorde: MongoDB > Grasscutter > Proxy daemon (mitmdump, fiddler, enz.) > Game
|
|
|
|
|
|
|
|
|
|
# Bijdragen aan het project
|
|
|
|
Let op: we hebben een gedragscode, volg deze alsjeblieft in al je interacties met het project. Als je nog vragen hebt, maak dan een issue aan of vraag het in de Discord server.
|
|
|
|
- Repareer/toevoeg alleen de functionaliteit in kwestie OF pak wijdverspreide witruimte/stijl problemen aan, niet beide.
|
|
- Pak een enkel probleem aan met zo min mogelijk gewijzigde regels.
|
|
|
|
**Maak geen pull request om samen te voegen in stable tenzij het een hotfix is. Gebruik in plaats daarvan de development branch.**
|
|
|
|
## Pull Request Proces
|
|
|
|
1. Zorg ervoor dat alle installatie- of build-afhankelijkheden verwijderd zijn voor het einde van de laag wanneer u een build doet.
|
|
2. 2. Werk de README.md en wiki bij met details van wijzigingen aan de interface, inclusief nieuwe omgevingsvariabelen, blootgestelde poorten, nuttige bestandslocaties en containerparameters.
|
|
3. Schrijf met detail op je pull request beschrijving wat je hebt gecommit, om het makkelijker te maken voor de medewerkers om een changelog te maken.
|
|
|