meta data for this page
  •  

📚 差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

两侧同时换到之前的修订记录前一修订版
后一修订版		前一修订版
developer:getting-started [2025/07/24 10:21] – bibiboxsdeveloper:getting-started [2025/07/25 20:12] (当前版本) – bibiboxs
行 2: 行 2:
 # 新手上路 # 新手上路
  
-[note2] +欢迎来到**开发人员手册**！看来你即将成为一名**准模组开发者**！ 
-此页面正在计划编辑中，敬请期待！ + 
-[/note]+在正式进入**模组开发**之前，非常建议至少阅读一次前置[《基础手册》](manual/getting-started)，这对**线性学习**的理解很有帮助。 
 + 
 +> 通过**基础手册**已经得知，沙盘引擎的**衍生作品**统称为**“模组”**，实际上等同于开发者拥有**独立版权**的游戏。 
 + 
 + 
 + 
 +## 入门介绍 
 + 
 +沙盘引擎 作为一款通用且开放的**创意引擎**，所有的核心玩法、机制全部基于**游戏模组**来具体实现。 
 + 
 +引擎本身不提供原生玩法，一切玩法都来自模组开发者的创意。 
 + 
 +> 熟悉的例子：**沙盘引擎**是游戏机，**模组**是机器内的游戏。 
 + 
 +沙盘引擎 内置了大多数**游戏世界**常用的机制和功能，并且将复杂的代码进行**友好的封装**，让其变为更容易理解和使用的**API（公开代码接口）**。 
 + 
 +模组开发者即可运用此机制，根据文档使用**各类API**组合成**最终的脚本**，让模组世界根据想象**赋予生命力**。 
 + 
 +> 简单来说，无论是**沙盘引擎**还是**专业游戏开发**，最终几乎都是用N个代码（或可视化代码）组成最终的游戏。 
 +> 
 +> 这个过程说不上难，但也并非易如反掌，**游戏开发就是一个考验逻辑和坚持的过程**。 
 + 
 +除此之外，沙盘引擎 额外准备了[地图编辑器](manual/map)和[实验工坊编辑器](manual/workshop)。 
 + 
 +当虚拟世界有了**地图场景**的作为直观的感受，再加上一些**脚本代码**赋予世界**玩法和逻辑**，这最终就组成了我们所说的**“游戏”**！ 
 + 
 +> 需要注意，沙盘引擎 的世界框架设计**相对自由**，但也**并非**完全适合**所有类型**游戏开发。 
 +> 
 +> 通常情况下，更适用于**自由探索、RPG及衍生扩展玩法**等类型。 
 + 
 + 
 + 
 +## 前置准备 
 + 
 +在对**模组开发**有了基础的了解后，我们可以开始进一步探索。 
 + 
 +想要进行 沙盘引擎 的模组创作，至少需要拥有一份[沙盘引擎本体](:releases)，还有一些其他选项： 
 + 
 +| 前置                   | 内容                                                     | 说明                              | 
 +| ---------------------- | -------------------------------------------------------- | --------------------------------- | 
 +| 游戏及开发工具（必要） | [沙盘引擎本体](:releases)                                             | 游玩及开发通用                    | 
 +| 脚本语言知识（必要）   | [JavaScript](https://www.runoob.com/js/js-tutorial.html) | 赋予世界生命力的关键              | 
 +| 代码编写工具（推荐）   | [VSCode](https://code.visualstudio.com/)                 | 更方便的编写代码，结合API提示功能 | 
 + 
 +简单来说，模组开发必须要有 沙盘引擎 本体程序，以及需要掌握基础的`JavaScript`脚本语言知识（或其他编程语言知识）。 
 + 
 +> 如果您是**编程初学者**，倒也无须谈之色变，沙盘引擎 封装了**相对友好**的API代码，在常规功能层面上，并不需要特别复杂的编程知识。 
 +> 
 +> 编程开发学习是**线性递增**的过程，沙盘引擎 本身的框架可以较好的补充这一点。 
 +> 
 +> 假如：同样面对枯燥的程序教程，在游戏过程中**所见即所得**的学习或能更有乐趣。 
 + 
 +至此，当我们理解并准备完毕后，即可尝试进入下一步探索。 
 + 
 + 
 + 
 +## 基础知识 
 + 
 +沙盘引擎 的默认编程语言是`JavaScript`，这是一个有着丰富历史且**容易上手**的语言，搭配引擎封装的友好API，有时仅需**简单几行代码**即可实现许多功能。 
 + 
 +> `JavaScript`菜鸟入门：[JavaScript 教程 | 菜鸟教程](https://www.runoob.com/js/js-tutorial.html) 
 +> 
 +> 除此之外，您也可以尝试其他`JavaScript`入门教程。通常只需掌握此语言的**基础逻辑和语法**，即可开始搭配 沙盘引擎 进行**同步学习和创作**。 
 +> 
 +> 与此同时，您还可以先**继续阅读本文**，尝试下文所介绍的以==**通俗的角度**==来理解模组的创作逻辑，这也许并没有想象中的难。 
 + 
 + 
 + 
 +## 创建模组 
 + 
 +沙盘引擎 的模组（工程）实际是一个**独立文件夹**，其按照要求放置在**游戏目录**下的`Mods`文件夹中。 
 + 
 +模组根目录（`Mods`）中通常放置着`xxx.xxxx.xxxxxx`命名格式的**子文件夹**，有时也可能有其他名称的样式，这并没有特殊的含义，主要用于**模组包名**的命名，也可以简单理解为**模组的身份证**，以区分不同的模组。 
 + 
 +创建模组的方式有许多种，可以按需选择： 
 + 
 +| 创建方式         | 说明                                                         | 
 +| ---------------- | ------------------------------------------------------------ | 
 +| 模组创建向导     | 引擎程序内的**模组菜单**，模组创建按钮                       | 
 +| 拷贝本地模组     | 打开引擎模组根目录，拷贝某个模组文件夹并重命名，在其基础上进行修改或创作 | 
 +| [下载模组](:mods) | 下载外部模组或示例模组（或模组模板），在其基础上进行修改或创作 | 
 + 
 +当通过任何方式创建新模组后，新模组的文件夹内就是全新的**独立世界**，您可以尽情的尝试研究和修改文件夹的内容。 
 + 
 +每个**模组文件夹**都是完全独立的，修改模组**自身文件夹**的内容不会影响到其他模组。 
 + 
 +> 当模组建立并正确放置到**模组根目录**（`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 `         | 模组自述&版权信息                            | 
 + 
 +尽管以上列出的**主要文件**看起来很多，但也并非每项都需要完全理解和用到，可以先保留基础的概念，后续逐渐理解和深入。 
 + 
 + 
 + 
 +## 结语 
 + 
 +开发人员手册 是一个**线性学习、由浅入深**的教程系列。 
 + 
 +每篇文章**阅读完毕**后，您可以点击**左侧菜单**继续浏览，或者[查看下一章](developer/framework)。 
 + 
 + 
 + 
 + 
 + 
  
-《沙盘引擎》空白模组（`com.sengine.blank`）：https://gitee.com/zainus-harvey-yip/com.sengine.blank