Personal Space
返回作品集
2026.06Java21、SpringBoot3、Netty、Protobuf、Redis、Unity

仙灵劫 · 国风文化探索与策略卡牌对战游戏

《仙灵劫》是一款融合《山海经》志怪、仙灵美学、传统玄学文化的国风休闲仙侠游戏,主打特色是一款致力于让中华传统文化“活起来”的国风探索与策略卡牌竞技游戏。项目将《山海经》异兽、 古建筑营造与传统兵器转化为机关解谜与见招拆招的卡牌对决;我主要负责后端 WebSocket 实时对战模块的完善与落地。基于 Netty、Spring Boot 和 Protobuf,完成从客户端战斗指令接收、服务端权威计算、实时通信、状态更新、事件广播、断线恢复到对局结算的完整链路。

GAMEPLAY ARCHIVE

实机演示

收录宗门养成、卡牌战斗、召唤台、装备背包与实时社交等实机画面。

ENGINEERING NOTES

核心职责

在项目协作中,我主要聚焦账号体系、实时通信和卡牌结算这三条关键链路。 目标不是只完成单点功能,而是让登录、连接、对战与社交能够在同一套可靠的工程边界内持续演进。

01

Spring Boot 3 后端工程脚手架与基础底座

  • 主导后端工程底座升级,基于 Java21+SpringBoot3 搭建脚手架,划分模块化包结构,配置多环境隔离;实现统一响应封装、全局异常捕获、全链路追踪、安全鉴权等基础组件,让后续玩法模块能够持续扩展。
  • 统一异常处理、接口响应、日志追踪与基础鉴权约定,并接入 MyBatis-Plus、Redis 等常用组件,降低多人协作时的重复成本。
02

邮箱验证码系统与账号注册登录闭环

  • SMTP 邮件服务与验证码核验:协作研发邮箱验证码收发系统,基于 Redis 实现 600 秒有效期的六位数字验证码生成、防刷限流与一次性核验,并通过 SMTP 邮件服务稳定投递注册与登录验证邮件。
  • 使用 Access Token 与 Refresh Token 分离短期身份和长期会话,并在注册阶段同步完成玩家账号与初始资料创建以及完成多渠道登录。
03

Netty + Protobuf 实时双工通信与断线重连

  • Netty 嵌入式长连接与二进制协议栈:针对卡牌对战的高实时低延迟要求,搭建独立端口的 Netty WebSocket(/ws)长连接网关,全链路采用 Google Protocol Buffers(Protobuf)二进制字节流替代传统 JSON 文本传输,大幅降低数据包体积与序列化开销。
  • 零阻塞鉴权、互踢保护与 120s 断线重连:在握手阶段通过自定义处理器完成 JWT 身份校验与会话绑定,支持心跳保活检测、同账号异地重复登录自动互踢(KICKED),并将 I/O 线程与耗时业务线程池严格隔离;同时配合对局事件日志实现 120 秒断线重连快照下发与缺失事件帧按序补发,确保弱网切屏后一秒无缝恢复战局。
04

服务端权威卡牌业务逻辑计算

  • 推动战斗架构向“服务端权威状态”演进:客户端只提交操作意图并消费服务端事件,不在前端重复实现伤害、资源、Buff、连招及胜负计算逻辑,从而保证多人对战的一致性、公平性和可追溯性。
  • 建立服务端权威 MatchState 模型,接入卡牌、Buff、伤害、护甲、资源、连招、商店、成就与 AI 规则。用清晰的规则边界组织卡牌效果和战斗流程,为后续增加异兽、装备和组合效果预留可维护的扩展点。