【JS球球大作战项目实战】 在线体验

个人名片：

🐼作者简介：一名大三在校生，喜欢AI编程🎋
🐻‍❄️个人主页🥇：落798.
🐼个人WeChat：hmmwx53
🕊️系列专栏：🖼️

• 零基础学Java——小白入门必备🔥
• 重识C语言——复习回顾🔥
• 计算机网络体系———深度详讲
• HCIP数通工程师-刷题与实战🔥🔥🔥
• 微信小程序开发——实战开发🔥
• HarmonyOS 4.0 应用开发实战——实战开发🔥🔥🔥
• Redis快速入门到精通——实战开发🔥🔥🔥
• RabbitMQ快速入门🔥
  🐓每日一句：🍭我很忙，但我要忙的有意义！
  欢迎评论 💬点赞👍🏻 收藏 📂加关注+

文章目录

• BallBattle
• • 简介
  • 背景设定
  • 玩法
  • 主要功能
  • • 匹配对战
    • 属性同步与保存
    • • 房间属性
      • 玩家属性
    • 自定义事件
    • 其他功能
    • • 消息处理控制
      • 移动同步
  • 项目结构
  • 欢迎添加微信，加入我的核心小队，请备注来意

BallBattle

简介

《球球大作战》是一款由巨人网络Superpop&Lollipop工作室自主研发，并且免费（不包括道具）的手机网络游戏。2015年5月27日由巨人网络在中国大陆发行。

游戏以玩家间的实时互动PK为设计宗旨，通过简单的规则将玩家操作直接转化为游戏策略，体验智谋碰撞的战斗乐趣。在这个球球的世界里，每个人都化身为一颗独特的球球，大球吃小球，努力生存下来就是唯一的目标。

线上体验

背景设定

在宇宙深处一片遍布着荆棘之花的神秘星云中，生活着一群名叫“波拉哩”（译名“球球”）的奇特生物。他们外表萌萌，却有着勇敢的心。他们是天生的战斗种族，为战斗而生，为战斗而亡。

传说中，这群波拉哩的共同祖先是一只叫“塔坦”的超级波拉哩，塔坦的职责就是守护宇宙瑰宝“荆棘之花”，它拥有强大的能量，会分出分身，变化万物，唯一的弱点就是贪吃。

一天，塔坦终于禁不住诱惑，偷食了“荆棘之花”，结果身体爆裂，成为了数以亿计的小波拉哩。从此，波拉哩的族群就受到了贪食的诅咒，只能在这片星云中无休止的战斗，如果停止战斗，生命便会流失，消亡在茫茫的星空之中。在漫漫的历史长河里，只有最强大的波拉哩才能冲过这片黑暗星云，打破命运的枷锁，去寻找那传说中的光明与和平。

为了那甜蜜的希望，波拉哩们战斗着。他们必须奋力奔跑，让自己变大变大再变大，才能对抗比自己更强的存在。哪怕经历无数失败也必须重新凝聚力量，直到成为最强壮的那个。

玩法

输入房间 ID，加入房间（如果没有此房间，则创建）。
用户 ID 随机生成。
使用 ⬆️⬇️⬅️➡️ 或 WSAD 来控制小球移动，吃掉场景中的食物（三角形，方形，六边形）则会增长体重（并减少速度）；遇到其他球（玩家），碰撞之后，体重较大者获胜，较小者将会死亡并重生。
右侧面板显示当前房间的玩家体重排行榜。

主要功能

匹配对战

最基础的房间 ID 匹配。

更多关于房间匹配文档

属性同步与保存

这个 demo 使用的是 Master Client 机制，但由于 Master Client 可能存在掉线等异常情况，所以需要将房间和玩家的部分数据保存至 Room Properties 和 Player Properties。

更多关于属性同步文档

房间属性

• 房间用时
• 战场的食物列表
• 食物最大 ID

食物：

/**
 * 食物
 */
cc.Class({
  extends: cc.Component,

  properties: {
    id: 0,
    type: 0
  },

  getProperties() {
    const id = this.id;
    const type = this.type;
    const { x, y } = this.node.position;
    return {
      id,
      type,
      x,
      y
      // 可能还会有能量值
    };
  }
});

玩家属性

• 位置
• 体重
• 速度

球：

const Constants = require("Constants");
const Food = require("./Food");

/**
 * 球
 */
cc.Class({
  extends: cc.Component,

  properties: {
    nameLabel: {
      type: cc.Label,
      default: null
    },
    infoLabel: {
      type: cc.Label,
      default: null
    }
  },

  init(player) {
    this.player = player;
  },

  eat() {
    // 计算尺寸
    const { weight } = this.player.customProperties;
    const scale = Math.sqrt(weight) / Constants.BORN_SIZE;
    this.node.scale = cc.v2(scale, scale);
  },

  reborn() {
    // 计算尺寸
    const { weight, pos } = this.player.customProperties;
    const scale = Math.sqrt(weight) / Constants.BORN_SIZE;
    this.node.scale = cc.v2(scale, scale);
    // 位置
    const { x, y } = pos;
    this.node.position = cc.v2(x, y);
  },

  getId() {
    return this.player.actorId;
  },

  getSpeed() {
    const { speed } = this.player.customProperties;
    return speed;
  },

  getWeight() {
    const collider = this.node.getComponent(cc.CircleCollider);
    const { radius } = collider;
    const { scaleX, scaleY } = this.node;
    return Constants.PI * Math.pow(radius, 2) * scaleX * scaleY;
  },

  // LIFE-CYCLE CALLBACKS:

  start() {
    this.nameLabel.string = this.player.userId;
  },

  update(dt) {
    const { x, y } = this.node;
    this.infoLabel.string = `(${parseInt(x)}, ${parseInt(y)})`;
  },

  // 碰撞
  onCollisionEnter(other, self) {
    const { group: otherGroup } = other.node;
    if (otherGroup === Constants.FOOD_GROUP) {
      this._onCollideFood(other, self);
    } else if (otherGroup === Constants.BALL_GROUP) {
      this._onCollideBall(other, self);
    }
  },

  _onCollideFood(other, self) {
    // 球碰食物，客户端模拟
    const { node: foodNode } = other;
    const { x, y } = self.node.position;
    cc.log(`collide food: (${x}, ${y})`);
    const food = foodNode.getComponent(Food);
    foodNode.active = false;
    // 交由 Master 处理
    const event = new cc.Event.EventCustom(
      Constants.BALL_AND_FOOD_COLLISION_EVENT,
      true
    );
    event.detail = {
      ball: this,
      food
    };
    this.node.dispatchEvent(event);
  },

  _onCollideBall(other, self) {
    const { node: b1Node } = other;
    const { node: b2Node } = self;
    const event = new cc.Event.EventCustom(
      Constants.BALL_AND_BALL_COLLISION_EVENT,
      true
    );
    event.detail = {
      b1Node,
      b2Node
    };
    this.node.dispatchEvent(event);
  }
});

自定义事件

• 玩家出生：对于当前玩家，执行战场初始化逻辑；对于其他玩家，执行增加玩家逻辑。
• 吃食物：客户端移除内存中的食物节点，同步玩家体重。
• 杀死玩家：用于同步节点间碰撞事件。
• 玩家重生：用于重新初始化玩家数据。
• 生成食物：同步房间内的食物数据。
• 玩家离开：用于移除场景和 UI 对应节点。
• 游戏结束：用于返回主菜单场景。

其他功能

消息处理控制

由于从主场景加载到战斗场景，存在异步的资源加载过程，所以需要暂停 / 恢复消息队列的处理。流程如下：

• 加入房间
• 暂停消息处理
• 加载战斗场景
• 初始化战场
• 恢复消息队列。

移动同步

移动同步实现思路是玩家在运动状态改变时，将当前运动状态同步给其他客户端，其他客户端对玩家行为进行模拟。而在运动过程中，并不同步移动数据。

运动状态包括：

• 位置
• 移动方向
• 时间戳

模拟步骤：

• 在收到运动状态改变时，根据运动改变时的位置，方向，以及当前时间戳与运动改变时的时间戳的差值，计算出当前应该所在的位置 p0
• 玩家节点当前实际所在位置 p1，p0 - p1（向量减法），即为校正后的运动路径
• 对路径进行模拟，直至下次运动状态改变

球控制器，当前客户端需要添加组件，由用户输入直接移动，并触发移动同步

const Ball = require("Ball");
const Constants = require("../Constants");
const LeanCloud = require("../LeanCloud");

const { getClient } = LeanCloud;

/**
 * 球控制器，当前客户端需要添加组件，由用户输入直接移动，并触发移动同步
 */
cc.Class({
  extends: cc.Component,

  properties: {},

  // LIFE-CYCLE CALLBACKS:

  onLoad() {
    cc.systemEvent.on(cc.SystemEvent.EventType.KEY_DOWN, this._onKeyDown, this);
    cc.systemEvent.on(cc.SystemEvent.EventType.KEY_UP, this._onKeyUp, this);
    this._ball = this.node.getComponent(Ball);
    this._direction = cc.Vec2.ZERO;
  },

  onDestroy() {
    cc.systemEvent.off(
      cc.SystemEvent.EventType.KEY_DOWN,
      this._onKeyDown,
      this
    );
    cc.systemEvent.off(cc.SystemEvent.EventType.KEY_UP, this._onKeyUp, this);
  },

  start() {
    this._cameraNode = cc.find("Canvas/Main Camera");
  },

  update(dt) {
    const speed = this._ball.getSpeed();
    const delta = this._direction.normalize().mul(speed * dt);
    const position = this.node.position.add(delta);
    const { x, y } = position;
    const { LEFT, RIGHT, TOP, BOTTOM } = Constants;
    const newPosition = cc.v2(
      Math.min(Math.max(x, LEFT), RIGHT),
      Math.min(Math.max(y, BOTTOM), TOP)
    );
    this.node.position = newPosition;
    // 设置摄像机跟随
    this._cameraNode.position = this.node.position;
  },

  _onKeyDown(event) {
    this.running = true;
    let dir = this._direction.clone();
    switch (event.keyCode) {
      case cc.macro.KEY.a:
      case cc.macro.KEY.left:
        dir.x = -1;
        break;
      case cc.macro.KEY.d:
      case cc.macro.KEY.right:
        dir.x = 1;
        break;
      case cc.macro.KEY.w:
      case cc.macro.KEY.up:
        dir.y = 1;
        break;
      case cc.macro.KEY.s:
      case cc.macro.KEY.down:
        dir.y = -1;
        break;
      default:
        break;
    }
    this._synchMove(dir.normalize());
  },

  _onKeyUp(event) {
    let dir = this._direction.clone();
    switch (event.keyCode) {
      case cc.macro.KEY.a:
      case cc.macro.KEY.left:
      case cc.macro.KEY.d:
      case cc.macro.KEY.right:
        dir.x = 0;
        break;
      case cc.macro.KEY.w:
      case cc.macro.KEY.up:
      case cc.macro.KEY.s:
      case cc.macro.KEY.down:
        dir.y = 0;
        break;
      default:
        break;
    }
    this._synchMove(dir.normalize());
  },

  _synchMove(dir) {
    if (dir.fuzzyEquals(this._direction, 0.01)) {
      return;
    }
    this._direction = dir;
    const { x, y } = this.node.position;
    const { x: dx, y: dy } = this._direction;
    const client = getClient();
    client.player.setCustomProperties({
      move: { p: { x, y }, d: { x: dx, y: dy }, t: Date.now() }
    });
  }
});

项目结构

├── Animation 动画目录
├── Prefabs 预制目录，主要存放球，食物预制体
├── Scene 场景目录，主菜单场景，战斗场景
├── Script 脚本目录
│   ├── Battle 战斗相关脚本目录
│   │    ├── Ball.js 球节点控制脚本
│   │    ├── BallController.js 玩家控制球脚本，生成移动数据同步给其他客户端
│   │    ├── BallSimulator.js 玩家运动模拟脚本，根据玩家运动数据，模拟运动行为
│   │    ├── Battle.js 战场节点总控制器，用于接收并解析战斗中的自定义事件，驱动场景节点及 UI 节点变化
│   │    ├── BattleHelper.js 战场工具脚本
│   │    ├── Food.js 食物节点控制脚本
│   │    ├── Master.js 游戏逻辑脚本，用于区分 Master 客户端与普通客户端，Master 组件用于生成房间数据及逻辑判断，只有 Master 的客户端才拥有这个组件，包括最初的房间的创建者和切换后的新房主。
│   │    ├── PlayerInfoItem.js 玩家信息 UI 节点控制脚本
│   │    └── UI.js UI 控制脚本
│   ├── Menu主菜单相关脚本目录
│   │    └── Menu.js 主菜单脚本
│   ├── Constants.js 游戏中用到的常量
│   └── LeanCloud.js 全局存放 LeanCloud SDK 对象的脚本
├── Texture 素材资源目录
└── play.js LeanCloud 实时对战服务 SDK

添加wx/微信公众回复球球大作战获取完整代码

在线体验链接

欢迎评论 💬点赞👍🏻 收藏 📂加关注+

欢迎添加微信，加入我的核心小队，请备注来意

👇👇👇👇👇👇👇👇👇👇👇👇👇👇👇