【原创】NES第二波:如何用VS Code,编写NES/FC游戏程序。
【原创】NES第二波:如何用VS Code,编写NES/FC游戏程序。
VS Code就是
你没有眼花没有看错。你会问30年前的NES怎么能用现在的工具制作呢?微软怎么想起NES了。
这事跟微软没什么关系。这要感谢曾哥(ZENG GE)。VS Code是一个通用编辑器,通过不同的插件,可以编辑不同的源代码。曾哥编写了一个6502插件,这很适合我们使用。
VS Code只是编辑器的作用,这个插件也能编译,但不能直接编译成NES。看上去用处不大。我们可以用别的编辑器,也有现成的编译器,为什么推荐VS Code?
这是因为这个编辑器是有着现代码编辑功能的,例如:高亮、输入提醒、自动完成,自动调整大小写,实时纠错。对重点是实时纠错。我们有C语言的编辑器,以上功能都有。也有Java的编辑器,以上功能都有。但是6502汇编的编辑器呢?大家回看一下6502 Macroassembler & Simulator。这货很令人失望。别的现代编辑器,例如NPP,VIM,SUBLINE TEXT没有一个想起6502来。只能自己定义高亮。我们最需要的是“实时纠错”。所以目前只有我推荐的这个合用。
一、怎么实现让VS Code编辑NES/FC游戏源代码(即6502汇编代码)。
1 下载安装VS Code,
2 安装6502插件
3 汉化界面
4 将默认编码改成 GB2312 (这是为了写注释。)
具体:
1.1下载:https://code.visualstudio.com/
1.2 安装:。。。略(谁都会的。)
2. 安装插件:
点这里,
你可能还是英文界面,不过没有关系。
在这儿输入“6502”,(我在想要不要回车)
等一会,会搜索出一堆插件。
我们要第一个,看这名字。
这儿(红框) 你会看见绿色 Install, 按它安装插件。 这就行。
3. 汉化界面
这比较简单,而且不是重点。看网上一大堆教程,我也是从网上学的。我随意贴几个,不行你可以再搜:“VS Code 汉化界面”
https://jingyan.baidu.com/article/a681b0de7654283b184346ea.html
https://blog.csdn.net/testcs_dn/article/details/75070415
https://blog.csdn.net/u012308586/article/details/89353861
4. 设置默认编码
这同样超简单,看网上的教程就好。不行你可以再搜:“VS Code 设置默认编码 GB2312”,用这个编码是为了跟6502Sim可以互通。用后者调试小段代码是很有必要的。VS Code是没有调试功能的,那么互补是很重要的。
我们认准 GB2312
https://jingyan.baidu.com/article/5552ef4792ac5a518ffbc996.html
https://blog.csdn.net/u012308586/article/details/98201989
到这儿,我们就可以正常使用VS Code了。假设你还想用VS Code来编别的东东,那么你就自己想办法协调了。
二、VS Code使用细节
1 我们6502汇编的源代码的扩展名统一用”65s“。
2 我们将所有源代码放在同一个文件夹中,要放同一个项目的,不能放第二个项目的源代码(包括子文件夹)。这里只限65s文件,其他文件不限制。这是因为VS Code是以文件夹为单位识别一个项目的。它会认为整个文件夹包括子文件夹中的65s文件为一个整个项目。所以多余的源代码会混淆的。
3 以打开文件夹方式,打开源代码。
4 初次打开一个文件夹,本插件会建立一个子文件夹.vscode。并在里面初始产生一个名为“6502project.json”的文件。这个就是项目配置文件了。
我们用VS Code打开它。我们加一些回车和缩进,显示如下:
{ "compileTimes": 2, "suggestion": true, "singleFile": { "outFile": "", "copyCodeToClipboard": true }, "projects": [ { "name": "project1", "entry": "main.65s", "includes": [ "**/*.65s" ], "excludes": [], "outFile": "", "patchFile": "", "copyCodeToClipboard": false } ] }
要改两个地方。
范例:本例我写了一个精灵程序,就只有这一个代码文件(Spirit01.65s)了,那就写成这样:
{ "compileTimes": 2, "suggestion": true, "singleFile": { "outFile": "prom.bin", "copyCodeToClipboard": true }, "projects": [ { "name": "project1", "entry": "Spirit01.65s", "includes": [ "**/*.65s" ], "excludes": [], "outFile": "prom.bin", "patchFile": "", "copyCodeToClipboard": false } ] }
按Ctrl+F6 编译。
点击这个”6502 Assembler for VSCode“,
你可以查看”细节“,就是语法了。
6502的语法大体是一样,不同的汇编器有一点小区别,更多的区别在于宏的部分,还有局部标签的部分。
当时我要找一个兼容这个语法的汇编器,还真难。比较了好几个才找到的。虽然这个插件也有编译功能,但不能一键生成NES,所以我用了另外的办法。这是后话。
你现在只需要明白,用这个插件就得符合它的语法。
三、注意点与不足
1 我用自己开发的软件,分配变量地址。实时生成65s文件。这在VSCode里面也是实时更新的。但是其中变量标签名称的更改、增删的”识别“就不能同步。会用红色波纹线显示出错。可以不去管它。下次重开VSCode,或重开文件夹的时候就会更新了。
2 不能一键生成NES,说不得要下插件的源码来修改。我暂时还不懂。插件作者(曾哥)也没空。我用另一个兼容的行指令汇编器,配上批处理,完美解决了。
四、配合使用的软件
1 兼容的行指令汇编器”asm6f_64“。(为了一键生成,为了方便) 【旧32位(系统)电脑换成asm6f_32,在工具/压缩包中】
2 我自己开发的”NES文件头编辑器“。(必需的)
3 我自己开发的”NES内存变量分配器“。(为了省脑力)【需要 .NET Framework 4.0,WIN10可无视】
4 图形工具”YYCHR”。(或别的你喜欢的。)
这些工具,我都放到范例包里面,下载:http://fogota.ys168.com/ 找到文件夹 NES Tool Kit就在里面。
五、如何制作NES/FC游戏程序
1 制作NES文件头。用我的”NES文件头编辑器“,输入相应参数,保存成bin文件(当然也能反复修改),建议定名为NesHeader.bin。具体用法见软件的用户手册,在压缩包中。
作为初学者,我们只写mapper0的游戏程序,NesHeader.bin中的mapper一项写0就好。
程序从$8000开始的话,PRG ROM一项写2就好;程序从$C000开始的话,PRG ROM一项写1就好。切页的不同了。我们mapper0的游戏程序没有切页,暂不提这个。
我们mapper0的游戏程序,CHR ROM一项写1就好。
其它不懂,暂时默认,以后有需要再改。
2 制作图形文件CHR。用YYCHR从别的游戏ROM里面copy过来,也能自己DIY。保存成chr文件。一般需要8K的。详细怎么做到,在我后面的教程中细说。当下可以先用我的教程包中的图形。
3 制作批处理文件Build.cmd
我们要先新建一个文件夹。将文件头NesHeader.bin,和图形文件xxx.chr放进去。还有,将asm6f_64.exe放进去(这是64位的)。
那么,我们的主文件现在还没写,我们先定个名字叫main.65s,相应的编译后生成的名字就是prom.bin。最终生成的nes名字叫XXX.nes。
我们在该文件夹中空白处,右击新建一个记事本文件。将文件名改为Build.cmd。扩展名也是要改的,不能是txt。(WIN10的你要在文件浏览器上方,点查看,在“文件扩展名”处打外勾。就能显示并更改扩展名了。其他系统到文件夹选项去解决。【另一个方法是在记事本保存时选类型*.*,在名称处写上全名,包括扩展名,编码默认。】)
改好名后,右键Build.cmd,点编译就会用记事本打开。输入下面的内容:
asm6f_64 main.65s prom.bin
copy /b NesHeader.bin+prom.bin+xxx.chr XXX.nes
pause
好了,就是这样。保存,编码默认。
除了mapper0以外都会切页,那么prom就不止一个文件了,chr也不止一个。所以这里与文件头设定有关的。
具体指令的作用,以后慢慢说,现在只要会换名字就好。如果不太清楚,可以打开我的范件看看。记得右键-编辑。双击是运行这个批处理。
4 用VSCode编写代码,编码选用GB2312。
这里不多说怎么编了,下一篇再聊。
5 编译和合成NES
双击“Build.cmd”。报错,你会在cmd窗口中看到。不报错自然就是pass。你会在该文件夹中找到生成的nes文件。
可以试下载我的范例,解压。删掉里面的nes文件,试试双击“Nes一键编译.cmd”。用模拟器看看nes文件的效果。(名字不重要。。。)