探索游戏编程的新领域：TEGA - 基于TypeScript的GameBoy宏汇编器

最新推荐文章于 2024-08-30 08:09:40 发布

滑辰煦Marc

最新推荐文章于 2024-08-30 08:09:40 发布

阅读量403

点赞数 3

本文链接：https://blog.csdn.net/gitblog_00097/article/details/139227761

版权

探索游戏编程的新领域：TEGA - 基于TypeScript的GameBoy宏汇编器

tega🕹 TypeScript Embedded GameBoy Macro Assembler项目地址:https://gitcode.com/gh_mirrors/te/tega

TEGA 是一款专为创建GameBoy ROM图像而设计的TypeScript库，同样适用于JavaScript环境。它提供了一个类型安全的API，用于处理SM83汇编指令，内联字节（以TypedArrays的形式），在ROM空间中移动，以及符号定义和内存映射布局，硬件寄存器及其重要位字段位置。更棒的是，它允许你利用TypeScript的所有常规语言特性来创建类型安全的抽象（如宏），这意味着你可以轻松地使用你喜欢的库，如lodash和ramda。

项目示例：砖块跳跃游戏

Block-Jump-Screenshot-1 Block-Jump-Screenshot-2

在./src/block-jump目录下，你可以找到一个完整的演示游戏——“砖块跳跃”。这款游戏基于谷歌浏览器的离线恐龙跳跃游戏，其中包含了：

多个模块
标准库的使用
随机数生成策略
图块地图压缩
物理与碰撞检测
虚拟地址偏移

有关TEGA和"砖块跳跃"的深入视频教程，你可以在Low Byte Productions的YouTube频道上查看。

技术细节

TEGA的所有操作函数定义都是自动生成的，基础是izik1的gbops仓库中的dmgops.json文件。这个文件也被用来创建了详尽的gbops网站，提供了GameBoy的详细操作码表和大量有用信息，例如每个操作所需的周期数，每周期的内存操作等。在TEGA中，仅需操作名称和操作码，就可以生成256种操作的256种重载、类型安全的函数定义。如果你对JSON到TypeScript的具体转换感兴趣，可以查看本项目的scripts/ops-generator.ts文件。

SM83 CPU（一种结合了z80和8080特性但又有自定义元素的CPU）有256个操作码，其中11个被认为是未定义的，会锁定CPU。操作码0xCB是一个前缀，扩展出另外256个操作码，主要用于8位寄存器的单比特操作，以及一些扩展的旋转、移位和交换操作。

每个操作返回该操作的描述以及动态（立即）参数。在汇编时，汇编器维护一个带有偏移量（从头区后的0x150开始）的缓冲区，并遍历这些操作，填充操作码和立即值。标签、引用和大小计算则采用符号值。使用label函数创建标签，当遇到标签定义时，如果尚未定义，则将其与当前偏移量关联。遇到包含符号引用的指令时，记录下来，并将偏移量向前移动以适应指令的大小。

moveTo 和 inlineBytes 分别用于改变内部偏移并直接插入字节到ROM中。

所有操作处理完毕后，汇编器会回溯并解决符号引用。如果无法解析，那么表示从未定义过，会抛出错误。否则，正确填充8或16位值到ROM缓冲区中。

最后插入头部数据并计算校验和。虽然可配置头部信息传递给TEGA，但大多数字段与制造商代码和卡带类型相关。目前只支持"32kb ROM Only"，但这是一个很容易去除的限制。头部包括两个独立的校验和计算：一个是头部校验和，如果不正确，硬件不会启动；另一个是全局校验和，但不进行检查。

有趣的一点是，任天堂早期通过在ROM头部包含其公司标识来限制未经授权的第三方开发者。如果标识匹配不正确，GameBoy将在启动时挂起，游戏无法运行。尽管GameBoy已有30多年历史，但在emuDev（模拟器开发）和homebrew（自制游戏）社区中，仍有一些开发者对包含这种法律模糊的字节序列持谨慎态度。在汇编器中，这是必要的要求，但我个人选择了一种折衷的方法，即使用另一已知值异或原始序列来生成这些字节，这多少有些迷信，但也颇具趣味性。