README.md 12.6 KB
Newer Older
Wansn's avatar
Wansn committed
1
![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)
2
<div align="center"><img alt="Documention" 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>
3

4
5
6
<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_zh-CN.md)
Wansn's avatar
Wansn committed
7
8
9
10

**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).

## Current features
Jaida Wu's avatar
Jaida Wu committed
11
12
13

* Logging in
* Combat
lunaticwhat's avatar
gran    
lunaticwhat committed
14
* Friends list
Wansn's avatar
Wansn committed
15
16
* Teleportation
* Gacha system
xmplay's avatar
xmplay committed
17
* Co-op *partially* works
Wansn's avatar
Wansn committed
18
19
* Spawning monsters via console
* Inventory features (recieving items/characters, upgrading items/characters, etc)
Jaida Wu's avatar
Jaida Wu committed
20

Wansn's avatar
Wansn committed
21
## Quick setup guide
Jaida Wu's avatar
Jaida Wu committed
22

xmplay's avatar
xmplay committed
23
**Note:** For support please join our [Discord](https://discord.gg/T5vZU6UyeG).
SpikeHD's avatar
SpikeHD committed
24

Wansn's avatar
Wansn committed
25
### Requirements
Jaida Wu's avatar
Jaida Wu committed
26

xmplay's avatar
xmplay committed
27
* Java SE - 17 ([link](https://www.oracle.com/java/technologies/javase/jdk17-archive-downloads.html))
Jaida Wu's avatar
Jaida Wu committed
28

xmplay's avatar
xmplay committed
29
  **Note:** If you just want to **run it**, then **jre** only is fine.
SpikeHD's avatar
SpikeHD committed
30

Wansn's avatar
Wansn committed
31
* MongoDB (recommended 4.0+)
Jaida Wu's avatar
Jaida Wu committed
32

Wansn's avatar
Wansn committed
33
* Proxy daemon: mitmproxy (mitmdump, recommended), Fiddler Classic, etc.
Jaida Wu's avatar
Jaida Wu committed
34

Wansn's avatar
Wansn committed
35
### Running
Jaida Wu's avatar
Jaida Wu committed
36

xmplay's avatar
xmplay committed
37
**Note:** If you updated from an older version, delete `config.json` to regenerate it.
Jaida Wu's avatar
Jaida Wu committed
38

Wansn's avatar
Wansn committed
39
40
41
1. Get `grasscutter.jar`
   - Download from [actions](https://nightly.link/Grasscutters/Grasscutter/workflows/build/stable/Grasscutter.zip)
   - [Build by yourself](#Building)
xmplay's avatar
xmplay committed
42
2. Create a `resources` folder in the directory where grasscutter.jar is located and move your `BinOutput` and `ExcelBinOutput` folders there *(Check the [wiki](https://github.com/Grasscutters/Grasscutter/wiki) for more details how to get those.)*
Wansn's avatar
Wansn committed
43
3. Run Grasscutter with `java -jar grasscutter.jar`. **Make sure mongodb service is running as well.**
alt3ri's avatar
alt3ri committed
44

Wansn's avatar
Wansn committed
45
### Connecting with the client
alt3ri's avatar
alt3ri committed
46

Wansn's avatar
Wansn committed
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
½. Create an account using [server console command](#Commands).

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](https://docs.microsoft.com/en-us/skype-sdk/sdn/articles/installing-the-trusted-root-certificate#installing-a-trusted-root-certificate) or ...
    
      - Via command line
    
        ```shell
        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](https://github.lunatic.moe/fiddlerscript).
      
    - [Hosts file](https://github.com/Melledy/Grasscutter/wiki/Running#traffic-route-map)
    
2. Set network proxy to `127.0.0.1:8080` or the proxy port you specified.
alt3ri's avatar
alt3ri committed
69

Wansn's avatar
Wansn committed
70
**you can also use `start.cmd` to start servers and proxy daemons automatically**
Wansn's avatar
Wansn committed
71
72
73
74
75
76
77

### Building

Grasscutter uses Gradle to handle dependencies & building.

**Requirements:**

真心's avatar
真心 committed
78
- Java SE Development Kits - 17
Wansn's avatar
Wansn committed
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
- Git

##### Windows

```shell
git clone https://github.com/Grasscutters/Grasscutter.git
cd Grasscutter
.\gradlew.bat # Setting up environments
.\gradlew jar # Compile
```

##### Linux

```bash
git clone https://github.com/Grasscutters/Grasscutter.git
cd Grasscutter
chmod +x gradlew
./gradlew jar # Compile
```

xmplay's avatar
xmplay committed
99
You can find the output jar in the root of the project folder.
Wansn's avatar
Wansn committed
100
101
102

## Commands

Wansn's avatar
Wansn committed
103
104
105
106
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

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`

Wansn's avatar
Wansn committed
107
108
| Commands       | Usage                                             | Permission node           | Availability | description                                                  | Alias                                           |
| -------------- | ------------------------------------------------- | ------------------------- | ------------ | ------------------------------------------------------------ | ----------------------------------------------- |
xmplay's avatar
xmplay committed
109
| 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. |                                                 |
Wansn's avatar
Wansn committed
110
111
| broadcast      | broadcast <message>                               | server.broadcast          | Both side    | Sends a message to all the players.                          | b                                               |
| changescene    | changescene <scene id>                            | player.changescene        | Client only  | Switch scenes by scene ID.                                   | scene                                           |
xmplay's avatar
xmplay committed
112
113
| clearartifacts | clearartifacts                                    | player.clearartifacts     | Client only  | Deletes all unequipped and unlocked level 0 artifacts, including 5-star rarity ones from your inventory. | clearart                                        |
| clearweapons   | clearweapons                                      | player.clearweapons       | Client only  | Deletes all unequipped and unlocked weapons, including 5-star rarity ones from your inventory. | clearwpns                                       |
Wansn's avatar
Wansn committed
114
115
| drop           | drop <itemID\|itemName> [amount]                  | server.drop               | Client only  | Drops an item around you.                                    | `d` `dropitem`                                  |
| give           | give [player] <itemId\|itemName> [amount] [level] | player.give               | Both side    | Gives item(s) to you or the specified player.                | `g` `item` `giveitem`                           |
BaiSugar's avatar
BaiSugar committed
116
| givechar       | givechar <uid> <avatarId>                 | player.givechar           | Both side    | Gives the player a specified character.                      | givec                                           |
117
| giveall       | giveall [uid] [amount]             | player.giveall      | Both side    | Gives all items.      | givea                                         |
Wansn's avatar
Wansn committed
118
| godmode        | godmode [uid]                                     | player.godmode            | Client only  | Prevents you from taking damage.                             |                                                 |
xmplay's avatar
xmplay committed
119
| heal           | heal                                              | player.heal               | Client only  | Heals all characters in your current team.                    | h                                               |
Wansn's avatar
Wansn committed
120
121
| help           | help [command]                                    |                           | Both side    | Sends the help message or shows information about a specified command. |                                                 |
| kick           | kick <player>                                     | server.kick               | Both side    | Kicks the specified player from the server. (WIP)            | k                                               |
xmplay's avatar
xmplay committed
122
123
| 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.                                         |                                                 |
Wansn's avatar
Wansn committed
124
| permission     | permission <add\|remove> <username> <permission>  | *                         | Both side    | Grants or removes a permission for a user.                   |                                                 |
xmplay's avatar
xmplay committed
125
126
127
| position       | position                                          |                           | Client only  | Sends your current coordinates.                                             | pos                                             |
| reload         | reload                                            | server.reload             | Both side    | Reloads the server config                                         |                                                 |
| 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                              |
Wansn's avatar
Wansn committed
128
129
| 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` |
xmplay's avatar
xmplay committed
130
131
| 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                                           |
Wansn's avatar
Wansn committed
132
133
134
| setworldlevel  | setworldlevel <level>                             | player.setworldlevel      | Client only  | Sets your world level (Relog to see proper effects)          | setworldlvl                                     |
| spawn          | spanw <entityID\|entityName> [level] [amount]     | server.spawn              | Client only  | Spawns an entity near you                                    |                                                 |
| stop           | stop                                              | server.stop               | Both side    | Stops the server                                             |                                                 |
xmplay's avatar
xmplay committed
135
| talent         | talent <talentID> <value>                         | player.settalent          | Client only  | Sets talent level for your currently selected character           |                                                 |
Wansn's avatar
Wansn committed
136
137
138
139
140
141
142
| teleport       | teleport <x> <y> <z>                              | player.teleport           | Client only  | Change the player's position.                                | tp                                              |
| weather        | weather <weatherID> <climateID>                   | player.weather            | Client only  | Changes the weather                                          | w                                               |

### Bonus

When you want to teleport to somewhere, use the ingame marking function on Map, click Confirm. You will see your
character falling from a very high destination, exact location that you marked.
143

lunaticwhat's avatar
lunaticwhat committed
144
# Quick Troubleshooting
Wansn's avatar
Wansn committed
145

真心's avatar
真心 committed
146
* If compiling wasn't successful, please check your JDK installation (JDK 17 and validated JDK's bin PATH variable)
Wansn's avatar
Wansn committed
147
148
* 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
xmplay's avatar
xmplay committed
149
* Startup sequence: Mongodb -> Grasscutter -> Proxy daemon (mitmdump, fiddler, etc.) -> Client