返回作品集
Jun 18, 2026
2 min read

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

一款致力于让中华传统文化「活起来」的国风探索与策略卡牌竞技游戏。项目将《山海经》异兽、古建筑营造与传统兵器转化为机关解谜与见招拆招的卡牌对决;主导完成 Spring Boot 3 服务端脚手架搭建、SMTP 邮箱验证码注册登录系统、Netty + Protobuf 高实时二进制通信网关、服务端权威卡牌业务逻辑计算引擎,以及好友申请与实时聊天室模块的完整设计与落地。

实机演示

左右滑动或点击卡片切换
01
02
03
04
05
06
07
08

核心负责职责与后端架构落地

在当下的游戏市场中,不少国风作品虽然画面精美,但《山海经》异兽、古代建筑与传统兵器往往只停留在「好看的皮肤与背景板」,玩家玩过之后很难真正记住背后的文化故事;而部分主打文化科普的作品又容易陷入「看大段文字、死记硬背通关密码」的枯燥说教。《仙灵劫》从玩家的真实游玩乐趣出发,将古建秘境摸金、有温度的 AI 江湖向导、三分钟一局的见招拆招对决、以及可收藏的掌上文化图鉴融为一体,打磨出一条「在解谜中开窍、在过招中内化、在收集中热爱」的国风体验闭环。

作为项目的后端负责人,我从零主导了整个游戏服务端架构的设计与核心业务研发,重点负责以下五大模块:

1. Spring Boot 3 后端工程脚手架与基础底座搭建

  • 标准化服务端工程地基:主导将后端工程重构升级至 Java 21 + Spring Boot 3 技术基线,规范化划分模块化业务包结构与多环境隔离配置(本地开发 / 测试 / 生产环境密钥外部化)。
  • 统一契约与安全防线:搭建带全链路追踪(traceId)与服务端时间戳的统一响应体、全局异常拦截器、无状态 Spring Security 鉴权过滤链、MyBatis-Plus 持久层以及 Redis 缓存组件,为多人联机与高频业务交互提供稳固的工程底座。

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

  • SMTP 邮件服务与验证码核验:独立研发邮箱验证码收发系统,基于 Redis 实现 600 秒有效期的六位数字验证码生成、防刷限流与一次性核验,并通过 SMTP 邮件服务稳定投递注册与登录验证邮件。
  • 多方式登录与令牌轮换机制:完整打通邮箱验证码注册、邮箱验证码免密登录、账号密码登录三大入口;采用短期 Access Token 与长期 Refresh Token 双向轮换刷新机制保障会话安全,并在注册阶段同步完成玩家专属 9 位公开 ID 分配、默认名片出战配置初始化及用户协议签署版本存证。

3. Netty + Protobuf 保证高实时双工通信与断线重连

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

4. 服务端权威(Server-Authoritative)卡牌业务逻辑计算

  • 核心战斗规则全量服务端裁决:摒弃易被篡改的客户端本地算分模式,在服务端构建纯 Java 无状态战斗结算引擎与回合/连招状态机。所有出牌指令均经过状态版本校验与 Redis + 数据库双重幂等防重,由服务端权威计算武器招式环形克制、闪避与防反夺刀、破防连续追击、山海灵兽与护甲减伤管线、以及第三回合机缘商店灵石购卡逻辑。
  • 战争迷雾防窥与服务端智能博弈 AI:通过信息隐藏过滤器严格裁剪双方手牌私有视图(杜绝窥牌外挂),按严格递增序号向客户端广播战斗演出事件;同时在服务端落地带出牌记忆、残血服药自救、副武器切换与机缘商店理财规划的无头 AI 控制器,完整支撑单人试炼与实时竞技。

5. 好友申请体系与实时私聊聊天室搭建

  • 严谨的好友关系链流转:构建涵盖好友申请、同意/拒绝审批、双向互申自动撮合成友、好友列表实时在线状态感知,以及拉黑级联清理好友关系与待处理申请的完整社交关系链。
  • 复用 Protobuf 信道的实时聊天室与容灾兜底:在统一 /ws 二进制管道上扩展私聊上行、实时推送与发送方回执(CHAT_ACK)信封,严格执行「仅限互为好友且未拉黑方可通信」的前置越权拦截;采用 MySQL 离线消息持久化 + Redis 24h 容灾降级缓存双保险架构,支持历史消息分页合并拉取与未读消息自动批量标记已读,实现毫秒级直推与离线不断线的聊天室闭环。

搜索作品集

输入关键词开始搜索