Merge branch 'development' into plugin-system

.github/ISSUE_TEMPLATE/bug_report.md

+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Desktop (please complete the following information):**
+ - OS: [e.g. iOS]
+ - Browser [e.g. chrome, safari]
+ - Version [e.g. 22]
+
+**Smartphone (please complete the following information):**
+ - Device: [e.g. iPhone6]
+ - OS: [e.g. iOS8.1]
+ - Browser [e.g. stock browser, safari]
+ - Version [e.g. 22]
+
+**Additional context**
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/custom.md

+---
+name: Custom issue template
+about: Describe this issue template's purpose here.
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+

.github/ISSUE_TEMPLATE/feature_request.md

+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

.github/workflows/build.yml

@@ -3,9 +3,14 @@ on:
   push:
     branches:
       - "stable"
+  pull_request:
+    types:
+      - opened
+      - synchronize
+      - reopened
 jobs:
   Build-Server-Jar:
-    runs-on: windows-latest
+    runs-on: ubuntu-latest
     steps:
       - name: Checkout
         uses: actions/checkout@v2
@@ -13,12 +18,11 @@ jobs:
         uses: actions/setup-java@v3
         with:
           distribution: temurin
-          java-version: '8'
+          java-version: '16'
       - name: Run Gradle
-        run: .\gradlew.bat && .\gradlew jar
+        run: ./gradlew && ./gradlew jar
       - name: Upload build
         uses: actions/upload-artifact@v3
         with:
           name: Grasscutter
           path: grasscutter.jar
-      

.gitignore

@@ -45,15 +45,17 @@ tmp/
 .loadpath
 .recommenders
 
+# VSCode
+.vscode
+
 # Grasscutter
 resources/*
 logs/*
 data/AbilityEmbryos.json
 data/OpenConfig.json
-proto/auto/
-proto/protoc.exe
+proto/*
 GM Handbook.txt
 config.json
 mitmdump.exe
 grasscutter.jar
-mongod.exe
+mongod.exe
\ No newline at end of file

CODE_OF_CONDUCT.md

+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, religion, or sexual identity
+and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the
+  overall community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or
+  advances of any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email
+  address, without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official e-mail address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+[the Discord server](https://discord.gg/T5vZU6UyeG).
+All complaints will be reviewed and investigated promptly and fairly.
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series
+of actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or
+permanent ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior,  harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within
+the community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.0, available at
+https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.
+
+Community Impact Guidelines were inspired by [Mozilla's code of conduct
+enforcement ladder](https://github.com/mozilla/diversity).
+
+[homepage]: https://www.contributor-covenant.org
+
+For answers to common questions about this code of conduct, see the FAQ at
+https://www.contributor-covenant.org/faq. Translations are available at
+https://www.contributor-covenant.org/translations.
\ No newline at end of file

CONTRIBUTING.md

+# Contributing 
+
+Please note we have a code of conduct, please follow it in all your interactions with the project. If you have any further questions please create an issue or ask in the Discord server.
+
+- Only fix/add the functionality in question OR address wide-spread whitespace/style issues, not both.
+- Address a single concern in the least number of changed lines as possible.
+
+**Do not make a pull request to merge into stable unless it is a hotfix. Use the development branch instead.**
+
+## Pull Request Process
+
+1. Ensure any install or build dependencies are removed before the end of the layer when doing a build.
+2. Update the README.md and wiki with details of changes to the interface, this includes new environment variables, exposed ports, useful file locations and container parameters.
+3. Write with detail on your pull request description what you have committed, to make it easier for the collaborators to make a changelog.

README.md

-# Grasscutter
-A WIP server reimplementation for *some anime game* 2.3-2.6
+![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="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>
 
-**Documentation**: [Grasscutter Wiki](https://github.com/Melledy/Grasscutter/wiki/)  
-**Note**: For support please join the [Discord server](https://discord.gg/T5vZU6UyeG).
-# Current features
-* Logging in
-* Combat
-* Spawning monsters via console
-* Inventory features (recieving items/characters, upgrading items/characters, etc)
-* Gacha system
-* Friends list
-* Co-op *partially* work
-# Quick setup guide
-### Note
-* If you update from an older version, delete `config.json` for regeneration
-
-### Prerequisites
-* Java 16
-* Mongodb (recommended 4.0+)
-* Proxy daemon: mitmproxy (mitmdump, recommended), Fiddler Classic, etc.
+<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>
 
-### Starting up Grasscutter server (Assuming you are on Windows)
-1. Setup compile environment `gradlew.bat`
-2. Compile Grasscutter with `gradlew jar`
-3. Create a folder named `resources` in your Grasscutter directory, bring your `BinOutput` and `ExcelBinOutput` folders into it *(Check the wiki for more details how to get those.)*
-4. Run Grasscutter with `java -jar grasscutter.jar`. Make sure mongodb service is running as well.
-
-### Connecting with the client
-½. Create an account using *server console command* below
-1. Run a proxy daemon: (choose either one)
-	- mitmdump: `mitmdump -s proxy.py -k`
-	- 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. Trust CA certificate:
-	- mitmdump: `certutil -addstore root %USERPROFILE%\.mitmproxy\mitmproxy-ca-cert.cer`
-2. Set network proxy to `127.0.0.1:8080` or the proxy port you specified.
-4. *yoink*
+EN | [中文](README_zh-CN.md)
 
-* or you can use `run.cmd` to start Server & Proxy daemon with one click
+**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).
 
-# Grasscutter commands
-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.
+## Current features
 
-`account create [username] {playerid}` - Creates an account with the specified username and the in-game uid for that account. The playerid parameter is optional and will be auto generated if not set.
+* Logging in
+* Combat
+* Friends list
+* Teleportation
+* Gacha system
+* Co-op *partially* work
+* Spawning monsters via console
+* Inventory features (recieving items/characters, upgrading items/characters, etc)
 
-`spawn [monster id] [level] [amount]`
+## Quick setup guide
 
-`give [item id] [amount]`
+**Note:** for support please join our [Discord](https://discord.gg/T5vZU6UyeG)
 
-`givechar [avatar id] [level]`
+### Requirements
 
-`drop [item id] [amount]`
+* Java SE - 16 ([mirror link](https://github.com/adoptium/temurin16-binaries/releases/tag/jdk-16.0.2+7) since Oracle required an account to download old builds)
 
-`killall`
+  **Note:** If you just want to **run it**, then **jre** is fine 
 
-`setworldlevel [level]` - Relog to see effects properly
+* MongoDB (recommended 4.0+)
 
-`godmode` - Prevents you from taking damage
+* Proxy daemon: mitmproxy (mitmdump, recommended), Fiddler Classic, etc.
 
-`resetconst` - Resets the constellation level on your current active character, will need to relog after using the command to see any changes.
+### Running
 
-`setstats [stats] [amount]` - Changes the current character's specified stat.
+**Note:** If you update from an older version, delete `config.json` for regeneration
 
-`clearartifacts` - Deletes all unequipped and unlocked level 0 artifacts, **including yellow rarity ones** from your inventory
+1. Get `grasscutter.jar`
+   - Download from [actions](https://nightly.link/Grasscutters/Grasscutter/workflows/build/stable/Grasscutter.zip)
+   - [Build by yourself](#Building)
+2. Create a `resources` folder in the directory where grasscutter.jar is located and bring your `BinOutput` and `ExcelBinOutput` folders into it *(Check the [wiki](https://github.com/Grasscutters/Grasscutter/wiki) for more details how to get those.)*
+3. Run Grasscutter with `java -jar grasscutter.jar`. **Make sure mongodb service is running as well.**
 
-`pos` - Gets your current coordinate.
+### Connecting with the client
 
-`weather [weather id] [climate id]` - Changes the current weather.
+½. 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.
 
-*More commands will be updated in the [wiki](https://github.com/Melledy/Grasscutter/wiki/).*
+**you can also use `start.cmd` to start servers and proxy daemons automatically**
+
+### Building
+
+Grasscutter uses Gradle to handle dependencies & building.
+
+**Requirements:**
+
+- Java SE Development Kits - 16
+- 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
+```
+
+You can find the output jar in the root of the project folder
+
+## Commands
+
+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`
+
+| Commands       | Usage                                             | Permission node           | Availability | description                                                  | Alias                                           |
+| -------------- | ------------------------------------------------- | ------------------------- | ------------ | ------------------------------------------------------------ | ----------------------------------------------- |
+| 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. |                                                 |
+| 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                                           |
+| clearartifacts | clearartifacts                                    | player.clearartifacts     | Client only  | Deletes all unequipped and unlocked level 0 artifacts, including yellow rarity ones from your inventory. | clearart                                        |
+| clearweapons   | clearweapons                                      | player.clearweapons       | Client only  | Deletes all unequipped and unlocked weapons, including yellow rarity ones from your inventory. | clearwpns                                       |
+| 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`                           |
+| givechar       | givechar <uid> <avatarId> [level]                 | player.givechar           | Both side    | Gives the player a specified character.                      | givec                                           |
+| godmode        | godmode [uid]                                     | player.godmode            | Client only  | Prevents you from taking damage.                             |                                                 |
+| heal           | heal                                              | player.heal               | Client only  | Heal all characters in your current team.                    | h                                               |
+| 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                                               |
+| killall        | killall [playerUid] [sceneId]                     | server.killall            | Both side    | Kill all entities in the current scene or specified scene of the corresponding player. |                                                 |
+| list           | list                                              |                           | Both side    | List online players.                                         |                                                 |
+| permission     | permission <add\|remove> <username> <permission>  | *                         | Both side    | Grants or removes a permission for a user.                   |                                                 |
+| position       | position                                          |                           | Client only  | Get coordinates.                                             | pos                                             |
+| reload         | reload                                            | server.reload             | Both side    | Reload server config                                         |                                                 |
+| resetconst     | resetconst [all]                                  | player.resetconstellation | Client only  | Resets the constellation level on your current active character, will need to relog after using the command to see any changes. | resetconstellation                              |
+| 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` |
+| setfetterlevel | setfetterlevel <level>                            | player.setfetterlevel     | Client only  | Sets your fetter level for your current active character     | setfetterlvl                                    |
+| setstats       | setstats <stat> <value>                           | player.setstats           | Client only  | Set fight property for your current active character         | stats                                           |
+| 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                                             |                                                 |
+| talent         | talent <talentID> <value>                         | player.settalent          | Client only  | Set talent level for your current active character           |                                                 |
+| 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.
+
+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.
 
 # Quick Troubleshooting
-* If compiling wasn't successful, please check your JDK installation (must be JDK 8 and validated JDK's bin PATH variable)
-* 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
+
+* If compiling wasn't successful, please check your JDK installation (JDK 16 and validated JDK's bin PATH variable)
+* 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
 * Startup sequence: Mongodb > Grasscutter > Proxy daemon (mitmdump, fiddler, etc.) > Client

README_zh-CN.md

+![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="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>
+
+<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) | 中文
+
+**注意:** 我们一直欢迎您成为该项目的贡献者。在添加您的代码之前，请仔细阅读我们的 [代码规范](https://github.com/Grasscutters/Grasscutter/blob/stable/CONTRIBUTING.md).
+
+## 当前特性
+
+* 登录
+* 战斗
+* 好友列表
+* 传送系统
+* 祈愿系统
+* 从控制台生成魔物
+* 多人游戏 *部分* 可用
+* 物品栏相关 (接收物品/角色, 升级角色/武器等)
+
+## 快速设置指南
+
+**附:** 加入我们的 [Discord](https://discord.gg/T5vZU6UyeG) 获取更多帮助！
+
+### 环境需求
+
+* Java SE - 16 (当您没有Oracle账户，可以使用[镜像](https://github.com/adoptium/temurin16-binaries/releases/tag/jdk-16.0.2+7))
+
+  **注:** 如果您仅仅想要简单地**运行服务端**, 那么使用 **jre** 便足够了 
+
+* MongoDB (推荐 4.0+)
+
+* Proxy daemon: mitmproxy (推荐使用mitmdump), Fiddler Classic, 等
+
+### 运行
+
+**注:** 如果您从旧版本升级到新版本，最好删除 `config.json` 并启动服务端jar来重新生成它
+
+1. 获取 `grasscutter.jar`
+   - 从 [actions](https://nightly.link/Grasscutters/Grasscutter/workflows/build/stable/Grasscutter.zip) 中下载
+   - [自行构建](#构建)
+2. 在**grasscutter.jar** 所在目录中创建 `resources` 文件夹并将 `BinOutput` 和 `ExcelBinOutput` 放入其中 *(查看 [wiki](https://github.com/Grasscutters/Grasscutter/wiki) 了解更多)*
+3. 通过命令 `java -jar grasscutter.jar` 来运行Grasscutter. **在此之前请确认MongoDB服务运行正常**
+
+### 连接
+
+½. 在服务器控制台中 [创建账户](#命令列表).
+
+1. 重定向流量: (选其一)
+    - mitmdump:  `mitmdump -s proxy.py -k`
+    
+      信任 CA 证书:
+    
+      ​	**注:** mitmproxy的CA证书通常存放在 `% USERPROFILE%\ .mitmproxy`, 或者你也可以从`http://mitm.it` 中下载它
+    
+      ​	双击来[安装根证书](https://docs.microsoft.com/en-us/skype-sdk/sdn/articles/installing-the-trusted-root-certificate#installing-a-trusted-root-certificate) 或者..
+    
+      - 使用命令行
+    
+        ```shell
+        certutil -addstore root %USERPROFILE%\.mitmproxy\mitmproxy-ca-cert.cer
+        ```
+    
+    - Fiddler Classic: 运行Fiddler Classic, 在设置中开启 `解密https通信` 并将端口切换到除`8888` 以外的任意端口 (工具 -> 选项 -> 连接) 并加载 [此脚本](https://github.lunatic.moe/fiddlerscript).
+      
+    - [Hosts文件](https://github.com/Grasscutters/Grasscutter/wiki/Running#traffic-route-map)
+    
+2. 设置代理为 `127.0.0.1:8080` 或其它你所设定的端口
+
+**你也可以简单地运行 `start.cmd` 来全自动启动服务端并设置代理**
+
+### 构建
+
+Grasscutter 使用 Gradle 来处理依赖及构建.
+
+**依赖:**
+
+- Java SE Development Kits - 16
+- 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
+```
+
+你可以在项目根目录中找到`grasscutter.jar`
+
+## 命令列表
+
+你可能需要在终端中运行 `java -jar grasscutter.jar -handbook` 它将会创建一个 `GM Handbook.txt` 以方便您查阅物品ID等
+
+在每个玩家的朋友列表中都有一个名为“服务器”的虚拟用户，你可以通过发送消息来使用命令。命令也适用于其他聊天室，例如私人/团队聊天。
+要在游戏中使用命令，需要添加 `/` 或 `!` 前缀，如 `/pos`
+
+| 命令           | 用法                                         | 权限节点                  | 可用性   | 注释                                       | 别名                                            |
+| -------------- | -------------------------------------------- | ------------------------- | -------- | ------------------------------------------ | ----------------------------------------------- |
+| account        | account <create\|delete> <用户名> [uid]      |                           | 仅服务端 | 通过指定用户名和uid增删账户                |                                                 |
+| broadcast      | broadcast <消息内容>                         | server.broadcast          | 均可使用 | 给所有玩家发送公告                         | b                                               |
+| changescene    | changescene <场景ID>                         | player.changescene        | 仅客户端 | 切换到指定场景                             | scene                                           |
+| clearartifacts | clearartifacts                               | player.clearartifacts     | 仅客户端 | 删除所有未装备及未解锁的圣遗物,包括五星    | clearart                                        |
+| clearweapons   | clearweapons                                 | player.clearweapons       | 仅客户端 | 删除所有未装备及未解锁的武器,包括五星      | clearwp                                         |
+| drop           | drop <物品ID\|物品名称> [数量]               | server.drop               | 仅客户端 | 在指定玩家周围掉落指定物品                 | `d` `dropitem`                                  |
+| give           | give [uid] <物品ID\|物品名称> [数量] [等级]  |                           |          | 给予指定玩家一定数量及等级的物品           | `g` `item` `giveitem`                           |
+| givechar       | givechar <uid> <角色ID> [等级]               | player.givechar           | 均可使用 | 给予指定玩家对应角色                       | givec                                           |
+| godmode        | godmode [uid]                                | player.godmode            | 仅客户端 | 保护你不受到任何伤害(依然会被击退)         |                                                 |
+| heal           | heal                                         | player.heal               | 仅客户端 | 治疗队伍中所有角色                         | h                                               |
+| help           | help [命令]                                  |                           | 均可使用 | 显示帮助或展示指定命令的帮助               |                                                 |
+| kick           | kick <uid>                                   | server.kick               | 均可使用 | 从服务器中踢出指定玩家 (WIP)               | k                                               |
+| killall        | killall [uid] [场景ID]                       | server.killall            | 均可使用 | 杀死指定玩家世界中所在或指定场景的全部生物 |                                                 |
+| list           | list                                         |                           | 均可使用 | 列出在线玩家                               |                                                 |
+| permission     | permission <add\|remove> <用户名> <权限节点> | *                         | 均可使用 | 添加或移除玩家的权限                       |                                                 |
+| position       | position                                     |                           | 仅客户端 | 获取当前坐标                               | pos                                             |
+| reload         | reload                                       | server.reload             | 均可使用 | 重载服务器配置                             |                                                 |
+| resetconst     | resetconst [all]                             | player.resetconstellation | 仅客户端 | 重置当前角色的命座,重新登录即可生效        | resetconstellation                              |
+| restart        | restart                                      |                           | 均可使用 | 重启服务端                                 |                                                 |
+| say            | say <uid> <消息>                             | server.sendmessage        | 均可使用 | 作为服务器发送消息给玩家                   | `sendservmsg` `sendservermessage` `sendmessage` |
+| setfetterlevel | setfetterlevel <好感等级>                    | player.setfetterlevel     | 仅客户端 | 设置当前角色的好感等级                     | `setfetterlvl` `setfriendship`                  |
+| setstats       | setstats <属性> <数值>                       | player.setstats           | 仅客户端 | 直接修改当前角色的面板                     | stats                                           |
+| setworldlevel  | setworldlevel <世界等级>                     | player.setworldlevel      | 仅客户端 | 设置世界等级(重新登陆即可生效)             | setworldlvl                                     |
+| spawn          | spanw <实体ID\|实体名称> [等级] [数量]       | server.spawn              | 仅客户端 | 在你周围生成实体                           |                                                 |
+| stop           | stop                                         | server.stop               | 均可使用 | 停止服务器                                 |                                                 |
+| talent         | talent <天赋ID> <等级>                       | player.settalent          | 仅客户端 | 设置当前角色的天赋等级                     |                                                 |
+| teleport       | teleport <x> <y> <z>                         | player.teleport           | 仅客户端 | 传送玩家到指定坐标                         | tp                                              |
+| weather        | weather <天气ID> <气候ID>                    | player.weather            | 仅客户端 | 改变天气                                   | w                                               |
+
+### 额外功能
+
+当你想传送到某个地点, 只需要在地图中创建标记, 关闭地图后即可到达目标地点上空
+
+# 快速排除问题
+
+* 如果编译未能成功,请检查您的jdk安装 (JDK 16并确认jdk处于环境变量`PATH`中
+* 我的客户端无法登录/连接, 4206, 其它... - 大部分情况下这是因为您的代理存在问题.如果使用Fiddler请确认Fiddler监听端口不是`8888`
+* 启动顺序: MongoDB > Grasscutter > 代理程序 (mitmdump, fiddler等.) > 客户端

build.gradle

@@ -25,12 +25,12 @@ dependencies {
     implementation fileTree(dir: 'lib', include: ['*.jar'])
     
 	implementation group: 'org.slf4j', name: 'slf4j-api', version: '1.7.32'
-	implementation group: 'ch.qos.logback', name: 'logback-core', version: '1.2.6'
-    implementation group: 'ch.qos.logback', name: 'logback-classic', version: '1.2.6'
-    implementation group: 'io.netty', name: 'netty-all', version: '4.1.69.Final'
+	implementation group: 'ch.qos.logback', name: 'logback-core', version: '1.2.9'
+    implementation group: 'ch.qos.logback', name: 'logback-classic', version: '1.2.9'
+    implementation group: 'io.netty', name: 'netty-all', version: '4.1.71.Final'
     
 	implementation group: 'com.google.code.gson', name: 'gson', version: '2.8.8'
-	implementation group: 'com.google.protobuf', name: 'protobuf-java', version: '3.18.1'
+	implementation group: 'com.google.protobuf', name: 'protobuf-java', version: '3.18.2'
 	
 	implementation group: 'org.reflections', name: 'reflections', version: '0.10.2'
 

src/main/java/emu/grasscutter/Grasscutter.java

@@ -129,6 +129,7 @@ public final class Grasscutter {
 	
 	public static void startConsole() {
 		String input;
+		getLogger().info("Done! For help, type \"help\"");
 		try (BufferedReader br = new BufferedReader(new InputStreamReader(System.in))) {
 			while ((input = br.readLine()) != null) {
 				try {

src/main/java/emu/grasscutter/command/commands/ClearArtifactsCommand.java

-package emu.grasscutter.command.commands;
-
-import emu.grasscutter.command.Command;
-import emu.grasscutter.command.CommandHandler;
-import emu.grasscutter.game.GenshinPlayer;
-import emu.grasscutter.game.inventory.Inventory;
-import emu.grasscutter.game.inventory.ItemType;
-
-import java.util.List;
-
-@Command(label = "clearartifacts", usage = "clearartifacts",
-        description = "Deletes all unequipped and unlocked level 0 artifacts, including yellow rarity ones from your inventory",
-        aliases = {"clearart"}, permission = "player.clearartifacts")
-public final class ClearArtifactsCommand implements CommandHandler {
-
-    @Override
-    public void execute(GenshinPlayer sender, List<String> args) {
-        if (sender == null) {
-            CommandHandler.sendMessage(null, "Run this command in-game.");
-            return; // TODO: clear player's artifacts from console or other players
-        }
-
-        Inventory playerInventory = sender.getInventory();
-        playerInventory.getItems().values().stream()
-                .filter(item -> item.getItemType() == ItemType.ITEM_RELIQUARY)
-                .filter(item -> item.getLevel() == 1 && item.getExp() == 0)
-                .filter(item -> !item.isLocked() && !item.isEquipped())
-                .forEach(item -> playerInventory.removeItem(item, item.getCount()));
-    }
-}

src/main/java/emu/grasscutter/command/commands/ClearCommand.java

+package emu.grasscutter.command.commands;
+
+import emu.grasscutter.Grasscutter;
+import emu.grasscutter.command.Command;
+import emu.grasscutter.command.CommandHandler;
+import emu.grasscutter.data.GenshinData;
+import emu.grasscutter.data.def.ItemData;
+import emu.grasscutter.game.GenshinPlayer;
+import emu.grasscutter.game.inventory.GenshinItem;
+import emu.grasscutter.game.inventory.Inventory;
+import emu.grasscutter.game.inventory.ItemType;
+
+import java.util.Collection;
+import java.util.LinkedList;
+import java.util.List;
+
+@Command(label = "clear", usage = "clear <all|wp|art|mat>", //Merged /clearartifacts and /clearweapons to /clear <args> [uid]
+        description = "Deletes unequipped unlocked items, including yellow rarity ones from your inventory",
+        aliases = {"clear"}, permission = "player.clearinv")
+
+public final class ClearCommand implements CommandHandler {
+
+    @Override
+    public void execute(GenshinPlayer sender, List<String> args) {
+        int target;
+        if (sender == null) {
+            CommandHandler.sendMessage(null, "Run this command in-game.");
+            return; 
+        }
+        String cmdSwitch = args.get(1);
+        
+        Inventory playerInventory = sender.getInventory();
+            try {
+                target = Integer.parseInt(args.get(0));
+                GenshinPlayer targetPlayer = Grasscutter.getGameServer().getPlayerByUid(target);
+                if (targetPlayer == null && sender != null) {
+                    target = sender.getUid();
+                } else {
+                    switch (cmdSwitch){
+                        case "wp":
+                            playerInventory.getItems().values().stream()
+                            .filter(item -> item.getItemType() == ItemType.ITEM_WEAPON)
+                            .filter(item -> !item.isLocked() && !item.isEquipped())
+                            .forEach(item -> playerInventory.removeItem(item, item.getCount()));
+                            sender.dropMessage("Cleared weapons for " + targetPlayer.getNickname() + " .");
+                        break;
+                        case "art":
+                            playerInventory.getItems().values().stream()
+                            .filter(item -> item.getItemType() == ItemType.ITEM_RELIQUARY)
+                            .filter(item -> item.getLevel() == 1 && item.getExp() == 0)
+                            .filter(item -> !item.isLocked() && !item.isEquipped())
+                            .forEach(item -> playerInventory.removeItem(item, item.getCount()));
+                            sender.dropMessage("Cleared artifacts for " + targetPlayer.getNickname() + " .");
+                        break;
+                        case "mat":
+                            playerInventory.getItems().values().stream()
+                            .filter(item -> item.getItemType() == ItemType.ITEM_MATERIAL)
+                            .filter(item -> item.getLevel() == 1 && item.getExp() == 0)
+                            .filter(item -> !item.isLocked() && !item.isEquipped())
+                            .forEach(item -> playerInventory.removeItem(item, item.getCount()));
+                            sender.dropMessage("Cleared artifacts for " + targetPlayer.getNickname() + " .");
+                        break;
+                        case "all":
+                            playerInventory.getItems().values().stream()
+                            .filter(item1 -> item1.getItemType() == ItemType.ITEM_RELIQUARY)
+                            .filter(item1 -> item1.getLevel() == 1 && item1.getExp() == 0)
+                            .filter(item1 -> !item1.isLocked() && !item1.isEquipped())
+                            .forEach(item1 -> playerInventory.removeItem(item1, item1.getCount()));
+                            playerInventory.getItems().values().stream()
+                            .filter(item2 -> item2.getItemType() == ItemType.ITEM_MATERIAL)
+                            .filter(item2 -> !item2.isLocked() && !item2.isEquipped())
+                            .forEach(item2 -> playerInventory.removeItem(item2, item2.getCount()));
+                            playerInventory.getItems().values().stream()
+                            .filter(item3 -> item3.getItemType() == ItemType.ITEM_WEAPON)
+                            .filter(item3 -> item3.getLevel() == 1 && item3.getExp() == 0)
+                            .filter(item3 -> !item3.isLocked() && !item3.isEquipped())
+                            .forEach(item3 -> playerInventory.removeItem(item3, item3.getCount()));
+                            playerInventory.getItems().values().stream()
+                            .filter(item4 -> item4.getItemType() == ItemType.ITEM_FURNITURE)
+                            .filter(item4 -> !item4.isLocked() && !item4.isEquipped())
+                            .forEach(item4 -> playerInventory.removeItem(item4, item4.getCount()));
+                            playerInventory.getItems().values().stream()
+                            .filter(item5 -> item5.getItemType() == ItemType.ITEM_DISPLAY)
+                            .filter(item5 -> !item5.isLocked() && !item5.isEquipped())
+                            .forEach(item5 -> playerInventory.removeItem(item5, item5.getCount()));
+                            playerInventory.getItems().values().stream()
+                            .filter(item6 -> item6.getItemType() == ItemType.ITEM_VIRTUAL)
+                            .filter(item6 -> !item6.isLocked() && !item6.isEquipped())
+                            .forEach(item6 -> playerInventory.removeItem(item6, item6.getCount()));
+                            sender.dropMessage("Cleared everything for " + targetPlayer.getNickname() + " .");
+                        break;
+                    }
+                }
+            } catch (NumberFormatException ignored) {
+                // TODO: Parse from item name using GM Handbook.
+                CommandHandler.sendMessage(sender, "Invalid playerId.");
+                return;
+            }
+
+        GenshinPlayer targetPlayer = Grasscutter.getGameServer().getPlayerByUid(target);
+        if (targetPlayer == null) {
+            CommandHandler.sendMessage(sender, "Player not found.");
+            return;
+        }
+    }
+}

src/main/java/emu/grasscutter/command/commands/ClearWeaponsCommand.java

-package emu.grasscutter.command.commands;
-
-import emu.grasscutter.command.Command;
-import emu.grasscutter.command.CommandHandler;
-import emu.grasscutter.game.GenshinPlayer;
-import emu.grasscutter.game.inventory.Inventory;
-import emu.grasscutter.game.inventory.ItemType;
-
-import java.util.List;
-
-@Command(label = "clearweapons", usage = "clearweapons",
-        description = "Deletes all unequipped and unlocked weapons, including yellow rarity ones from your inventory",
-        aliases = {"clearwpns"}, permission = "player.clearweapons")
-public final class ClearWeaponsCommand implements CommandHandler {
-
-    @Override
-    public void execute(GenshinPlayer sender, List<String> args) {
-        if (sender == null) {
-            CommandHandler.sendMessage(null, "Run this command in-game.");
-            return; // TODO: clear player's weapons from console or other players
-        }
-
-        Inventory playerInventory = sender.getInventory();
-        playerInventory.getItems().values().stream()
-                .filter(item -> item.getItemType() == ItemType.ITEM_WEAPON)
-                .filter(item -> !item.isLocked() && !item.isEquipped())
-                .forEach(item -> playerInventory.removeItem(item, item.getCount()));
-    }
-}

src/main/java/emu/grasscutter/command/commands/GiveCommand.java

@@ -13,16 +13,15 @@ import emu.grasscutter.server.packet.send.PacketItemAddHintNotify;
 import java.util.LinkedList;
 import java.util.List;
 
-@Command(label = "give", usage = "give [player] <itemId|itemName> [amount]",
-        description = "Gives an item to you or the specified player", aliases = {"g", "item", "giveitem"}, permission = "player.give")
+@Command(label = "give", usage = "give [player] <itemId|itemName> [amount] [level]", description = "Gives an item to you or the specified player", aliases = {
+        "g", "item", "giveitem" }, permission = "player.give")
 public final class GiveCommand implements CommandHandler {
 
     @Override
     public void execute(GenshinPlayer sender, List<String> args) {
-        int target, item, amount = 1;
-
+        int target, item, lvl, amount = 1;
         if (sender == null && args.size() < 2) {
-            CommandHandler.sendMessage(null, "Usage: give <player> <itemId|itemName> [amount]");
+            CommandHandler.sendMessage(null, "Usage: give <player> <itemId|itemName> [amount] [level]");
             return;
         }
 
@@ -34,6 +33,7 @@ public final class GiveCommand implements CommandHandler {
                 try {
                     item = Integer.parseInt(args.get(0));
                     target = sender.getUid();
+                    lvl = 1;
                 } catch (NumberFormatException ignored) {
                     // TODO: Parse from item name using GM Handbook.
                     CommandHandler.sendMessage(sender, "Invalid item id.");
@@ -43,6 +43,7 @@ public final class GiveCommand implements CommandHandler {
             case 2: // <itemId|itemName> [amount] | [player] <itemId|itemName>
                 try {
                     target = Integer.parseInt(args.get(0));
+                    lvl = 1;
 
                     if (Grasscutter.getGameServer().getPlayerByUid(target) == null && sender != null) {
                         target = sender.getUid();
@@ -57,17 +58,39 @@ public final class GiveCommand implements CommandHandler {
                     return;
                 }
                 break;
-            case 3: // [player] <itemId|itemName> [amount]
+            case 3: // [player] <itemId|itemName> [amount] | <itemId|itemName> [amount] [level]
+                try {
+                    target = Integer.parseInt(args.get(0));
+
+                    if (Grasscutter.getGameServer().getPlayerByUid(target) == null && sender != null) {
+                        target = sender.getUid();
+                        item = Integer.parseInt(args.get(0));
+                        amount = Integer.parseInt(args.get(1));
+                        lvl = Integer.parseInt(args.get(2));
+                    } else {
+                        item = Integer.parseInt(args.get(1));
+                        amount = Integer.parseInt(args.get(2));
+                        lvl = 1;
+                    }
+
+                } catch (NumberFormatException ignored) {
+                    // TODO: Parse from item name using GM Handbook.
+                    CommandHandler.sendMessage(sender, "Invalid item or player ID.");
+                    return;
+                }
+                break;
+            case 4: // [player] <itemId|itemName> [amount] [level]
                 try {
                     target = Integer.parseInt(args.get(0));
 
                     if (Grasscutter.getGameServer().getPlayerByUid(target) == null) {
                         CommandHandler.sendMessage(sender, "Invalid player ID.");
                         return;
+                    } else {
+                        item = Integer.parseInt(args.get(1));
+                        amount = Integer.parseInt(args.get(2));
+                        lvl = Integer.parseInt(args.get(3));
                     }
-
-                    item = Integer.parseInt(args.get(1));
-                    amount = Integer.parseInt(args.get(2));
                 } catch (NumberFormatException ignored) {
                     // TODO: Parse from item name using GM Handbook.
                     CommandHandler.sendMessage(sender, "Invalid item or player ID.");
@@ -89,16 +112,37 @@ public final class GiveCommand implements CommandHandler {
             return;
         }
 
-        this.item(targetPlayer, itemData, amount);
+        this.item(targetPlayer, itemData, amount, lvl);
 
-        CommandHandler.sendMessage(sender, String.format("Given %s of %s to %s.", amount, item, target));
+        if (!itemData.isEquip())
+            CommandHandler.sendMessage(sender, String.format("Given %s of %s to %s.", amount, item, target));
+        else
+            CommandHandler.sendMessage(sender,
+                    String.format("Given %s with level %s %s times to %s", item, lvl, amount, target));
     }
 
-    private void item(GenshinPlayer player, ItemData itemData, int amount) {
+    private void item(GenshinPlayer player, ItemData itemData, int amount, int lvl) {
         if (itemData.isEquip()) {
             List<GenshinItem> items = new LinkedList<>();
             for (int i = 0; i < amount; i++) {
-                items.add(new GenshinItem(itemData));
+                GenshinItem item = new GenshinItem(itemData);
+                item.setCount(amount);
+                item.setLevel(lvl);
+                item.setPromoteLevel(0);
+                if (lvl > 20) { // 20/40
+                    item.setPromoteLevel(1);
+                } else if (lvl > 40) { // 40/50
+                    item.setPromoteLevel(2);
+                } else if (lvl > 50) { // 50/60
+                    item.setPromoteLevel(3);
+                } else if (lvl > 60) { // 60/70
+                    item.setPromoteLevel(4);
+                } else if (lvl > 70) { // 70/80
+                    item.setPromoteLevel(5);
+                } else if (lvl > 80) { // 80/90
+                    item.setPromoteLevel(6);
+                }
+                items.add(item);
             }
             player.getInventory().addItems(items);
             player.sendPacket(new PacketItemAddHintNotify(items, ActionReason.SubfieldDrop));
@@ -110,4 +154,3 @@ public final class GiveCommand implements CommandHandler {
         }
     }
 }
-

src/main/java/emu/grasscutter/command/commands/GodModeCommand.java

 package emu.grasscutter.command.commands;
 
+import emu.grasscutter.Grasscutter;
 import emu.grasscutter.command.Command;
 import emu.grasscutter.command.CommandHandler;
 import emu.grasscutter.game.GenshinPlayer;
@@ -16,7 +17,29 @@ public final class GodModeCommand implements CommandHandler {
             CommandHandler.sendMessage(null, "Run this command in-game.");
             return; // TODO: toggle player's godmode statue from console or other players
         }
-        sender.setGodmode(!sender.inGodmode());
-        sender.dropMessage("Godmode is now " + (sender.inGodmode() ? "enabled" : "disabled") + ".");
+
+        int target;
+        if (args.size() == 1) {
+            try {
+                target = Integer.parseInt(args.get(0));
+                if (Grasscutter.getGameServer().getPlayerByUid(target) == null) {
+                    target = sender.getUid();
+                }
+            } catch (NumberFormatException e) {
+                CommandHandler.sendMessage(sender, "Invalid player id.");
+                return;
+            }
+        } else {
+            target = sender.getUid();
+        }
+        GenshinPlayer targetPlayer = Grasscutter.getGameServer().getPlayerByUid(target);
+        if (targetPlayer == null) {
+            CommandHandler.sendMessage(sender, "Player not found.");
+            return;
+        }
+
+        targetPlayer.setGodmode(!targetPlayer.inGodmode());
+        sender.dropMessage("Godmode is now " + (targetPlayer.inGodmode() ? "enabled" : "disabled") +
+                "for " + targetPlayer.getNickname() + " .");
     }
 }

src/main/java/emu/grasscutter/command/commands/KillCharacterCommand.java

+package emu.grasscutter.command.commands;
+
+import emu.grasscutter.Grasscutter;
+import emu.grasscutter.command.Command;
+import emu.grasscutter.command.CommandHandler;
+import emu.grasscutter.game.GenshinPlayer;
+import emu.grasscutter.game.entity.EntityAvatar;
+import emu.grasscutter.game.props.FightProperty;
+import emu.grasscutter.game.props.LifeState;
+import emu.grasscutter.server.packet.send.PacketEntityFightPropUpdateNotify;
+import emu.grasscutter.server.packet.send.PacketLifeStateChangeNotify;
+
+import java.util.List;
+
+@Command(label = "killcharacter", usage = "killcharacter [playerId]", aliases = {"suicide", "kill"},
+        description = "Kills the players current character", permission = "player.killcharacter")
+public final class KillCharacterCommand implements CommandHandler {
+
+    @Override
+    public void execute(GenshinPlayer sender, List<String> args) {
+        int target;
+        if (sender == null) {
+            // from console
+            if (args.size() == 1) {
+                try {
+                    target = Integer.parseInt(args.get(0));
+                } catch (NumberFormatException e) {
+                    CommandHandler.sendMessage(null, "Invalid player id.");
+                    return;
+                }
+            } else {
+                CommandHandler.sendMessage(null, "Usage: /killcharacter [playerId]");
+                return;
+            }
+        } else {
+            if (args.size() == 1) {
+                try {
+                    target = Integer.parseInt(args.get(0));
+                    if (Grasscutter.getGameServer().getPlayerByUid(target) == null) {
+                        target = sender.getUid();
+                    }
+                } catch (NumberFormatException e) {
+                    CommandHandler.sendMessage(sender, "Invalid player id.");
+                    return;
+                }
+            } else {
+                target = sender.getUid();
+            }
+        }
+
+        GenshinPlayer targetPlayer = Grasscutter.getGameServer().getPlayerByUid(target);
+        if (targetPlayer == null) {
+            CommandHandler.sendMessage(sender, "Player not found or offline.");
+            return;
+        }
+
+        EntityAvatar entity = targetPlayer.getTeamManager().getCurrentAvatarEntity();
+        entity.setFightProperty(FightProperty.FIGHT_PROP_CUR_HP, 0f);
+        // Packets
+        entity.getWorld().broadcastPacket(new PacketEntityFightPropUpdateNotify(entity, FightProperty.FIGHT_PROP_CUR_HP));
+        entity.getWorld().broadcastPacket(new PacketLifeStateChangeNotify(0, entity, LifeState.LIFE_DEAD));
+        // remove
+        targetPlayer.getScene().removeEntity(entity);
+        entity.onDeath(0);
+
+        CommandHandler.sendMessage(sender, "Killed " + targetPlayer.getNickname() + " current character.");
+    }
+}

src/main/java/emu/grasscutter/command/commands/PositionCommand.java

@@ -17,6 +17,7 @@ public final class PositionCommand implements CommandHandler {
             return;
         }
 
-        sender.dropMessage(String.format("Coord: %.3f, %.3f, %.3f", sender.getPos().getX(), sender.getPos().getY(), sender.getPos().getZ()));
+        sender.dropMessage(String.format("Coord: %.3f, %.3f, %.3f\nScene id: %d",
+                sender.getPos().getX(), sender.getPos().getY(), sender.getPos().getZ(), sender.getSceneId()));
     }
 }

src/main/java/emu/grasscutter/command/commands/SetFetterLevelCommand.java

+package emu.grasscutter.command.commands;
+
+import java.util.List;
+
+import emu.grasscutter.command.Command;
+import emu.grasscutter.command.CommandHandler;
+import emu.grasscutter.data.GenshinData;
+import emu.grasscutter.game.GenshinPlayer;
+import emu.grasscutter.game.avatar.GenshinAvatar;
+import emu.grasscutter.server.packet.send.PacketAvatarFetterDataNotify;
+
+@Command(label = "setfetterlevel", usage = "setfetterlevel <level>",
+        description = "Sets your fetter level for your current active character",
+        aliases = {"setfetterlvl", "setfriendship"}, permission = "player.setfetterlevel")
+public final class SetFetterLevelCommand implements CommandHandler {
+
+    @Override
+    public void execute(GenshinPlayer sender, List<String> args) {
+        if (sender == null) {
+            CommandHandler.sendMessage(null, "Run this command in-game.");
+            return;
+        }
+
+        if (args.size() < 1) {
+            CommandHandler.sendMessage(sender, "Usage: setfetterlevel <level>");
+            return;
+        }
+
+        try {
+            int fetterLevel = Integer.parseInt(args.get(0));
+            if (fetterLevel < 0 || fetterLevel > 10) {
+                CommandHandler.sendMessage(sender, "Fetter level must be between 0 and 10.");
+                return;
+            }
+            GenshinAvatar avatar = sender.getTeamManager().getCurrentAvatarEntity().getAvatar();
+
+            avatar.setFetterLevel(fetterLevel);
+            if (fetterLevel != 10) {
+                avatar.setFetterExp(GenshinData.getAvatarFetterLevelDataMap().get(fetterLevel).getExp());
+            }
+		    avatar.save();
+		
+		    sender.sendPacket(new PacketAvatarFetterDataNotify(avatar));
+            CommandHandler.sendMessage(sender, "Fetter level set to " + fetterLevel);
+        } catch (NumberFormatException ignored) {
+            CommandHandler.sendMessage(null, "Invalid fetter level.");
+        }
+    }
+    
+}