mcping

A lightweight motd ping library for kotlin multiplatform and java, no dependencies in jvm target except kotlin-stdlib

native platforms required ktor-network and kotlinx-io

Supported targets

• jvm 1.8
• mingwX64
• linuxArm64
• liunxX64
• iosArm64
• iosSimulatorArm64
• macosArm64

Get started

repositories {
    maven("https://repo.rtast.cn/packages")
}

dependencies {
    implementation("cn.rtast.mcping:mcping:0.0.2")
}

Get latest version at https://repo.rtast.cn/packages/-/cn.rtast.mcping:mcping/

Kotlin example

fun main() {
    val sm = SelectorManager(Dispatchers.IO)
    // context is not required, if not passed, default context will be used
    // ping java server
    val response: PingResponse =
        mcping(host = "org.mc-complex.com", port = 25565, type = ServerType.Java, context = PingContext(sm))
    println(response.content)
    println(response.latency)

    // ping bedrock
    val response = mcping("play.wildnetwork.net", 19132, ServerType.Bedrock)
    println(response.toBedrockResponse())
}

Java example

void main() {
    // ping java server
    String testJavaHost = "org.mc-complex.com";
    PingResponse javaResponse = McPing.mcping(testJavaHost, 25565);

    // ping bedrock server
    String testBedrockHost = "play.wildnetwork.net";
    PingResponse bedrockResponse = McPing.mcping(testBedrockHost, 19132, ServerType.Bedrock);
    System.out.println(bedrockResponse.toBedrockResponse());
}

java consumers should not manually pass the context parameter

Other resources

An example of java ping json response can be found at ping-response-example (Formatted), a raw response of bedrock ping response can be found at bedrock-pinng-raw-response

Open Source

Open source under Apache-2.0