从零开始制作你的 MOD 项目

1. 下载必要的工具

首先,下载并安装一个代码编辑器。我们推荐使用Visual Studio Code,它功能强大且适合初学者。

2. 创建项目文件夹

通过创建一个专用项目文件夹来组织你的 MOD 文件:

  1. 在电脑上创建一个新文件夹,例如:MyFirstMod
  2. 在该文件夹内创建两个子文件夹:
    • script:用于存放 JavaScript 文件。
    • twee:用于存放 Twee 文件(适用于 SugarCube)。

3. 在 Visual Studio Code 中打开项目文件夹

打开 Visual Studio Code,使用文件 > 打开文件夹选项,选择你的项目文件夹。这样可以方便地管理文件夹中的所有文件。

4. 创建核心 MOD 文件

script 文件夹内,新建一个名为 modscript.js 的文件。该文件将包含你的 MOD 的 JavaScript 代码。

twee 文件夹内,新建一个名为 modcontent.twee 的文件。该文件将包含你的 MOD 的 SugarCube 内容和结构。

在根目录中创建一个名为 boot.json 的文件,用于配置 MOD 的基本信息。

5. 学习基础 JavaScript 语法

以下是一些你将会用到的基础 JavaScript 语法示例:


    // 这是一个注释
    // 声明一个变量
    let playerName = "Hero";

    // 定义一个函数
    function greetPlayer(name) {
        console.log("欢迎, " + name + "!");
    }

    // 调用该函数
    greetPlayer(playerName);


    // 进行简单的逻辑判断 == 用于比较是否相等, != 用于比较是否不相等, === 用于比较是否严格相等
    if (playerName == "Hero") {
        console.log("你是英雄!");
    } else {
        console.log("你是谁?");
    }

    // 进行简单的数学运算
    let num1 = 10;
    let num2 = 5;
    let sum = num1 + num2;
    console.log("和是:" + sum);
        

更多的 JavaScript 语法和功能可以在 菜鸟编程 以及 MDN Web 文档 中找到。

6. 了解 SugarCube Twee 语法

SugarCube Twee 语法用于创建交互式故事的段落和结构。以下是一些基本语法示例:


        :: ModId_YourTitle
        欢迎来到我的 MOD!
        <<link "前往下一段落" "ModId_NextPassage">><</link>>

        :: ModId_NextPassage
        这是下一段落。你可以返回到
        <<link "上一个段落" "ModId_YourTitle">><</link>>
        

保存更改后,可以使用 Twee 编译器或类似 Twine 的工具运行故事。

7. 下一步

- 探索更多高级 JavaScript 功能。
- 学习更多 SugarCube 宏以增强交互性。
- 参考 Simple Framework 文档,添加事件和自定义 UI 元素。 - 使用MOD工具 ModPacker,自动打包与构建boot.json