meta data for this page
📚 新手上路
欢迎来到开发人员手册！看来你即将成为一名准模组开发者！
在正式进入模组开发之前，非常建议至少阅读一次前置《基础手册》，这对线性学习的理解很有帮助。
通过基础手册已经得知，沙盘引擎的衍生作品统称为“模组”，实际上等同于开发者拥有独立版权的游戏。
📒 入门介绍
沙盘引擎 作为一款通用且开放的创意引擎，所有的核心玩法、机制全部基于游戏模组来具体实现。
引擎本身不提供原生玩法，一切玩法都来自模组开发者的创意。
熟悉的例子：沙盘引擎是游戏机，模组是机器内的游戏。
沙盘引擎 内置了大多数游戏世界常用的机制和功能，并且将复杂的代码进行友好的封装，让其变为更容易理解和使用的API（公开代码接口）。
模组开发者即可运用此机制，根据文档使用各类API组合成最终的脚本，让模组世界根据想象赋予生命力。
简单来说，无论是沙盘引擎还是专业游戏开发，最终几乎都是用N个代码（或可视化代码）组成最终的游戏。
这个过程说不上难，但也并非易如反掌，游戏开发就是一个考验逻辑和坚持的过程。
当虚拟世界有了地图场景的作为直观的感受，再加上一些脚本代码赋予世界玩法和逻辑，这最终就组成了我们所说的“游戏”！
需要注意，沙盘引擎 的世界框架设计相对自由，但也并非完全适合所有类型游戏开发。
通常情况下，更适用于自由探索、RPG及衍生扩展玩法等类型。
📒 前置准备
在对模组开发有了基础的了解后，我们可以开始进一步探索。
想要进行 沙盘引擎 的模组创作，至少需要拥有一份沙盘引擎本体，还有一些其他选项：
| 前置 | 内容 | 说明 |
|---|---|---|
| 游戏及开发工具（必要） | 沙盘引擎本体 | 游玩及开发通用 |
| 脚本语言知识（必要） | JavaScript | 赋予世界生命力的关键 |
| 代码编写工具（推荐） | VSCode | 更方便的编写代码，结合API提示功能 |
简单来说，模组开发必须要有 沙盘引擎 本体程序，以及需要掌握基础的JavaScript脚本语言知识（或其他编程语言知识）。
如果您是编程初学者，倒也无须谈之色变，沙盘引擎 封装了相对友好的API代码，在常规功能层面上，并不需要特别复杂的编程知识。
编程开发学习是线性递增的过程，沙盘引擎 本身的框架可以较好的补充这一点。
假如：同样面对枯燥的程序教程，在游戏过程中所见即所得的学习或能更有乐趣。
至此，当我们理解并准备完毕后，即可尝试进入下一步探索。
📒 基础知识
沙盘引擎 的默认编程语言是JavaScript，这是一个有着丰富历史且容易上手的语言，搭配引擎封装的友好API，有时仅需简单几行代码即可实现许多功能。
JavaScript菜鸟入门：JavaScript 教程 | 菜鸟教程
除此之外，您也可以尝试其他JavaScript入门教程。通常只需掌握此语言的基础逻辑和语法，即可开始搭配 沙盘引擎 进行同步学习和创作。
与此同时，您还可以先继续阅读本文，尝试下文所介绍的以通俗的角度来理解模组的创作逻辑，这也许并没有想象中的难。
📒 创建模组
沙盘引擎 的模组（工程）实际是一个独立文件夹，其按照要求放置在游戏目录下的Mods文件夹中。
模组根目录（Mods）中通常放置着xxx.xxxx.xxxxxx命名格式的子文件夹，有时也可能有其他名称的样式，这并没有特殊的含义，主要用于模组包名的命名，也可以简单理解为模组的身份证，以区分不同的模组。
创建模组的方式有许多种，可以按需选择：
| 创建方式 | 说明 |
|---|---|
| 模组创建向导 | 引擎程序内的模组菜单，模组创建按钮 |
| 拷贝本地模组 | 打开引擎模组根目录，拷贝某个模组文件夹并重命名，在其基础上进行修改或创作 |
| 下载模组 | 下载外部模组或示例模组（或模组模板），在其基础上进行修改或创作 |
当通过任何方式创建新模组后，新模组的文件夹内就是全新的独立世界，您可以尽情的尝试研究和修改文件夹的内容。
每个模组文件夹都是完全独立的，修改模组自身文件夹的内容不会影响到其他模组。
当模组建立并正确放置到模组根目录（Mods）之后，沙盘引擎将允许载入新的模组。
📒 模组构成
当我们尝试打开某个模组文件夹，通常由以下主要文件构成：
| 文件夹 | 说明 |
|---|---|
Host | 存放主机本地（存档）相关文件，不会同步给其他玩家 |
Language | 模组语言翻译相关 |
Map | 存放模组专用的地图文件 |
Plugin | 存放模组专用的插件脚本 |
Script | 存放模组主要脚本 |
Store | 存放模组扩展资源 |
| 文件 | 说明 |
|---|---|
Cover.jpg | Cover.png | 模组封面图（可选） |
Developer.txt | 模组开发人员名单（可选） |
Icon.ico | 模组图标（显示在Windows窗口）（可选） |
Icon.png | 模组形象图标（显示在主菜单、封面等）（可选） |
Local.json | 存放模组本地记录数据（非重要） |
Mod.json | 存放模组主要配置数据 |
Startup.json | 存放模组启动参数等数据（可空） |
License.txt | 模组自述&版权信息 |
尽管以上列出的主要文件看起来很多，但也并非每项都需要完全理解和用到，可以先保留基础的概念，后续逐渐理解和深入。
📒 结语
开发人员手册 是一个线性学习、由浅入深的教程系列。
每篇文章阅读完毕后，您可以点击左侧菜单继续浏览，或者查看下一章。
黑公网安备 23060402000230号