mc-multisockets

WebSockets multiplexing for Minecraft (Spigot & BungeeCord)

Download latest stable version

Download latest dev version

All versions

Go to JitPack

By default, all routes are public and unencrypted

But you can use AES to encrypt them and a password verification to restrict them

You must define routes in onSocketEnable{}

Configuration

sockets:
  "mysocket":
    port: 25590
    connections:
      "factions":
        host: localhost
        port: 25591
      "hub":
        host: localhost
        port: 25592

Usage

// When your plugin is loaded
override fun onLoad(){

    // When any socket is started
    onSocketEnable { name ->
        println("Enabled socket $name on port $port")
        
        // You must define all routes here
    
        // Create route to /MyPlugin/test
        onConversation("/MyPlugin/test"){
            // Send unencrypted message
            send("it works!")
            // Wait until a message is received
            println(readMessage())
            // Do it as many times as you want
            send("it still works!")
            println(readMessage())
        }
        
        hello("factions")
    }
}

fun Socket.hello(target: String){
    // Get the connection to target
    val connection = connections[target]
    ?: return println("Unknown connection: $target")
    
    // Start a conversation to /MyPlugin/hello
    connection.conversation("/MyPlugin/hello") {
        // Use AES encryption
        val (encrypt, decrypt) = aes()
        // Send encrypted message
        send("hello world!".encrypt())
        // Wait until a message is received and decrypt it
        println(readMessage().decrypt())
    }
    
    connection.printFactions()
}

fun Connection.printFactions(){
    // Short function equivalent to conversation { readMessage() }
    request("/Factions/factions"){
        // Just print the first message received and close the conversation
        result -> println(result)
    }
}