update README
This commit is contained in:
parent
0057b3037b
commit
13a607fcd1
77
README.md
77
README.md
|
@ -42,7 +42,7 @@ Chat with us on IRC: [#matterlink @ irc.esper.net](irc://irc.esper.net/matterlin
|
||||||
|
|
||||||
### Custom bridge commands
|
### Custom bridge commands
|
||||||
|
|
||||||
including passthrough to MC!
|
includes pass-through to Minecraft commands!
|
||||||
Default commands: `help, tps, list, seed, uptime`
|
Default commands: `help, tps, list, seed, uptime`
|
||||||
|
|
||||||
Commands are specified in JSON format as follows:
|
Commands are specified in JSON format as follows:
|
||||||
|
@ -50,43 +50,66 @@ Commands are specified in JSON format as follows:
|
||||||
Passthrough command (executes the configured command from the MC server console)
|
Passthrough command (executes the configured command from the MC server console)
|
||||||
|
|
||||||
```json
|
```json
|
||||||
"tps": {
|
{
|
||||||
|
"tps": {
|
||||||
"type": "PASSTHROUGH",
|
"type": "PASSTHROUGH",
|
||||||
"execute": "forge tps",
|
"execute": "forge tps",
|
||||||
"permLevel": 0,
|
"permLevel": 0,
|
||||||
"help": "Print server tps",
|
"help": "Print server tps",
|
||||||
"allowArgs": false
|
"allowArgs": false
|
||||||
|
}
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
Response command
|
Response command
|
||||||
|
|
||||||
```json
|
```json
|
||||||
"uptime": {
|
{
|
||||||
|
"uptime": {
|
||||||
"type": "RESPONSE",
|
"type": "RESPONSE",
|
||||||
"response": "{uptime}",
|
"response": "{uptime}",
|
||||||
"permLevel": 1,
|
"permLevel": 1,
|
||||||
"help": "Print server uptime",
|
"help": "Print server uptime",
|
||||||
"allowArgs": false
|
"allowArgs": false
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### Acount Linking
|
||||||
|
|
||||||
|
To link your chat account to your minecraft uuid
|
||||||
|
execute `!auth Username`
|
||||||
|
make sure to use the proper username and command prefix, the system will then guide you through
|
||||||
|
|
||||||
|
internally the identity links are stored like so:
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
/* username: NikkyAi */
|
||||||
|
"edd31c45-b095-49c5-a9f5-59cec4cfed8c": {
|
||||||
|
/* discord id */
|
||||||
|
"discord.game": [
|
||||||
|
"112228624366575616"
|
||||||
|
]
|
||||||
|
}
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
### Command permissions
|
### Command permissions
|
||||||
|
|
||||||
Higher numbers mean more permissions. Configured on a network-by-network basis.
|
Higher numbers mean more permissions. Configured per uuid.
|
||||||
For IRC, this is your hostmask.
|
|
||||||
For Discord, this is your userid (NOT the four-digit number.)
|
|
||||||
|
|
||||||
```json
|
```json
|
||||||
{
|
{
|
||||||
"irc.esper": {
|
"edd31c45-b095-49c5-a9f5-59cec4cfed8c": 9000
|
||||||
"~DaMachina@hostname.com":1000
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
* Edit and reload the config file without restarting the server!
|
|
||||||
|
### Reload
|
||||||
|
|
||||||
|
Edit and reload the config file without restarting the server!
|
||||||
```
|
```
|
||||||
/bridge <connect|disconnect|reload>
|
/ml <connect|disconnect|reload>
|
||||||
connect: Connects the MC chat to the MatterBridge server
|
connect: Connects the MC chat to the MatterBridge server
|
||||||
disconnect: Disconnects the chat from the MatterBridge server
|
disconnect: Disconnects the chat from the MatterBridge server
|
||||||
reload: Disconnects, reloads the config and custom command files,
|
reload: Disconnects, reloads the config and custom command files,
|
||||||
|
@ -97,18 +120,42 @@ For Discord, this is your userid (NOT the four-digit number.)
|
||||||
|
|
||||||
Requires the matterbridge config api section to be setup along these lines:
|
Requires the matterbridge config api section to be setup along these lines:
|
||||||
|
|
||||||
|
### Local
|
||||||
|
|
||||||
|
If ou know the matterbridge will run on the same machine as the Minecraft Server
|
||||||
```
|
```
|
||||||
[api]
|
[api]
|
||||||
[api.local]
|
[api.local]
|
||||||
BindAddress="0.0.0.0:4242" # or listen only to localhost: 127.0.0.1:4242
|
BindAddress="127.0.0.1:4242" // Listens only for localhost
|
||||||
#OPTIONAL (no authorization if token is empty)
|
#OPTIONAL (no authorization if token is empty)
|
||||||
Token="mytoken" # leave this empty if you know its going to run on localhost only
|
Token="" # Token left empty
|
||||||
Buffer=1000
|
Buffer=1000
|
||||||
RemoteNickFormat="{NICK}"
|
RemoteNickFormat="{NICK}"
|
||||||
ShowJoinPart = true
|
ShowJoinPart = true
|
||||||
```
|
```
|
||||||
|
|
||||||
Now you just need to run MatterBridge on the server, the default configuration works with the provided sample.
|
With this you need no extra configuration steps.. just run matterbridge and then start the minecraft server (or reload matterlink with command if it runs already)
|
||||||
|
|
||||||
|
### Remote
|
||||||
|
|
||||||
|
If the matterbridge runs on a different machine
|
||||||
|
|
||||||
|
```
|
||||||
|
[api]
|
||||||
|
[api.local]
|
||||||
|
BindAddress="0.0.0.0:4242"
|
||||||
|
#OPTIONAL (no authorization if token is empty)
|
||||||
|
Token="mytoken"
|
||||||
|
Buffer=1000
|
||||||
|
RemoteNickFormat="{NICK}"
|
||||||
|
ShowJoinPart = true
|
||||||
|
```
|
||||||
|
|
||||||
|
you need to know the ip / domain of the matterbridge and the token used,
|
||||||
|
enter them in the ´connection' section in the config and reload matterlink
|
||||||
|
|
||||||
|
|
||||||
|
### Sample
|
||||||
|
|
||||||
Install matterbridge and try out the basic sample:
|
Install matterbridge and try out the basic sample:
|
||||||
|
|
||||||
|
@ -118,7 +165,7 @@ mv matterbridge-sample.toml matterbridge.toml
|
||||||
matterbridge
|
matterbridge
|
||||||
```
|
```
|
||||||
|
|
||||||
now start the server with matterlink (and forgelin )in the mods folder
|
now start the server with matterlink (and forgelin) in the mods folder
|
||||||
|
|
||||||
and then [RTFM!!!](https://github.com/42wim/matterbridge#configuration) and configure all your needed gateways, endpoints etc
|
and then [RTFM!!!](https://github.com/42wim/matterbridge#configuration) and configure all your needed gateways, endpoints etc
|
||||||
|
|
||||||
|
|
|
@ -11,7 +11,7 @@ object CommandCoreML {
|
||||||
|
|
||||||
val aliases = listOf("matterlink")
|
val aliases = listOf("matterlink")
|
||||||
|
|
||||||
val usage = "ml <connect|disconnect|reload|auth>"
|
val usage = "ml <connect|disconnect|reload|permAccept>"
|
||||||
|
|
||||||
fun execute(args: Array<String>, user: String, uuid: String?): String {
|
fun execute(args: Array<String>, user: String, uuid: String?): String {
|
||||||
val cmd = args[0].toLowerCase()
|
val cmd = args[0].toLowerCase()
|
||||||
|
|
|
@ -1,11 +1,11 @@
|
||||||
[{
|
[{
|
||||||
"modid": "matterlink",
|
"modid": "matterlink",
|
||||||
"name": "MatterLink",
|
"name": "MatterLink",
|
||||||
"description": "Minecraft Server Matterbridge link",
|
"description": "Minecraft Server Matterbridge link, Multi-Platform chat",
|
||||||
"version": "${version}",
|
"version": "${version}",
|
||||||
"mcversion": "${mcversion}",
|
"mcversion": "${mcversion}",
|
||||||
"url": "https://github.com/elytra/MatterLink",
|
"url": "https://github.com/elytra/MatterLink",
|
||||||
"authorList":["Arcanitor", "NikkyAi"],
|
"authorList":["NikkyAi", "Arcanitor"],
|
||||||
"credits": "Blame Nikky for talking me into this.",
|
"credits": "Blame Nikky for talking me into this. \n42wim for creating matterbridge \nUna, Falkreon and capitalthree's patience",
|
||||||
"dependencies": ["forgelin"]
|
"dependencies": ["forgelin"]
|
||||||
}]
|
}]
|
Loading…
Reference in New Issue