GrasscuttersWebDashboard

Grasscutters的工具箱

一款Grasscutters的WEB控制面板插件（网页工具箱）

更新说明

2022年9月2日 6.3及其以上版本是针对割草机1.2.3-dev #70ce93b最新版本的一个修复

2022年8月26日 6.2及其以上版本是针对割草机1.2.3-dev分支最新版本的一个修复

2022年8月1日 6.1及其以上版本是针对割草机1.2.3-dev分支最新版本

2022年6月24日 6.0及其以上版本是针对割草机1.2.2-dev分支最新版本

2022年5月15日 4.x及其以上版本是针对割草机1.1.2-dev分支最新版本开发的，1.1.1-dev版本的割草机请使用3.0.0版本

2022年5月14日 2.x-3.x及其以上版本是针对割草机1.1.1-dev版本开发的，如果你使用的是割草机1.0版本请安装1.x版本的插件

2.0版本更新需要删除1.0版本的配置文件！！

推荐一下我的另一款插件：

liujiaqi7998/EasyGrasscutters: 蓝图游戏设计插件，一款可以自由设计的Grasscutters插件 (github.com)

---

• 服主WEB控制台
• 服务器成员WebTools网页管理器（2.x版本功能完善）
• tpm万能传送标记功能（3.x版本新增）

服主控制台使用方法（安装指南）

1.在Releases · liujiaqi7998/GrasscuttersWebDashboard (github.com)下载GrasscuttersWebDashboard.jar放在服务器的plugins文件夹下

2.重启服务器

3.服务器启动后可以在控制台看到如下信息

[15:39:25] [INFO] [WEB控制台] 启动完成！！
[15:39:25] [INFO] [WEB控制台] 您设置的Token是：******
[15:39:25] [INFO] [WEB控制台] 连接地址是：wss://*******
[15:39:25] [INFO] [WEB控制台] 快速连接，用浏览器打开：https://liujiaqi7998.github.io/GrasscuttersWebDashboard/index.html?server=wss://*****/Dashboard/GrasscuttersWebDashboard

4.浏览器打开控制面板：复制‘快速连接，用浏览器打开’后面的链接用浏览器打开，或者Grasscutters 网页控制台 (liujiaqi7998.github.io)输入连接地址

另一款好看的管理页面（来自@wmn1525）：GrasscutterTools (wmn1525.github.io)

项目地址：https://github.com/wmn1525/grasscutterTools

5.输入连接地址，点击确定

tpm万能传送标记功能（3.x版本新增）

命令：/tpm [@uid] [Name]

权限节点：GrasscuttersWebDashboard.tpm

参数含义

参数	Name参数	含义
go	自定义的传送点名称	传送到传送点
add	自定义的传送点名称	添加传送点
del	自定义的传送点名称	删除传送点
delall	yes（其他无效）	删除改玩家全部传送点
list	空	查看该玩家的传送点列表

注意事项：

1. 传送点名称是唯一的，如需修改某个传送点，请先删除，然后再添加

服务器成员进入WebTools方法

权限节点：GrasscuttersWebDashboard.webtools

1. 游戏内向服务器发送 /webtools 或 /webt 或 /wt 命令（控制台请使用/webtools @uid 向指定玩家发送WebTools链接邮件）
2. 你会接收到一封带有网页链接的邮件
3. 点击连接打开网页控制台

注意事项：

1. 只有玩家处于在线状态才可以使用。

2. 如果玩家没有某条指令的权限，执行是没有效果的。

3. 邮件默认有效时间是3分钟，请3分钟内打开邮件链接，已经打开的页面只要不关闭就会一直处于连接状态。

配置文件

参数	含义
token	服主连接密钥（请妥善保管！）
WebtoolsURL	Webtools的网页链接，如需私有部署请修改（会影响邮件里面的地址）
key_timeout	玩家Webtools邮件失效（单位：毫秒）

插件原理（方便二次开发）

采用WebSocket协议连接的服务器

服务器控制台连接地址请看控制台输出内容

WebTools连接地址：ws(wss)://Host/WebTools?key=**

例如: ws://127.0.0.1/WebTools?key=12345678

通讯方法：

向服务器发送:

是一个JSON数据包其中包含：

参数	含义
type	数据类型
data	数据内容

数据类型包括：

数据类型	含义	data数据类型
CMD	传输命令	字符串:执行的控制台命令
Player	获取在线玩家	整数:0
State	服务器状态（仅服主接口可用）	整数:0

服务器回传数据:

是一个JSON数据包其中包含：

参数	含义
eventName	数据类型
data	数据内容

具体数据类型内容多半都是返回执行信息，不列举了，感兴趣自行抓包看代码。

错误指南

Q1. 插件安装后导致游戏无法启动

可能是割草机升级导致插件需要重新适配置

Q2. 无法连接到服务器

检测插件是否被服务器正常加载，检查连接地址是否输入错误。

浏览器按F12打开开发者工具箱查看错误日志，普遍问题是NET::ERR_CERT_AUTHORITY_INVALID Error

解决办法（任选其一）

1. （推荐）部署一个有效的SSL证书
2. 切换成http
3. 设置浏览器安全级别不校验SSL证书
4. 将服务器的证书添加到电脑信任目录
5. 将网页拉取到本地部署打开
6. （推荐）来着@wmn1525的方法， 先直接 https://ip:端口 访问一下 然后信任，之后就能正常连接了

自行编译

这是一个IDEA创建的项目，直接下载导入并Maven一下。

注意事项

插件处于开发状态，非常的不稳定，存在安全隐患，所以请不要向任何人透露连接地址

本插件开源免费

感谢Grasscutters/gcgm-plugin: A grasscutter game master web dashboard plugin (github.com)提供的帮助

WebTools网页我真的是写不动了，部分代码来自SpikeHD/MojoFrontend: Frontend for Mojo Console (github.com)请遵守GNU General Public License v3.0协议