tgf - 一个开箱即用的golang游戏服务器框架

tgf框架

tgf框架是使用golang开发的一套游戏分布式框架.属于开箱即用的项目框架,目前适用于中小型团队,独立开发者,快速开发使用.框架提供了一整套开发工具,并且定义了模块开发规范.开发者只需要关注业务逻辑即可,无需关心用户并发和节点状态等复杂情况.

使用介绍

创建业务逻辑节点

go 复制代码
package quick_start

import (
	"context"
	"github.com/thkhxm/tgf"
	"github.com/thkhxm/tgf/log"
	"github.com/thkhxm/tgf/rpc"
	"github.com/thkhxm/tgf_example/common/pb"
)

//***************************************************
//@Link  https://github.com/thkhxm/tgf
//@Link  https://gitee.com/timgame/tgf
//@QQ群 7400585
//author tim.huang<thkhxm@gmail.com>
//@Description
//2023/11/21
//***************************************************

//服务启动函数,在这个例子中我们将网关和业务节点放在了同一个服务中启动.
func Startup() {
	c := rpc.NewRPCServer(). //创建一个rpc服务
					WithGatewayWS("8032", "/example",nil). //启动一个网关
					WithService(&HallService{}).       //启动一个service的服务
					WithWhiteService("SayHello"). //添加客户端请求接口到白名单,无需登录即可访问
					WithCache(tgf.CacheModuleClose).   //关闭redis等缓存服务
					Run()
	select {
	case <-c:
		log.InfoTag("service", "service is down ")

	}
}
//接口约束
var _ rpc.IService = &HallService{}

// HallService
// @Description: implements rpc.IService
type HallService struct {
	rpc.Module
}
//客户端请求接口
func (h *HallService) SayHello(ctx context.Context, args *rpc.Args[*pb.DefaultRequest], reply *rpc.Reply[*pb.DefaultRequest]) (err error) {
	log.InfoTag("hall", "%s say hello ", args.GetData().Val)
	reply.SetData(&pb.DefaultRequest{Val: "good luck"})
	return
}

//服务器rpc请求接口
func (h *HallService) GetMyNodeId(ctx context.Context, args *rpc.DefaultArgs, reply *rpc.DefaultReply) (err error) {
	log.InfoTag("rpc", "hello %s", args.C)
	reply.C = tgf.NodeId
	return
}

//模块名称
func (h *HallService) GetName() string {
	return "hall"
}
//模块版本
func (h *HallService) GetVersion() string {
	return "v1.0"
}
//启动函数,该函数会在服务启动之后立马执行
func (h *HallService) Startup() (bool, error) {
	return true, nil
}

可以看到我们创建一个服务十分简单,只需要实现IService接口即可.这时候服务就完全启动了.而开发人员只需要关注业务代码即可.

其他详细的教程,可以查看

项目文档

项目地址

规划

项目后续会更新系列教程文章和视频教程,并且开源项目案例.也会不断的更新和优化项目框架.欢迎大家加入qq群一起交流和探讨.

交流群

QQ群:7400585

技术选型

Golang开发版本: 1.21.1

技术 说明 仓库地址
rpcx 底层rpc的实现 https://github.com/smallnest/rpcx
redis 提供数据缓存 https://redis.io/
hashmap 线程安全的集合 https://github.com/cornelk/hashmap
ants 高性能go协程池 https://github.com/panjf2000/ants
redislock 分布式redis锁 https://github.com/bsm/redislock
snowflake 雪花算法 https://github.com/bwmarrin/snowflake
doublejump 一致性hash https://github.com/edwingeng/doublejump
godotenv 环境变量工具 https://github.com/joho/godotenv
zap 日志框架 https://go.uber.org/zap
lumberjack 日志切割工具 https://gopkg.in/natefinch/lumberjack.v2
excelize Excel工具 https://github.com/qax-os/excelize
sonic json高性能工具 https://github.com/bytedance/sonic/

基础架构图

相关推荐
AA陈超1 小时前
虚幻引擎UE5专用服务器游戏开发-33 在上半身播放组合蒙太奇
c++·游戏·ue5·游戏引擎·虚幻
AA陈超4 小时前
虚幻引擎5 GAS开发俯视角RPG游戏 P05-05 游戏效果委托
c++·游戏·ue5·游戏引擎·虚幻
赴前尘4 小时前
Go 微服务框架排行榜(按 GitHub Star 排序)
微服务·golang·github
m0_552200824 小时前
《UE5_C++多人TPS完整教程》学习笔记62 ——《P63 多人游戏中的开火特效(Fire Effects in Multiplayer)》
c++·游戏·ue5
软希网分享源码8 小时前
游戏攻略新闻资讯主题模板源码 YK一点资讯模版 Zblog主题模版(源码下载)
游戏·游戏攻略新闻资讯主题模板源码
大Mod_abfun8 小时前
Unity游戏基础-5(一些细节)
游戏·unity·游戏引擎
Sesame214 小时前
gotun: 一个基于SSH协议的零配置HTTP代理工具
go
自学AI的鲨鱼儿14 小时前
ubuntu22.04安装gvm管理go
开发语言·后端·golang
AA陈超14 小时前
虚幻引擎5 GAS开发俯视角RPG游戏 P04-12 可缩放浮点数的曲线表
c++·游戏·ue5·游戏引擎·虚幻