jie65535/gc-opencommand-plugin
1
0
Fork 0
mirror of https://github.com/jie65535/gc-opencommand-plugin.git synced 2025-06-02 17:49:12 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity
c6e0b51ea6
gc-opencommand-plugin/README_en-US.md
jie65535 72948121d6
Update README_en-US.md
2022-10-27 11:26:23 +08:00

7.4 KiB
Raw Blame History

gc-opencommand-plugin

中文 | English

A plugin that opens the GC command execution interface for third-party clients

Applications using this plug-in

Server installation

  1. Download the jar in Release
  2. Put it in the plugins folder

Console connection

  1. When starting for the first time, a opencommand-plugin directory will be generated under the plugins directory, open and edit config.json
  2. Set the value of consoleToken to your connection key. It is recommended to use a long random string of at least 32 characters.
  3. Restart the server to take effect
  4. Select the console identity in the client, and fill in your consoleToken to run the command as the console identity

Multi server

Master server (Dispatch)

  1. Open config.json in the opencommand-plugin directory
  2. Modify the socketPort value to an unused port
  3. Set sockettoken multi server communication key. It is recommended to use a long random string of at least 32 characters.
  4. Restart the server to make the configuration effective

Sub server (Game)

  1. Open config.json in the opencommand-plugin directory
  2. Modify the sockethost and socketport values to the address and port of the primary server
  3. Set the same value of sockettoken and the primary server
  4. Set the socketDisplayName value to your server name (See below for usage Jump)
  5. Restart the server to make the configuration effective

Build

  1. git clone https://github.com/jie65535/gc-opencommand-plugin
  2. cd gc-opencommand-plugin
  3. mkdir lib
  4. mv path/to/grasscutter-1.x.x-dev.jar ./lib
  5. gradle build

Player

  1. Fill in the service address in the client to confirm whether it supports
  2. Fill in the UID and send the verification code
  3. Fill in the 4-digit integer verification code received in the game into the client verification
  4. Enjoy the convenience!

Client request

  1. ping to confirm whether the opencommand plugin is supported
  2. sendCode sends a verification code to the specified player (re-send is not allowed within 1 minute), and save the returned token
  3. Send verify check using token and 4-digit integer verification code
  4. If the verification is passed, you can use the token to execute the command action

config.json

{
  "consoleToken": "",
  "codeExpirationTime_S": 60,
  "tempTokenExpirationTime_S": 300,
  "tokenLastUseExpirationTime_H": 48,
  "socketPort": 5746,
  "socketToken": "",
  "socketHost": "127.0.0.1"
}

API /opencommand/api

Example

https://127.0.0.1/opencommand/api

Request

public final class JsonRequest {
    public String token = "";
    public String action = "";
    public Seting server = "";
    public Object data = null;
}

Response

public final class JsonResponse {
    public int retcode = 200;
    public String message = "Success";
    public Object data;
}

Actions

Test connect

Request
Request Request data type
action ping String
Response
Response Response data type
retcode 200 String
message Success String
data null null

Get online players

Request
Request Request data type
action online String
Response
Response Response data type
retcode 200 String
message Success String
data {"count": 0, playerList": []} JsonObject

Send code

Request
Request Request data type
action sendCode String
data uid Int
Response
Response Response data type
retcode 200 String
message Success String
data token String

Verify code

Request
Request Request data type
action verify String
token token String
data code Int
Response

Success

Response Response data type
retcode 200 String
message Success String
data null null

Failed

Response Response data type
retcode 400 String
message Verification failed String
data null null

Run command

Request
Request Request data type
action command String
token token String
data command String
Response

Success

Response Response data type
retcode 200 String
message Success String
data Command return String

Run console command

Get run mode

Request
Request Request data Type
action runmode String
token token String
Response

Success

Request Response data Type
retcode 200 Int
message Success String
data 1 (Multi server) / 0 (Single server) Int

Get mulit server list

Request
Request Request data Type
action server String
token token String
Response

Success

Request Response data Type
retcode 200 Int
message Success String
data {} JsonObject 
{
  "retcode": 200,
  "message": "success",
  "data": {
    // Server UUID
    "13d82d0d-c7d9-47dd-830c-76588006ef6e": "2.8.0 Server",
    "e6b83224-a761-4023-be57-e054c5bb823a": "2.8.0 Dev server"
  }
}

Run command

Request

If it is a single server, there is no need to fill in server UUID.

Request Request data Type
action command String
token token String
server UUID String
data command String
Response

Success

Request Response data Type
retcode 200 Int
message Success String
data Command return String