gc-opencommand-plugin/README_en-US.md

gc-opencommand-plugin

中文 | English

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

multiple commands can be separated by | or newline, for example:

/a 1 | /a 2
/a 3

Invoking ping the response data will contain the plugin version.

Server installation

1. Download the jar in Release
2. Put it in the LunarCore/plugins folder
3. Restart LunarCore server

Player

1. Fill in the service address in the Tool to check plugin status
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 Tool verification
4. Enjoy the convenience!

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. (automatically generated when empty is detected)
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

---

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

Build

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

---

config.json

{
   // console connection token (automatically generated when empty is detected)
  "consoleToken": "",
   // Verification code expiration time (seconds)
  "codeExpirationTime_S": 60,
   // Temporary token expiration time (seconds)
  "tempTokenExpirationTime_S": 300,
  // Authorization token last used expiration time (hours)
  "tokenLastUseExpirationTime_H": 48,
}

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

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

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