快速上手

介绍

Dream Mod 3.0 是一个完整的即时战斗游戏框架，使用语言 Lua 5.4。目标是不写一行脚本，全AI自动化实现一个游戏。

安装

依赖环境

Windows 64位系统
无需安装，解压即用，推荐使用Visual Studio Code搭配使用。

目录结构

一个完整的引擎目录应该是这样的

├─ Dat
│  └─ Game.lib
└─ App.exe

创建项目

通过命令行创建，引擎会在当前目录下生成一个项目文件夹 game，其中包含引擎入口文件 App.lua。

./App.exe -n app1 game

提示

app1是一个在线工程模板标识,你可以在资源库中获取更多模板。

启动项目

通过命令行启动，默认会自动打开Windows控制台窗口。缺省情况下，双击启动App.exe，系统会启动当前目录下名称为game的项目。

./App.exe -g game

编译项目

通过命令行编译，系统在工程目录下生成Build文件夹，项目被编译打包为 game.dat 我的游戏.exe。

./App.exe -b game

命令行

命令	说明	例子
-n	从在线的模板仓库中创建一个新工程 `-n 模板标识项目名称`	./App.exe -n app1 game
-g	调试运行指定工程	./App.exe -g game
-b	编译打包指定工程	本地游戏：./App.exe -b game 发布盒子：./App.exe -b game appkey
-f	生成像素字体 -f 字体字号粗细 `400：正常` `700：粗体`	./App.exe -f 宋体 14 700

提示

如果你通过批处理运行命令，可能需要把文件编码改成 ANSI。

创建第一个项目

步骤

下载安装 Visual Studio Code
下载解压缩引擎，例如：E:\DM3，进入文件夹后，鼠标右键菜单选择 通过Code 打开
VSCode启动后,按下 Ctrl + Shift + P 选择 首选项:打开工作区设置
搜索 encoding 在下方 Files: Encoding 把UTF-8改为GBK
快捷键 Ctrl + ` 打开 终端 使用命令创建工程 ./App.exe -n app1 game
使用命令行启动工程 ./App.exe -g game

使用自定义素材

在入口文件App.lua中，在每个组件中都有一个叫 资源表 配置项，这是一个全局的配置项，配置一处所有地方可用。
本地资源统一放在DM3引擎同级Res目录下,注意不是工程目录。
dmstore_开头的表示这是个在线DM资源库的素材，游戏启动后会从网络下载回来统一存放到\Res\dmstore目录缓存。
引擎各个配置项中需要使用资源的地方，填写标识，而不是文件地址。

资源表 = {
    {标识="宋体12",文件="dmstore_FKY6DW8ChsKAMKB4KB4A"},
    {标识="宋体14粗",文件="dmstore_FCheCZQD36JlWKZCKKCA"},
    {标识="默认皮肤",文件="dmstore_JCjaDfOCjWDNADOuECMA"},
    {标识="格子动画包",文件="格子动画包/格子动画包.json"},
    {标识="极品背景1",文件="极品背景/极品背景1.png"},
    {标识="极品背景2",文件="极品背景/极品背景2.png"},
    {标识="极品背景3",文件="极品背景/极品背景3.png"},
    ...
    ...
}

调试

游戏中按下F12会显示内置的系统信息窗口，方便观察地图状态，鼠标坐标点等。
使用全局方法调试输出在控制台中打印调试信息。