EXAMPLES.md

Pinging modern Minecraft servers (1.7 and later)

NOTE: Modern servers also respond to older ping types.

package main

import (
	"fmt"

	"github.com/alteamc/minequery/ping"
)

func main() {
	res, err := ping.Ping("altea.land", 25565)
	if err != nil {
		panic(err)
	}

	fmt.Println(res.Description)
}

Pinging legacy Minecraft servers (1.4 to 1.6)

package main

import (
	"fmt"

	"github.com/alteamc/minequery/ping"
)

func main() {
	res, err := ping.PingLegacy("altea.land", 25565)
	if err != nil {
		panic(err)
	}

	fmt.Println(res.MessageOfTheDay)
}

Pinging old Minecraft servers (Beta 1.7 to 1.3)

package main

import (
	"fmt"

	"github.com/alteamc/minequery/ping"
)

func main() {
	res, err := ping.PingAncient("altea.land", 25565)
	if err != nil {
		panic(err)
	}

	fmt.Println(res.MessageOfTheDay)
}

Pinging with timeout

All Ping methods have WithTimeout variants that let you pass a time.Duration value used for socket read/write timeout.

package main

import (
	"fmt"
	"time"

	"github.com/alteamc/minequery/ping"
)

func main() {
	res, err := ping.PingWithTimeout("altea.land", 25565, 1*time.Second)
	if err != nil {
		panic(err)
	}

	fmt.Println(res.Description)
}