add a ping service (#372)

* add a ping service

* add examples and public api file

* add minecraft server ping

minecraft/.gitignore

@@ -0,0 +1,2 @@
+
+minecraft

minecraft/Dockerfile

@@ -0,0 +1,3 @@
+FROM alpine
+ADD minecraft /minecraft
+ENTRYPOINT [ "/minecraft" ]

minecraft/Makefile

@@ -0,0 +1,28 @@
+
+GOPATH:=$(shell go env GOPATH)
+.PHONY: init
+init:
+	go get -u github.com/golang/protobuf/proto
+	go get -u github.com/golang/protobuf/protoc-gen-go
+	go get github.com/micro/micro/v3/cmd/protoc-gen-micro
+	go get github.com/micro/micro/v3/cmd/protoc-gen-openapi
+
+.PHONY: api
+api:
+	protoc --openapi_out=. --proto_path=. proto/minecraft.proto
+
+.PHONY: proto
+proto:
+	protoc --proto_path=. --micro_out=. --go_out=:. proto/minecraft.proto
+	
+.PHONY: build
+build:
+	go build -o minecraft *.go
+
+.PHONY: test
+test:
+	go test -v ./... -cover
+
+.PHONY: docker
+docker:
+	docker build . -t minecraft:latest

minecraft/README.md

@@ -0,0 +1,5 @@
+Minecraft server ping
+
+# Minecraft Service
+
+Ping your Minecraft servers for latency, player count, etc.

minecraft/examples.json

@@ -0,0 +1,20 @@
+{
+    "ping": [{
+        "title": "Ping a minecraft server",
+        "description": "Ping a minecrafter server for stats",
+        "run_check": false,
+        "request": {
+            "funcraft.net"
+        },
+        "response": {
+		"latency": 84,
+		"players": 412,
+		"max_players": 1000,
+		"protocol": 109,
+		"favicon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAEAAAABACAMAAACdt4HsAAADAFBMVEX////WRjXWRjXWRjXWRjXWRjXWRjXWRjXWRjXWRjXWRjXWRjXWRjXWRjXWRjXWRjXWRjX///8AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAADFGtetAAAAEHRSTlMAADNEqrt3ImbM3YjumRFVXOavjQAAAYlJREFUeNrNl39zgyAMhgMirqfd9/+Y29l2igHW9lrbTQmR7K7LX8rB0zc/SCzAq01lF35ZBK3AP97Nckuloj5vMW7BVnUIdXN++qAAqrs97ABGnJfbpy3PaEM61TRZv/XSg2zcEElA3nCUAYYByBh4+rh3I+2xisqkpH9VTvc+W0j7Iaja3t+P8DZedcV4KyRWJXazss9FJf60RBDnOI25kOaygFIAFAJq7uVMAaxUwWy7MsBDwKEMsN4GilzoywAVu45yCrAQEPjp1HTTmwoBDbO7JAFm9fJqvSe2rjeJJ4D13VpSaQBqaM+HLHYYLm7VI2c2WhNTwT9Ni460VPDuTbolM4JoifOsLBjiPAYGwJHfBrKeeKiAmcZH1C+/cNOtXey3AtxUEER79J5/lVaGKwbn73U0hbKurNhDIQFopJPJbMmxppamQgXS4VqRpbtJQSEgSl0Qx6D9MwWuDGA3lcEKAOHlQfxHgEYKMGWAIHbBSwHKCXtib07IByT+sdgLIkaQXnaGfQNp/mgnuZ0pQQAAAABJRU5ErkJggg==",
+		"motd": "      »»» FunCraft ««« Mini-Jeux, PvP et Fun !\n    Rush, Hikabrain, FreeCube, SkyWars, Survival, ...",
+		"version": "§4Use 1.9/1.10/1.11§f - §7412§8/§71000",
+		"sample": []
+        }
+    }]
+}

minecraft/generate.go

@@ -0,0 +1,3 @@
+package main
+
+//go:generate make proto

minecraft/handler/minecraft.go

@@ -0,0 +1,42 @@
+package handler
+
+import (
+	"context"
+
+	"github.com/iverly/go-mcping/mcping"
+	"github.com/micro/micro/v3/service/errors"
+	pb "github.com/micro/services/minecraft/proto"
+)
+
+type Minecraft struct{}
+
+func (m *Minecraft) Ping(ctx context.Context, req *pb.PingRequest, rsp *pb.PingResponse) error {
+	if len(req.Address) == 0 {
+		return errors.BadRequest("minecraft.ping", "missing address")
+	}
+
+	pinger := mcping.NewPinger()
+	resp, err := pinger.Ping(req.Address, 25565)
+	if err != nil {
+		return err
+	}
+
+	var samples []*pb.PlayerSample
+	for _, sample := range resp.Sample {
+		samples = append(samples, &pb.PlayerSample{
+			Uuid: sample.UUID,
+			Name: sample.Name,
+		})
+	}
+
+	rsp.Latency = uint32(resp.Latency)
+	rsp.Players = int32(resp.PlayerCount.Online)
+	rsp.MaxPlayers = int32(resp.PlayerCount.Max)
+	rsp.Protocol = int32(resp.Protocol)
+	rsp.Favicon = resp.Favicon
+	rsp.Motd = resp.Motd
+	rsp.Version = resp.Version
+	rsp.Sample = samples
+
+	return nil
+}

minecraft/main.go

@@ -0,0 +1,25 @@
+package main
+
+import (
+	"github.com/micro/services/minecraft/handler"
+	pb "github.com/micro/services/minecraft/proto"
+
+	"github.com/micro/micro/v3/service"
+	"github.com/micro/micro/v3/service/logger"
+)
+
+func main() {
+	// Create service
+	srv := service.New(
+		service.Name("minecraft"),
+		service.Version("latest"),
+	)
+
+	// Register handler
+	pb.RegisterMinecraftHandler(srv.Server(), new(handler.Minecraft))
+
+	// Run service
+	if err := srv.Run(); err != nil {
+		logger.Fatal(err)
+	}
+}

minecraft/micro.mu

@@ -0,0 +1 @@
+service minecraft

minecraft/proto/minecraft.pb.go

@@ -0,0 +1,366 @@
+// Code generated by protoc-gen-go. DO NOT EDIT.
+// versions:
+// 	protoc-gen-go v1.27.1
+// 	protoc        v3.15.6
+// source: proto/minecraft.proto
+
+package minecraft
+
+import (
+	protoreflect "google.golang.org/protobuf/reflect/protoreflect"
+	protoimpl "google.golang.org/protobuf/runtime/protoimpl"
+	reflect "reflect"
+	sync "sync"
+)
+
+const (
+	// Verify that this generated code is sufficiently up-to-date.
+	_ = protoimpl.EnforceVersion(20 - protoimpl.MinVersion)
+	// Verify that runtime/protoimpl is sufficiently up-to-date.
+	_ = protoimpl.EnforceVersion(protoimpl.MaxVersion - 20)
+)
+
+type PlayerSample struct {
+	state         protoimpl.MessageState
+	sizeCache     protoimpl.SizeCache
+	unknownFields protoimpl.UnknownFields
+
+	// unique id of player
+	Uuid string `protobuf:"bytes,1,opt,name=uuid,proto3" json:"uuid,omitempty"`
+	// name of the player
+	Name string `protobuf:"bytes,2,opt,name=name,proto3" json:"name,omitempty"`
+}
+
+func (x *PlayerSample) Reset() {
+	*x = PlayerSample{}
+	if protoimpl.UnsafeEnabled {
+		mi := &file_proto_minecraft_proto_msgTypes[0]
+		ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
+		ms.StoreMessageInfo(mi)
+	}
+}
+
+func (x *PlayerSample) String() string {
+	return protoimpl.X.MessageStringOf(x)
+}
+
+func (*PlayerSample) ProtoMessage() {}
+
+func (x *PlayerSample) ProtoReflect() protoreflect.Message {
+	mi := &file_proto_minecraft_proto_msgTypes[0]
+	if protoimpl.UnsafeEnabled && x != nil {
+		ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
+		if ms.LoadMessageInfo() == nil {
+			ms.StoreMessageInfo(mi)
+		}
+		return ms
+	}
+	return mi.MessageOf(x)
+}
+
+// Deprecated: Use PlayerSample.ProtoReflect.Descriptor instead.
+func (*PlayerSample) Descriptor() ([]byte, []int) {
+	return file_proto_minecraft_proto_rawDescGZIP(), []int{0}
+}
+
+func (x *PlayerSample) GetUuid() string {
+	if x != nil {
+		return x.Uuid
+	}
+	return ""
+}
+
+func (x *PlayerSample) GetName() string {
+	if x != nil {
+		return x.Name
+	}
+	return ""
+}
+
+// Ping a minecraft server
+type PingRequest struct {
+	state         protoimpl.MessageState
+	sizeCache     protoimpl.SizeCache
+	unknownFields protoimpl.UnknownFields
+
+	// address of the server
+	Address string `protobuf:"bytes,1,opt,name=address,proto3" json:"address,omitempty"`
+}
+
+func (x *PingRequest) Reset() {
+	*x = PingRequest{}
+	if protoimpl.UnsafeEnabled {
+		mi := &file_proto_minecraft_proto_msgTypes[1]
+		ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
+		ms.StoreMessageInfo(mi)
+	}
+}
+
+func (x *PingRequest) String() string {
+	return protoimpl.X.MessageStringOf(x)
+}
+
+func (*PingRequest) ProtoMessage() {}
+
+func (x *PingRequest) ProtoReflect() protoreflect.Message {
+	mi := &file_proto_minecraft_proto_msgTypes[1]
+	if protoimpl.UnsafeEnabled && x != nil {
+		ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
+		if ms.LoadMessageInfo() == nil {
+			ms.StoreMessageInfo(mi)
+		}
+		return ms
+	}
+	return mi.MessageOf(x)
+}
+
+// Deprecated: Use PingRequest.ProtoReflect.Descriptor instead.
+func (*PingRequest) Descriptor() ([]byte, []int) {
+	return file_proto_minecraft_proto_rawDescGZIP(), []int{1}
+}
+
+func (x *PingRequest) GetAddress() string {
+	if x != nil {
+		return x.Address
+	}
+	return ""
+}
+
+type PingResponse struct {
+	state         protoimpl.MessageState
+	sizeCache     protoimpl.SizeCache
+	unknownFields protoimpl.UnknownFields
+
+	// Latency (ms) between us and the server (EU)
+	Latency uint32 `protobuf:"varint,1,opt,name=latency,proto3" json:"latency,omitempty"`
+	// Number of players online
+	Players int32 `protobuf:"varint,2,opt,name=players,proto3" json:"players,omitempty"`
+	// Max players ever
+	MaxPlayers int32 `protobuf:"varint,3,opt,name=max_players,json=maxPlayers,proto3" json:"max_players,omitempty"`
+	// Protocol number of the server
+	Protocol int32 `protobuf:"varint,4,opt,name=protocol,proto3" json:"protocol,omitempty"`
+	// Favicon in base64
+	Favicon string `protobuf:"bytes,5,opt,name=favicon,proto3" json:"favicon,omitempty"`
+	// Message of the day
+	Motd string `protobuf:"bytes,6,opt,name=motd,proto3" json:"motd,omitempty"`
+	// Version of the server
+	Version string `protobuf:"bytes,7,opt,name=version,proto3" json:"version,omitempty"`
+	// List of connected players
+	Sample []*PlayerSample `protobuf:"bytes,8,rep,name=sample,proto3" json:"sample,omitempty"`
+}
+
+func (x *PingResponse) Reset() {
+	*x = PingResponse{}
+	if protoimpl.UnsafeEnabled {
+		mi := &file_proto_minecraft_proto_msgTypes[2]
+		ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
+		ms.StoreMessageInfo(mi)
+	}
+}
+
+func (x *PingResponse) String() string {
+	return protoimpl.X.MessageStringOf(x)
+}
+
+func (*PingResponse) ProtoMessage() {}
+
+func (x *PingResponse) ProtoReflect() protoreflect.Message {
+	mi := &file_proto_minecraft_proto_msgTypes[2]
+	if protoimpl.UnsafeEnabled && x != nil {
+		ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
+		if ms.LoadMessageInfo() == nil {
+			ms.StoreMessageInfo(mi)
+		}
+		return ms
+	}
+	return mi.MessageOf(x)
+}
+
+// Deprecated: Use PingResponse.ProtoReflect.Descriptor instead.
+func (*PingResponse) Descriptor() ([]byte, []int) {
+	return file_proto_minecraft_proto_rawDescGZIP(), []int{2}
+}
+
+func (x *PingResponse) GetLatency() uint32 {
+	if x != nil {
+		return x.Latency
+	}
+	return 0
+}
+
+func (x *PingResponse) GetPlayers() int32 {
+	if x != nil {
+		return x.Players
+	}
+	return 0
+}
+
+func (x *PingResponse) GetMaxPlayers() int32 {
+	if x != nil {
+		return x.MaxPlayers
+	}
+	return 0
+}
+
+func (x *PingResponse) GetProtocol() int32 {
+	if x != nil {
+		return x.Protocol
+	}
+	return 0
+}
+
+func (x *PingResponse) GetFavicon() string {
+	if x != nil {
+		return x.Favicon
+	}
+	return ""
+}
+
+func (x *PingResponse) GetMotd() string {
+	if x != nil {
+		return x.Motd
+	}
+	return ""
+}
+
+func (x *PingResponse) GetVersion() string {
+	if x != nil {
+		return x.Version
+	}
+	return ""
+}
+
+func (x *PingResponse) GetSample() []*PlayerSample {
+	if x != nil {
+		return x.Sample
+	}
+	return nil
+}
+
+var File_proto_minecraft_proto protoreflect.FileDescriptor
+
+var file_proto_minecraft_proto_rawDesc = []byte{
+	0x0a, 0x15, 0x70, 0x72, 0x6f, 0x74, 0x6f, 0x2f, 0x6d, 0x69, 0x6e, 0x65, 0x63, 0x72, 0x61, 0x66,
+	0x74, 0x2e, 0x70, 0x72, 0x6f, 0x74, 0x6f, 0x12, 0x09, 0x6d, 0x69, 0x6e, 0x65, 0x63, 0x72, 0x61,
+	0x66, 0x74, 0x22, 0x36, 0x0a, 0x0c, 0x50, 0x6c, 0x61, 0x79, 0x65, 0x72, 0x53, 0x61, 0x6d, 0x70,
+	0x6c, 0x65, 0x12, 0x12, 0x0a, 0x04, 0x75, 0x75, 0x69, 0x64, 0x18, 0x01, 0x20, 0x01, 0x28, 0x09,
+	0x52, 0x04, 0x75, 0x75, 0x69, 0x64, 0x12, 0x12, 0x0a, 0x04, 0x6e, 0x61, 0x6d, 0x65, 0x18, 0x02,
+	0x20, 0x01, 0x28, 0x09, 0x52, 0x04, 0x6e, 0x61, 0x6d, 0x65, 0x22, 0x27, 0x0a, 0x0b, 0x50, 0x69,
+	0x6e, 0x67, 0x52, 0x65, 0x71, 0x75, 0x65, 0x73, 0x74, 0x12, 0x18, 0x0a, 0x07, 0x61, 0x64, 0x64,
+	0x72, 0x65, 0x73, 0x73, 0x18, 0x01, 0x20, 0x01, 0x28, 0x09, 0x52, 0x07, 0x61, 0x64, 0x64, 0x72,
+	0x65, 0x73, 0x73, 0x22, 0xf8, 0x01, 0x0a, 0x0c, 0x50, 0x69, 0x6e, 0x67, 0x52, 0x65, 0x73, 0x70,
+	0x6f, 0x6e, 0x73, 0x65, 0x12, 0x18, 0x0a, 0x07, 0x6c, 0x61, 0x74, 0x65, 0x6e, 0x63, 0x79, 0x18,
+	0x01, 0x20, 0x01, 0x28, 0x0d, 0x52, 0x07, 0x6c, 0x61, 0x74, 0x65, 0x6e, 0x63, 0x79, 0x12, 0x18,
+	0x0a, 0x07, 0x70, 0x6c, 0x61, 0x79, 0x65, 0x72, 0x73, 0x18, 0x02, 0x20, 0x01, 0x28, 0x05, 0x52,
+	0x07, 0x70, 0x6c, 0x61, 0x79, 0x65, 0x72, 0x73, 0x12, 0x1f, 0x0a, 0x0b, 0x6d, 0x61, 0x78, 0x5f,
+	0x70, 0x6c, 0x61, 0x79, 0x65, 0x72, 0x73, 0x18, 0x03, 0x20, 0x01, 0x28, 0x05, 0x52, 0x0a, 0x6d,
+	0x61, 0x78, 0x50, 0x6c, 0x61, 0x79, 0x65, 0x72, 0x73, 0x12, 0x1a, 0x0a, 0x08, 0x70, 0x72, 0x6f,
+	0x74, 0x6f, 0x63, 0x6f, 0x6c, 0x18, 0x04, 0x20, 0x01, 0x28, 0x05, 0x52, 0x08, 0x70, 0x72, 0x6f,
+	0x74, 0x6f, 0x63, 0x6f, 0x6c, 0x12, 0x18, 0x0a, 0x07, 0x66, 0x61, 0x76, 0x69, 0x63, 0x6f, 0x6e,
+	0x18, 0x05, 0x20, 0x01, 0x28, 0x09, 0x52, 0x07, 0x66, 0x61, 0x76, 0x69, 0x63, 0x6f, 0x6e, 0x12,
+	0x12, 0x0a, 0x04, 0x6d, 0x6f, 0x74, 0x64, 0x18, 0x06, 0x20, 0x01, 0x28, 0x09, 0x52, 0x04, 0x6d,
+	0x6f, 0x74, 0x64, 0x12, 0x18, 0x0a, 0x07, 0x76, 0x65, 0x72, 0x73, 0x69, 0x6f, 0x6e, 0x18, 0x07,
+	0x20, 0x01, 0x28, 0x09, 0x52, 0x07, 0x76, 0x65, 0x72, 0x73, 0x69, 0x6f, 0x6e, 0x12, 0x2f, 0x0a,
+	0x06, 0x73, 0x61, 0x6d, 0x70, 0x6c, 0x65, 0x18, 0x08, 0x20, 0x03, 0x28, 0x0b, 0x32, 0x17, 0x2e,
+	0x6d, 0x69, 0x6e, 0x65, 0x63, 0x72, 0x61, 0x66, 0x74, 0x2e, 0x50, 0x6c, 0x61, 0x79, 0x65, 0x72,
+	0x53, 0x61, 0x6d, 0x70, 0x6c, 0x65, 0x52, 0x06, 0x73, 0x61, 0x6d, 0x70, 0x6c, 0x65, 0x32, 0x46,
+	0x0a, 0x09, 0x4d, 0x69, 0x6e, 0x65, 0x63, 0x72, 0x61, 0x66, 0x74, 0x12, 0x39, 0x0a, 0x04, 0x50,
+	0x69, 0x6e, 0x67, 0x12, 0x16, 0x2e, 0x6d, 0x69, 0x6e, 0x65, 0x63, 0x72, 0x61, 0x66, 0x74, 0x2e,
+	0x50, 0x69, 0x6e, 0x67, 0x52, 0x65, 0x71, 0x75, 0x65, 0x73, 0x74, 0x1a, 0x17, 0x2e, 0x6d, 0x69,
+	0x6e, 0x65, 0x63, 0x72, 0x61, 0x66, 0x74, 0x2e, 0x50, 0x69, 0x6e, 0x67, 0x52, 0x65, 0x73, 0x70,
+	0x6f, 0x6e, 0x73, 0x65, 0x22, 0x00, 0x42, 0x13, 0x5a, 0x11, 0x2e, 0x2f, 0x70, 0x72, 0x6f, 0x74,
+	0x6f, 0x3b, 0x6d, 0x69, 0x6e, 0x65, 0x63, 0x72, 0x61, 0x66, 0x74, 0x62, 0x06, 0x70, 0x72, 0x6f,
+	0x74, 0x6f, 0x33,
+}
+
+var (
+	file_proto_minecraft_proto_rawDescOnce sync.Once
+	file_proto_minecraft_proto_rawDescData = file_proto_minecraft_proto_rawDesc
+)
+
+func file_proto_minecraft_proto_rawDescGZIP() []byte {
+	file_proto_minecraft_proto_rawDescOnce.Do(func() {
+		file_proto_minecraft_proto_rawDescData = protoimpl.X.CompressGZIP(file_proto_minecraft_proto_rawDescData)
+	})
+	return file_proto_minecraft_proto_rawDescData
+}
+
+var file_proto_minecraft_proto_msgTypes = make([]protoimpl.MessageInfo, 3)
+var file_proto_minecraft_proto_goTypes = []interface{}{
+	(*PlayerSample)(nil), // 0: minecraft.PlayerSample
+	(*PingRequest)(nil),  // 1: minecraft.PingRequest
+	(*PingResponse)(nil), // 2: minecraft.PingResponse
+}
+var file_proto_minecraft_proto_depIdxs = []int32{
+	0, // 0: minecraft.PingResponse.sample:type_name -> minecraft.PlayerSample
+	1, // 1: minecraft.Minecraft.Ping:input_type -> minecraft.PingRequest
+	2, // 2: minecraft.Minecraft.Ping:output_type -> minecraft.PingResponse
+	2, // [2:3] is the sub-list for method output_type
+	1, // [1:2] is the sub-list for method input_type
+	1, // [1:1] is the sub-list for extension type_name
+	1, // [1:1] is the sub-list for extension extendee
+	0, // [0:1] is the sub-list for field type_name
+}
+
+func init() { file_proto_minecraft_proto_init() }
+func file_proto_minecraft_proto_init() {
+	if File_proto_minecraft_proto != nil {
+		return
+	}
+	if !protoimpl.UnsafeEnabled {
+		file_proto_minecraft_proto_msgTypes[0].Exporter = func(v interface{}, i int) interface{} {
+			switch v := v.(*PlayerSample); i {
+			case 0:
+				return &v.state
+			case 1:
+				return &v.sizeCache
+			case 2:
+				return &v.unknownFields
+			default:
+				return nil
+			}
+		}
+		file_proto_minecraft_proto_msgTypes[1].Exporter = func(v interface{}, i int) interface{} {
+			switch v := v.(*PingRequest); i {
+			case 0:
+				return &v.state
+			case 1:
+				return &v.sizeCache
+			case 2:
+				return &v.unknownFields
+			default:
+				return nil
+			}
+		}
+		file_proto_minecraft_proto_msgTypes[2].Exporter = func(v interface{}, i int) interface{} {
+			switch v := v.(*PingResponse); i {
+			case 0:
+				return &v.state
+			case 1:
+				return &v.sizeCache
+			case 2:
+				return &v.unknownFields
+			default:
+				return nil
+			}
+		}
+	}
+	type x struct{}
+	out := protoimpl.TypeBuilder{
+		File: protoimpl.DescBuilder{
+			GoPackagePath: reflect.TypeOf(x{}).PkgPath(),
+			RawDescriptor: file_proto_minecraft_proto_rawDesc,
+			NumEnums:      0,
+			NumMessages:   3,
+			NumExtensions: 0,
+			NumServices:   1,
+		},
+		GoTypes:           file_proto_minecraft_proto_goTypes,
+		DependencyIndexes: file_proto_minecraft_proto_depIdxs,
+		MessageInfos:      file_proto_minecraft_proto_msgTypes,
+	}.Build()
+	File_proto_minecraft_proto = out.File
+	file_proto_minecraft_proto_rawDesc = nil
+	file_proto_minecraft_proto_goTypes = nil
+	file_proto_minecraft_proto_depIdxs = nil
+}

minecraft/proto/minecraft.pb.micro.go

@@ -0,0 +1,93 @@
+// Code generated by protoc-gen-micro. DO NOT EDIT.
+// source: proto/minecraft.proto
+
+package minecraft
+
+import (
+	fmt "fmt"
+	proto "github.com/golang/protobuf/proto"
+	math "math"
+)
+
+import (
+	context "context"
+	api "github.com/micro/micro/v3/service/api"
+	client "github.com/micro/micro/v3/service/client"
+	server "github.com/micro/micro/v3/service/server"
+)
+
+// Reference imports to suppress errors if they are not otherwise used.
+var _ = proto.Marshal
+var _ = fmt.Errorf
+var _ = math.Inf
+
+// This is a compile-time assertion to ensure that this generated file
+// is compatible with the proto package it is being compiled against.
+// A compilation error at this line likely means your copy of the
+// proto package needs to be updated.
+const _ = proto.ProtoPackageIsVersion3 // please upgrade the proto package
+
+// Reference imports to suppress errors if they are not otherwise used.
+var _ api.Endpoint
+var _ context.Context
+var _ client.Option
+var _ server.Option
+
+// Api Endpoints for Minecraft service
+
+func NewMinecraftEndpoints() []*api.Endpoint {
+	return []*api.Endpoint{}
+}
+
+// Client API for Minecraft service
+
+type MinecraftService interface {
+	Ping(ctx context.Context, in *PingRequest, opts ...client.CallOption) (*PingResponse, error)
+}
+
+type minecraftService struct {
+	c    client.Client
+	name string
+}
+
+func NewMinecraftService(name string, c client.Client) MinecraftService {
+	return &minecraftService{
+		c:    c,
+		name: name,
+	}
+}
+
+func (c *minecraftService) Ping(ctx context.Context, in *PingRequest, opts ...client.CallOption) (*PingResponse, error) {
+	req := c.c.NewRequest(c.name, "Minecraft.Ping", in)
+	out := new(PingResponse)
+	err := c.c.Call(ctx, req, out, opts...)
+	if err != nil {
+		return nil, err
+	}
+	return out, nil
+}
+
+// Server API for Minecraft service
+
+type MinecraftHandler interface {
+	Ping(context.Context, *PingRequest, *PingResponse) error
+}
+
+func RegisterMinecraftHandler(s server.Server, hdlr MinecraftHandler, opts ...server.HandlerOption) error {
+	type minecraft interface {
+		Ping(ctx context.Context, in *PingRequest, out *PingResponse) error
+	}
+	type Minecraft struct {
+		minecraft
+	}
+	h := &minecraftHandler{hdlr}
+	return s.Handle(s.NewHandler(&Minecraft{h}, opts...))
+}
+
+type minecraftHandler struct {
+	MinecraftHandler
+}
+
+func (h *minecraftHandler) Ping(ctx context.Context, in *PingRequest, out *PingResponse) error {
+	return h.MinecraftHandler.Ping(ctx, in, out)
+}

minecraft/proto/minecraft.proto

@@ -0,0 +1,41 @@
+syntax = "proto3";
+
+package minecraft;
+
+option go_package = "./proto;minecraft";
+
+service Minecraft {
+	rpc Ping(PingRequest) returns (PingResponse) {}
+}
+
+message PlayerSample {
+	// unique id of player
+	string uuid = 1;
+	// name of the player
+	string name = 2;
+}
+
+// Ping a minecraft server
+message PingRequest {
+	// address of the server
+	string address = 1;
+}
+
+message PingResponse {
+	// Latency (ms) between us and the server (EU)
+	uint32 latency = 1;
+	// Number of players online
+	int32 players = 2;
+	// Max players ever
+	int32 max_players = 3;
+	// Protocol number of the server
+	int32 protocol = 4;
+	// Favicon in base64
+	string favicon = 5;
+	// Message of the day
+	string motd = 6;
+	// Version of the server
+	string version = 7;
+	// List of connected players
+	repeated PlayerSample sample = 8;
+}

minecraft/publicapi.json

@@ -0,0 +1,6 @@
+{
+  "name": "minecraft",
+  "icon": "⛏💎",
+  "category": "utility",
+  "display_name": "Minecraft"
+}