gc-opencommand-plugin
中文 | English
一个为第三方客户端开放GC命令执行接口的插件
服务端安装
- 在 Release 下载
jar - 放入
plugins文件夹即可
控制台连接
- 首次启动时，会在
plugins目录下生成一个opencommand-plugin目录，打开并编辑config.json - 设置
consoleToken的值为你的连接秘钥，建议使用至少32字符的长随机字符串。 - 重新启动服务端即可生效配置
- 在客户端中选择控制台身份，并填写你的
consoleToken即可以控制台身份运行指令
构建说明
- 克隆仓库
- 在目录下新建
lib目录 - 将
grasscutter-1.1.x-dev.jar放入lib目录 gradle build
玩家使用流程
- 在客户端中填写服务地址，确认是否支持
- 填写UID，发送验证码
- 将游戏内收到的4位整数验证码填入客户端校验
- 享受便利！
客户端请求流程
ping确认是否支持opencommand插件sendCode向指定玩家发送验证码（1分钟内不允许重发），保存返回的token- 使用
token和4位整数验证码发送verify校验 - 如果验证通过，可以使用该
token执行command动作
config.json
{
// 控制台连接令牌
"consoleToken": "",
// 验证码过期时间（秒）
"codeExpirationTime_S": 60,
// 临时令牌过期时间（秒）
"tempTokenExpirationTime_S": 300,
// 授权令牌最后使用过期时间（小时）
"tokenLastUseExpirationTime_H": 48
}
API /opencommand/api
示例
https://127.0.0.1/opencommand/api
Request 请求
public final class JsonRequest {
public String token = "";
public String action = "";
public Object data = null;
}
Response 响应
public final class JsonResponse {
public int retcode = 200;
public String message = "success";
public Object data;
}
Actions 动作
ping
data = null
sendCode
Request
data = uid (int)
Response
data = token (string)
verify 要求 token
Request
data = code (int)
Response
Success:
code = 200
Verification failed:
code = 400
command 要求 token
Request
data = command (string)
Response
data = message (string)
![[兼容性问题] GC更改了config相关文件位置，导致启动失败](https://avatars.githubusercontent.com/u/8349826?v=4)
1 Jan 8, 2022
8 Nov 13, 2022
8 Dec 27, 2022
1 Jan 23, 2022
6 Dec 6, 2022
5 Feb 7, 2022
18 Dec 7, 2022
12 Aug 6, 2022
400 Jan 5, 2023
865 Jan 2, 2023
15 Dec 13, 2022
2 Sep 9, 2022
605 Dec 30, 2022
3 Jun 19, 2022
4 Jan 4, 2022
1 Jan 10, 2022
355 Dec 31, 2022
9 May 28, 2022