Go to file
kercylan98 c9ff4570fe build: 更新依赖版本 2023-08-23 19:46:02 +08:00
.github build: 更新依赖版本 2023-08-23 19:46:02 +08:00
configuration feat: 重构 config 和 configexport 包 2023-07-17 13:28:17 +08:00
game refactor: 调整 server 数据包相关处理函数的接收参数不再为 server.Packet,同时移除 server.Packet 2023-08-23 19:29:55 +08:00
notify refactor: room 包移除大量 error 返回,增加易于房间操作 Helper 数据结构,可通过 Manager.GetHelper 和 room.NewHelper 获取 2023-07-28 10:48:45 +08:00
planner build: 更新依赖版本 2023-08-23 19:46:02 +08:00
server build: 更新依赖版本 2023-08-23 19:46:02 +08:00
utils build: 更新依赖版本 2023-08-23 19:46:02 +08:00
.gitignore 有限状态机实现 2023-05-26 10:49:16 +08:00
CHANGELOG.md chore(master): release 0.0.31 2023-08-22 15:36:47 +08:00
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md 2023-05-30 14:29:59 +08:00
CONTRIBUTING.md docs: README.md 及 CONTRIBUTING.md 完善 2023-08-02 18:43:12 +08:00
LICENSE LICENSE 2023-05-29 20:35:03 +08:00
README.md revert: 设计原因移除 report 包,采用 utils/counter 2023-08-21 17:12:01 +08:00
go.mod build: 更新依赖版本 2023-08-23 19:46:02 +08:00
go.sum build: 更新依赖版本 2023-08-23 19:46:02 +08:00
local-doc.bat 文档及许可 2023-05-29 20:15:13 +08:00
local-doc.sh 代码扫描问题处理 (#3) (#4) 2023-05-30 14:24:03 +08:00
qodana.yaml build: 更新依赖版本 2023-08-23 19:46:02 +08:00

README.md

Minotaur

Go doc

Minotaur 是一个基于Golang 1.20 编写的服务端开发支持库,其中采用了大量泛型设计,用于游戏服务器开发。

目录结构概况

mindmap
  root((Minotaur))
    /configuration 配置管理功能
    /game 游戏通用功能
      /builtin 游戏通用功能内置实现
    /notify 通知功能接口定义
    /planner 策划相关工具目录
      /pce 配置导表功能实现
    /server 网络服务器支持
      /cross 内置跨服功能实现
      /router 内置路由器功能实现
    /utils 工具结构函数目录

Server 架构预览

server-gdi.jpg

安装

注意:依赖于 Go 1.20 +

运行以下 Go 命令来安装软件包:minotaur

$ go get -u github.com/kercylan98/minotaur

用法

本地文档

可使用 godoc 搭建本地文档服务器

安装 godoc

git clone golang.org/x/tools
cd tools/cmd
go install ...

使用 godoc 启动本地文档服务器

godoc -http=:9998 -play

Windows

.\local-doc.bat

Linux or MacOS

chmod 777 ./local-doc.sh
./local-doc.sh

文档地址

简单示例

创建一个基于Websocket的回响服务器。

package main

import (
	"github.com/kercylan98/minotaur/server"
)

func main() {
	srv := server.New(server.NetworkWebsocket)
	srv.RegConnectionReceivePacketEvent(func(srv *server.Server, conn *server.Conn, packet server.Packet) {
		conn.Write(packet)
	})
	if err := srv.Run(":9999"); err != nil {
		panic(err)
	}
}

访问 WebSocket 在线测试 进行验证。

Websocket地址: ws://127.0.0.1:9999

持续更新的示例项目

参与贡献

请参考 CONTRIBUTING.md 贡献指南。

JetBrains OS licenses

Minotaur had been being developed with GoLand IDE under the free JetBrains Open Source license(s) granted by JetBrains s.r.o., hence I would like to express my thanks here.