{"id":18720430,"url":"https://github.com/yangjianxin1/tankbattle","last_synced_at":"2025-04-12T14:14:39.123Z","repository":{"id":39806873,"uuid":"231291872","full_name":"yangjianxin1/TankBattle","owner":"yangjianxin1","description":"基于Netty的联机版坦克大战","archived":false,"fork":false,"pushed_at":"2022-12-10T03:26:34.000Z","size":1790,"stargazers_count":19,"open_issues_count":12,"forks_count":10,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-26T08:51:36.319Z","etag":null,"topics":["marshalling","mysql","netty","spring","spring-java","tank","tankbattle","tankcity"],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yangjianxin1.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-01-02T02:19:21.000Z","updated_at":"2024-10-10T03:33:30.000Z","dependencies_parsed_at":"2023-01-26T01:45:13.369Z","dependency_job_id":null,"html_url":"https://github.com/yangjianxin1/TankBattle","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yangjianxin1%2FTankBattle","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yangjianxin1%2FTankBattle/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yangjianxin1%2FTankBattle/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yangjianxin1%2FTankBattle/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yangjianxin1","download_url":"https://codeload.github.com/yangjianxin1/TankBattle/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248578822,"owners_count":21127713,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["marshalling","mysql","netty","spring","spring-java","tank","tankbattle","tankcity"],"created_at":"2024-11-07T13:31:03.526Z","updated_at":"2025-04-12T14:14:39.085Z","avatar_url":"https://github.com/yangjianxin1.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 基于Netty的联机版坦克大战\n\n## 项目介绍\n该项目实现了联机版坦克大战，项目包括客户端与服务端\n\n项目使用技术：\n- 使用Netty实现客户端和服务端之间的通讯\n- 使用Marshalling作为编解码技术\n- 游戏界面使用java自带的swing与awt进行编写\n- 使用Spring的依赖注入与java的反射机制简化了消息类型的判定\n- 使用Mysql数据库\n- 使用log4j记录日志\n\n实现功能：\n- 人机对战\n- 多玩家开房间对战\n- 碰撞检测\n- 机器坦克使用A*算法，进行路径规划\n- 机器坦克有巡逻范围的概念，当玩家坦克进入其巡逻范围，机器坦克才会使用A*寻路前往玩家坦克的位置\n- 限制了子弹的飞行距离，当子弹到达飞行距离上限、击中障碍物、碰到边界时，子弹会爆炸。子弹爆炸是范围性伤害，在爆炸范围内，砖块和坦克都会被消灭\n- 游戏支持多地图，玩家可以选择任意一幅地图\n- 实现心跳机制，断线重连功能\n- 在人机对战模式中，支持进度保存\n- 实现用户登录、注册等功能\n\n## 效果展示\n\n在人机对战模式中，有多幅地图可供选择：\n\n![map1](image/map1.png) \u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;![map2](image/map2.png)\n\n![map3](image/map3.png) \u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;![map4](image/map4.png)\n\n玩家对战模式：\n \n ![pvp](image/pvp.png)\n\n## 使用方式\n本项目使用maven构建，原则上不需要用户自行下载各种jar包，但是在pom.xml中添加jboss-marshalling-serial-1.3.0.CR9.jar\n依赖包，运行程序时会抛出异常，无法正常运行(原因暂时不明)，因此需要还自行将lib文件夹下的jboss-marshalling-serial-1.3.0.CR9.jar包添加到客户端和服务端的Build\nPath中\n\n使用步骤：\n- 将lib文件夹下的jar包添加到Build Path\n- 安装Mysql数据库，将根目录下的tank_db.sql文件导入数据库\n- 设置数据库账号和密码：在tankServer的com.tank.dao.DBHelper.getConnection()中修改数据库用户和密码(暂时以硬编码的形式，未弄成配置文件的形式)\n- 对客户端与服务端程序构建，maven insatll，自动下载各种依赖包\n- 运行tankServer项目中的com.tank.server.handler.TankServer.java，启动服务端程序\n- 运行tankClient项目中的com.tank.start.TankStart.java，启动客户端(若要进行玩家联机对战，需要启动多个客户端)\n- 使用已有账号登录，或者注册新的账号（可以使用数据库中已有的账号li或yu进行登录，密码为12）\n- 选择对战模式（若是玩家对战，需要先开房间，房间内至少需要两人，方可开始游戏）\n- 人机模式下可选择不同的地图，地图数据存储在数据库中\n- 使用方向键控制坦克进行移动，按键X发射子弹（所有坦克一次只能发射一个子弹，只有子弹爆炸后，才能再发射新的子弹），在人机模式下，按键S保存游戏进度\n\n## 项目结构\n### Client项目结构：\n- lib：一些jar包\n- log：存放日志\n- pom.xml：maven配置文件\n- src/main/java：存放源码\n  - com.tank.beanPostProcessor：存放自定义的Spring容器的后处理器，自定义的消息处理的注解等\n  - com.tank.client.handler：Netty相关的一些消息处理的类\n  - com.tank.entity：定义游戏中的实体，如坦克、砖块、子弹、水、铁块等\n  - com.tank.map：存放地图相关数据\n  - com.tank.request：各种类型的请求消息实体\n  - com.tank.response：各种类型的响应消息实体\n  - com.tank.service：存放处理消息的一些类\n  - com.tank.start：启动客户端\n  - com.tank.view：客户端界面的一些类\n  - com.tank.view.controller：处理用户按键\n  - com.tank.thread：线程相关类\n  - images：存储客户端界面相关的图片\n  - application-context.xml：Spring容器配置文件\n\n\n### Server项目结构：\n- lib：一些jar包\n- log：存放日志\n- pom.xml：maven配置文件\n- src/main/java：存放源码\n  - com.tank.beanPostProcessor：存放自定义的Spring容器的后处理器，自定义的消息处理的注解等\n  - com.tank.dao：定义数据库的增删改查操作\n  - com.tank.dao.entity：数据库相关实体\n  - com.tank.entity：定义游戏中的实体，如坦克、砖块、子弹、水、铁块等\n  - com.tank.facade：消息处理的门面类\n  - com.tank.map：可以用于生成地图\n  - com.tank.request：各种类型的请求消息实体\n  - com.tank.response：各种类型的响应消息实体\n  - com.tank.server.handler：Netty相关的一些消息处理的类\n  - com.tank.service：存放处理消息的一些类\n  - com.tank.thread：线程相关类\n  - application-context.xml：Spring容器配置文件\n\n\n## 碰撞检测\n碰撞检测机制比较简单，检测的原理如下图。先假设坦克往前移动一步，然后计算两个物体中心之间的距离d，若d不超过两个物体宽度之和，则坦克向前走一步不会发生碰撞，否则会碰撞\n\n![collision](image/collision.png)\n\n## 消息处理\n以服务端为例，服务端程序需要根据不同的消息类型，采取不同的处理方式。最简单的实现方式，就是使用if-else先识别消息类型，再对消息进行处理，但每增加一种消息类型，就需要增加一个if分支。\n\n使用Spring容器与java反射机制，对消息类型判定的逻辑进行简化，逻辑如下：\n- 自定义一个注解@HandlerAnno，每个处理消息的类使用@Component进行注解，每个处理消息的方法都使用@HandlerAnno进行注解\n- 自定义一个BeanPostPostProcessor。当Spring容器初始化时，Spring容器会扫描所有方法，获得使用@HandlerAnno标注的Method，并将其注册到一个HashMap\u003c消息类型，处理Method\u003e中\n- 当服务端收到一个消息时，从HashMap中取出对应的Method，然后使用java的反射机制，执行该方法，以对消息进行处理\n\n下面是使用if-else对消息类型进行判别时的部分代码，代码比较冗长：\n```\npublic void channelRead(ChannelHandlerContext ctx, Object msg) throws Exception {\n    if (msg instanceof RegisterRequest) {\n    \n    } else if (msg instanceof StartGameRequest) {\n\t\t\n    } else if (msg instanceof CloseClientRequest) {\n\t\t\n    } else if (msg instanceof SavePogressRequest) {\n\t\t\n    } else if (msg instanceof JudgeStorageRequest) {\n\n    } else if (msg instanceof PingRequest) {\n\t\t\n    } else if (msg instanceof ReConnectRequest) { \n\t\t\n    }\n}\n\n```\n使用@HandlerAnno注解机制之后，仅需为每种消息的处理方法加上@HandlerAnno注解，而channelRead()的代码只需几行即可，不再需要冗长的if-else语句对消息类型进行判定\n```\n@HandlerAnno\npublic void login(Channel channel, LoginRequest request) {// 登陆请求\n\tString name = request.getId();\n\tString password = request.getPassword();\n\tLoginResponse response = gameService.login(name, password, channel);\n\tchannel.writeAndFlush(response);\n}\n\n@HandlerAnno\npublic void startGame(Channel channel, StartGameRequest request) {\t//开始游戏\n\tgameService.startGame(request, channel);\n}\n\n@HandlerAnno\npublic void register(Channel channel, RegisterRequest request) {// 注册请求\n\tRegisterResponse response = gameService.register(request);\n\tchannel.write(response);\n}\n\n...\n\n\npublic void channelRead(ChannelHandlerContext ctx, Object msg) throws Exception {\n\tlog.debug(\"RECEIVE MSG-\u003e\"+msg);\n\tif(msg instanceof PingRequest){\t//如果收到的是心跳消息，不处理\n\t\t\t\n\t}else{\t//处理非心跳消息\n\t\tdispatcher.doHandle(ctx.channel(), msg);\n\t}\n\t\t\n}\n\n```\n\n## A*寻路\n在介绍A*算法之前，先简单说一下广度优先遍历的寻路算法。在广度优先遍历寻路算法中，从起点开始，通过不断增大搜索半径，对周围的节点进行扩展，以找到终点。\n很显然，广度优先遍历寻路算法找到路径一定是最短的，但是缺点也很明显，该算法的时间复杂度非常大，需要额外扩展很多无用的节点。**这主要是因为广度优先遍历寻路算法只关注当前节点和起始节点之间的距离，而忽略了当前节点到目标节点的距离**\n\nA\\*算法是一种比较常见的启发式路径搜索算法，不同于广度优先遍历寻路算法，**A\\*算法在关注当前节点和起始节点之间的距离的同时，还关注当前节点到目标节点的距离。**\n\n定义几个表达式：\n- G（n）：起点到节点n的耗散值。耗散值为从起点走到节点n的步数\n- H（n）：节点n到终点的估计耗散值。耗散值为节点n走到终点的欧几里得距离、曼哈顿距离或者其他的距离，可以自行定义，**启发式函数的选择对算法最终的效果至关重要**\n- F（n）：起点经过节点n，达到终点需要的耗散值\n- F（n）=G（n）+H（n）\n\n在A\\*算法中会维护一个open表和closed表\n- open表：存放待扩展的节点，用优先队列PriorityQueue实现，F值最小的排在队首\n- closed表：存放已扩展或者不可扩展的节点，用Hashset实现\n\n算法伪代码： \n```\n使用PriorityQueue定义openTable（F值最小的节点排在队首）\n使用HashSet定义closedTable\n将起始节点放入openTable\nrepeat\n    从openTable中取出队首节点P\n    if P是终点\n        算法结束\n    for neighbor in P的所有邻居：\n        if neighbor不是障碍物 and neighbor不在closedTable中：\n            将neighbor放入openTable\n    将节点P放入closedTable\nuntil openTable为空 or 找到终点\n```\n\n## 心跳检测与断线重连\n心跳机制就是客户端定时发送一个心跳包，让服务端知道自己还活着，以确保连接的有效性。\n\n实现方式：\n- 客户端监听通道写空闲事件，如果5s内通道写空闲，则客户端发送一个心跳消息给服务端，保证服务端在5s左右不会出现读空闲\n- 服务端监听通道写空闲事件，如果10s内通道读空闲，则服务端认为该客户端连接已失效，断开连接，释放该连接，但不释放该客户端对应的游戏资源，\n等待客户端重新连接\n- 客户端检测到断开连接后，重新连接服务端\n\n## 子弹逻辑\n由于坦克发射子弹之后，子弹会沿着发射的方向飞行，需要定时更新子弹的位置。为了解决该问题，在本项目中，当一个坦克发射一枚子弹后，会开启一个新线程，用于更新子弹的状态。当子弹爆炸之后，该线程结束。\n\n子弹的飞行距离是有上限的，每隔一定的时间间隔，线程更新子弹的位置信息，并且判断子弹是否击中砖块、坦克、钢块、是否达到飞行距离上限、是否达到边界。\n如果条件成立，则子弹会发生爆炸，产生范围性伤害，对爆炸范围内的物体造成伤害。\n\n## 机器坦克逻辑\n在人机对战模式中，机器坦克有个巡逻范围的概念。只有当玩家坦克进入机器坦克的巡逻范围，机器坦克才会对玩家坦克的位置进行路径规划。\n\n在人机对战中，每局游戏在服务端中都有一个专门进行路径规划的线程，为该局游戏中的所有机器坦克进行路径规划，并且分时间片执行每个机器坦克的路径。游戏结束时，线程结束。\n\n当机器坦克在移动过程中，若玩家坦克与机器坦克处于同一直线上，且机器坦克还有子弹，则机器坦克会向玩家坦克发射一枚子弹\n\n## 不足\n- 机器坦克使用A*算法，得到规划的路径之后，尚未对路径进行平滑处理，因此会得到大量锯齿形路径，表现为坦克不断抖动。\n- 每颗子弹发射后，都会开启一个新线程，直至子弹爆炸，线程结束。并且每局人机对战都会开启一个专门的线程为每个机器坦克进行路径规划。因此在较多用户同时进行人机对战时，可能会遇到瓶颈。\n- 子弹线程和路径规划线程偶尔会抛出空异常，问题还未解决，但不影响使用（手动狗头）","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyangjianxin1%2Ftankbattle","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyangjianxin1%2Ftankbattle","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyangjianxin1%2Ftankbattle/lists"}