Skip to content

Files

Latest commit

b251ca0 · Jan 8, 2025

History

History
This branch is 3 commits ahead of Yao-class-cpp-studio/battle_game_2024:main.

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
Jan 8, 2025
Dec 23, 2024
Dec 23, 2024
Jan 8, 2025
Dec 23, 2024
Dec 23, 2024
Dec 23, 2024
Dec 23, 2024
Jan 8, 2025
Jan 8, 2025
Dec 23, 2024
Dec 23, 2024
Dec 23, 2024
Dec 23, 2024
Dec 23, 2024
Dec 23, 2024
Dec 23, 2024
Dec 23, 2024
Jan 8, 2025
Dec 23, 2024
Jan 8, 2025
Dec 23, 2024
Dec 23, 2024

Core

这个文件夹下的内容是整个项目的核心框架。 GameCore 类是所有游戏逻辑集中协调的地方。

在这个框架中,游戏内容主要分为四类元素:单位(Units)、障碍物(Obstacles)、子弹(Bullets)和粒子(Particles)。 这四类元素的基类统一继承自对象类型(Object),他们都有一定特定的预设功能,用于方便你实现自己的想法。

Object

对象类的声明位于 object.h 文件中, 你可以看到其包含了以下成员变量:

class Object {
    ...
protected:
    GameCore *game_core_{nullptr};
    glm::vec2 position_{0.0f};  // offset from the origin (0, 0)
    float rotation_{0.0f};      // angle in radians
    uint32_t id_{0};
};
  • game_core_
    • 这是一个指向游戏核心类的指针,会在对象被创建时赋值。当对象在运行过程中需要与游戏内其他元素交互时, 你可以通过这个指针调用游戏核心的相应功能函数。
    • 约定:被用于游戏中的对象,game_core_ 一定指向合法的对象,且在过程中不更改其值。
    • 约定:game_core_ 为 nullptr 时,则当前对象是在进行一些游戏内容外的测试,此时该对象游戏逻辑部分代码不会也不应该被调用。
  • id_
    • 表示对象的编号,同类元素的不同实体拥有不同的编号,不同类型元素的实体可能拥有相同编号。 例如,属于单位 Unit 子类的实体,本变量表示的值为单位编号(Unit ID),以此为类比,适用于其他三类元素。
    • 约定:任何类型元素的编号 0 为保留编号,用于一些特殊判断的处理。
  • position_, rotation_
    • 游戏中每一个对象都拥有其位置信息
    • position_ 表示对象相对于游戏内坐标原点的偏移量
    • glm::vec2 是 glm 数学运算库中表示单精度浮点二维向量的类型,这个数学库内包含了四维及以下向量、矩阵的类型定义和常用功能函数。
    • rotation_ 表示对象在场景内相比于默认朝向,逆时针旋转的角度

除成员变量外,所有对象都应包含两部分功能:

class Object {
public:
    ...
    virtual void Update() = 0;
    virtual void Render() = 0;
};
  • Update
    • 这个函数用于更新对象的状态
    • 对象的主要逻辑代码都应写在这里
    • 这个函数会在每一个游戏帧(Tick)更新时被调用
  • Render
    • 这个函数用于绘制对象的视觉效果
    • 你可以调用 src/battle_game/graphics/grahics.h 中的函数进行画面的绘制, 前往 src/battle_game/graphics/README.md 查看相关绘图函数的使用方法。

为了方便构思,我们可以想象所有对象都根据其位置信息拥有一个自己的本地空间坐标系, 相对于世界空间坐标系,在本地空间坐标系上进行计算会带来许多便利。 因此 Object 类还提供了如下两个函数用于辅助计算

  • LocalToWorld
    • 传入参数为本地空间坐标
    • 返回对应的世界空间坐标
  • WorldToLocal
    • 传入参数为世界空间坐标
    • 返回对应的本地空间坐标

Unit

单位类声明在 unit.h 中,单位表示游戏中进行主动动作的对象,所有具体单位的实现都应继承自此基类。

成员变量

  • player_id_
    • 这个变量表示单位所有者的玩家编号(Player ID),用于区分敌我
  • health_
    • 这个变量表示单位的生命值
    • 取值范围为 [0, 1],即剩余生命相对于最大生命值生命值的比例。
    • 单位实际生命值为 GetMaxHealth() * health_
    • 这样定义是为了方便动态地对最大声明值进行调整,以实现一些复杂机制。
    • 该值归 0 时单位死亡。
  • lifebar_*
    • 这些变量保存了生命条的设置,请通过set来修改
  • fadeout_health_
    • 保存生命条渐变的起始位置。(一般不需要修改)

成员函数

  • SetPosition
    • 设置单位位置的函数
    • 为了游戏帧更新时的数据一致性,一般不直接调用,而是用 GameCore 中的 PushEventMoveUnit 函数添加单位移动事件
  • SetRotation
    • 设置单位朝向的函数
    • 为了游戏帧更新时的数据一致性,一般不直接调用,而是用 GameCore 中的 PushEventRotateUnit 函数添加单位旋转事件
  • GetDamageScale
    • 获取单位的伤害倍率,默认为 1.0
    • 你可以编写这部分的计算逻辑以实现高倍率攻击力属性、光环等效果
    • 单位造成伤害的功能都应考虑此函数的影响
  • GetSpeedScale
    • 获取单位的移动速度倍率,默认为 1.0
    • 你可以编写这部分的计算逻辑以实现加速、减速相关的属性、光环功能
  • BasicMaxHealth
    • 这是一个虚函数
    • 最大生命值基准,默认为 100.0
    • 表示生命值基础数值
    • 你可以在不同单位的实现中通过 override 修改单位的基础生命值
  • GetHealthScale
    • 生命值倍率,默认为 1.0
    • 你可以编写这部分的计算逻辑以实现增强或衰弱生命值的功能
  • GetMaxHealth
    • 最大生命值
    • 定义为基础生命值乘以生命值倍率
  • Set/GetLifeBar*
    • 修改/获取各种生命条设置
  • RenderLifeBar
    • 这是一个虚函数
    • 渲染该对象对应的生命条
  • Hide/ShowLifeBar
    • 隐藏/显示生命条
  • RenderHelper
    • 这是一个虚函数
    • 仅在该单位所有者玩家的视角中,渲染该对象用于辅助的一些视觉效果(例如子弹射出的预计轨迹)
  • IsHit
    • 这是一个虚函数
    • 用于判断若一个事件发生于传入参数世界空间坐标 position,该事件是否会对当前单位产生影响
    • 可以理解为定义命中体积的函数
    • 通常用于判断子弹、飞射物是否命中了当前单位
    • 你可以在子类实现中通过 override 定义不同的命中判断逻辑
  • GenerateBullet
    • 这是一个模板函数
    • 由于子弹类的生成包含了许多类似于发出者单位编号、所属玩家编号相关的固定信息,我们希望把基本信息相关的内容省略,从而只通过传入关键信息即可生成一颗子弹, 该函数可以帮助你通过只填写新生成的子弹对象的位置、朝向、伤害倍率等关键参数,自动根据单位信息进行补全并添加一个子弹生成事件。
    • 实现类似于“开火”一类的技能可以使用该函数
    • 函数的实现位于 src/battle_game/core/game_core.h

Obstacle

障碍物类声明在 obstacle.h 中,该类对象主要用于组成游戏场景。

  • GetSurfaceNormal
    • 给定向量的始点与终点信息,返回向量与物体表面相交处对应的表面单位法向量信息。我们约定其返回值的第一项为给定线段与表面的交点,第二项为单位法向量的方向。
    • 主要用于实现子弹的反弹。对于障碍物(对于某些子弹)不应该返回对应表面单位法向量的情况,我们约定返回值中单位法向量的方向设为 (0,0)。

成员函数

  • IsBlocked
    • 这是一个虚函数
    • 该函数用于判断传入参数世界空间坐标 position 是否被该障碍物阻挡
    • 你可以在子类实现中通过 override 定义不同的障碍物作用模式

Bullet

子弹类声明在 bullet.h 文件中,该类对象主要用于表示会对游戏性产生影响的临时对象。如:子弹

相比于子弹这个名称,或许用“飞射物”一词更符合其广义的含义。

成员变量

  • unit_id_
    • 表示该飞射物的创建者的单位编号(Unit ID),用于可能实现的“经验值系统”或相关机制
  • player_id_
    • 表示该飞射物的所属玩家的玩家编号(Player ID),用于区分阵营
  • damage_scale_
    • 伤害倍率,用于存储该子弹被创建时被赋予的伤害倍率,以作用于命中时的实际伤害

Particle

粒子类声明在 particle.h 文件中,该类对象主要用于表示不会对游戏性产生影响的临时对象,用于提升视觉体验。

GameCore

游戏核心提供了许多用于方便游戏内元素进行交互的函数功能

对象访问

通过游戏核心对象你可以访问其他任意仍旧存在于游戏中的对象:

  • GetUnit
    • 根据输入的单位编号(Unit ID),返回对应单位对象的指针
    • 单位编号指向的单位已经被删除或编号不合法,则返回 nullptr
  • GetUnits
    • 获取所有现存的单位
  • GetObstacle
    • 根据输入的障碍物编号(Obstacle ID),返回对应障碍物对象的指针
    • 障碍物编号指向的障碍物已经被删除或编号不合法,则返回 nullptr
  • GetObstacles
    • 获取所有现存的障碍物
  • GetBlockedObstacle
    • 判断传入参数世界空间坐标 position 是否被某障碍物阻挡。如果是,返回对应障碍物对象的指针
  • GetBullet
    • 根据输入的子弹编号(Bullet ID),返回对应子弹对象的指针
    • 子弹编号指向的子弹已经被删除或编号不合法,则返回 nullptr
  • GetBullets
    • 获取所有现存的子弹
  • GetParticle
    • 根据输入的粒子编号(Particle ID),返回对应粒子对象的指针
    • 粒子编号指向的粒子已经被删除或编号不合法,则返回 nullptr
  • GetParticles
    • 获取所有现存的粒子

事件队列

由于一个游戏帧在更新的过程中,不同对象的更新函数存在被调用的先后顺序。 为了数据一致性,我们不希望先被调用的更新函数产生的影响立刻影响到后续被调用的更新函数, 例如:当两个单位可以同时击杀对方时,先被调用的对象如果立即对对方产生了伤害,那么后发单位直接死亡,会影响到游戏公平。 因此,我们希望游戏对象的更新逻辑部分将可能影响到其他对象的事件延后结算,因此我们引入了事件队列机制:

在所有游戏对象的更新函数调用完成后,事件队列会依次执行其中的内容。 我们希望保证:事件与事件之间的相对顺序对计算结果没有干扰。

总而言之,这是一个保证游戏逻辑一致性的机制,已经提供的事件函数如下:

void PushEventMoveUnit(uint32_t unit_id, glm::vec2 new_position);
void PushEventRotateUnit(uint32_t unit_id, float new_rotation);
void PushEventDealDamage(uint32_t dst_unit_id,
                           uint32_t src_unit_id,
                           float damage);
void PushEventKillUnit(uint32_t dst_unit_id, uint32_t src_unit_id);
void PushEventRemoveObstacle(uint32_t obstacle_id);
void PushEventRemoveBullet(uint32_t bullet_id);
void PushEventRemoveParticle(uint32_t particle_id);
void PushEventRemoveUnit(uint32_t unit_id);

template <class BulletType, class... Args>
void PushEventGenerateBullet(uint32_t unit_id,
                             uint32_t player_id,
                             glm::vec2 position,
                             float rotation = 0.0f,
                             float damage_scale = 1.0f,
                             Args... args);
  • PushEventMoveUnit
    • 压入一个单位移动事件
  • PushEventRotateUnit
    • 压入一个单位旋转事件
  • PushEventDealDamage
    • 压入一个伤害事件
  • PushEventKillUnit
    • 压入一个击杀事件
    • 这种事件通常通过伤害事件产生
  • PushEventRemoveObstacle
    • 压入一个障碍物移除事件
  • PushEventRemoveBullet
    • 压入一个子弹移除事件
  • PushEventRemoveParticle
    • 压入一个粒子移除事件
  • PushEventRemoveUnit
    • 压入一个单位移除事件
    • 这种事件通常通过击杀事件产生
  • PushEventGenerateBullet
    • 压入一个子弹生成事件
    • 和 Unit 类中的 GenerateBullet 函数相联系

随机变量

游戏中我们常常会见到随机机制,为了方便日后我们加入联机功能,我们需要使随机机制具有一致性。 因此我们希望你编写的代码中所有涉及到的随机变量都通过以下函数获得:

  • RandomFloat
    • 产生一个区间 [0, 1] 内均匀分布的随机浮点数
  • RandomInt
    • 产生一个区间 [low_bound, high_bound] 内均匀分布的随机整数
  • RandomOnCircle
    • 产生一个单位圆圆周上均匀分布的随机向量
  • RandomInCircle
    • 产生一个单位圆内部均匀分布的随机向量