meta data for this page
  •  

📚 差别

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

到此差别页面的链接

后一修订版		前一修订版
developer:framework [2025/07/24 15:13] – 创建 bibiboxsdeveloper:framework [2025/07/25 20:01] (当前版本) – bibiboxs
行 2: 行 2:
 # 脚本&框架 # 脚本&框架
  
-模组的各项文件实际上是不同的**配件**，而**脚本文件&引擎框架**作为模组逻辑的控制单元，**完全控制**着模组**何时、如何**执行某些行为。+**脚本文件&引擎框架**作为模组逻辑的控制单元，**完全控制**着模组**何时、如何**执行某些行为。
  
  
行 69: 行 69:
  
  
-### 事件 `Event`+### 事件 (Event)
  
 此类样式的代码，通常表示**监听事件**，也就是**当某情况发生时**代码应该做些什么。 此类样式的代码，通常表示**监听事件**，也就是**当某情况发生时**代码应该做些什么。
行 86: 行 86:
  
  
-### 方法 `[Function]`+### 方法 (Function)
  
 此类样式的代码，通常表示**执行方法**，也就是调用代码API做一些事情。 此类样式的代码，通常表示**执行方法**，也就是调用代码API做一些事情。
行 98: 行 98:
  
  
-### 属性 `[Property]`+### 属性 (Property)
  
 此类样式的代码，通常表示**获取或修改某属性**，也就是调用代码API修改一些内容。 此类样式的代码，通常表示**获取或修改某属性**，也就是调用代码API修改一些内容。
行 106: 行 106:
 ``` ```
  
-解释：`World.Core.Player.Find(0)`是 沙盘引擎 内置的方法API，此代码用于获取ID为`0`的玩家对象，关键在于后面的`.Name = "Hello";`，表示将其玩家昵称修改为`Hello`。+解释：`World.Core.Player.Find(0)`是 沙盘引擎 内置的方法API，此代码用于获取ID为`0`的玩家对象，关键在于后面的`.Name = "Hello";`，表示将其**玩家昵称**修改为`Hello`。 
 + 
 +`Name` 是玩家对象的一个属性，在玩家对象后`.Name`，即为访问此属性，需要注意的是，并非所有属性均可写，部分为**只读属性**，例如`Player.FPS`，显而易见的，玩家的帧数不可能被我们修改，这取决于玩家的帧数限制&设备配置。
  
  
行 151: 行 153:
 - 当世界脚本加载后执行 - 当世界脚本加载后执行
 - `World.Core.SetHostName()`设置服务器名称为`Test Server` - `World.Core.SetHostName()`设置服务器名称为`Test Server`
-- `World.Core.SetWorldWeather()`设置世界天气为`6`（雪天）+- `World.Core.SetWorldWeather()`设置[世界天气](reference/instances)为`6`（雪天）
 - `World.Core.SetWorldTime()`设置世界时间为`22, 00`（晚上十点） - `World.Core.SetWorldTime()`设置世界时间为`22, 00`（晚上十点）
  
行 220: 行 222:
  
 > 通常情况下，**0基础**学习至上述要求的**必要知识**进度，正常学习时间**1~2小时**即可掌握。 > 通常情况下，**0基础**学习至上述要求的**必要知识**进度，正常学习时间**1~2小时**即可掌握。
 +
 +
 +
 +## 重载和调试
 +
 +当模组内的脚本等文件**发生更改（保存）**后，引擎并不会直接更新最新的逻辑，而是会在下次**模组重载**时自动更新。
 +
 +此过程手动触发也非常简单，通常在**模组\脚本**修改完成后，可以点击或使用**重连按钮（F12）**快速重新建立连接，已达到更新模组的作用。
 +
 +每次重连（重载）后，模组即会使用最新的模组内配置及脚本。
 +
 +> 在少数情况下，如果系统文件更新有延迟，也可以使用`Shift+F12`强制完整更新并重连，但通常无需此操作。
  
  
行 225: 行 239:
 ## 参考API文档 ## 参考API文档
  
-在实际脚本开发的过程中，**代码API**几乎贯彻着开发全局，因此我们精心整理了[脚本开发及API](scripting)文档。+在实际脚本开发的过程中，**代码API**几乎贯彻着开发全局，因此我们精心整理了[脚本开发及API](:scripting)文档。
  
 对于游戏中可能遇到的各类功能、事件、属性，均在文档中有所说明。 对于游戏中可能遇到的各类功能、事件、属性，均在文档中有所说明。
行 254: 行 268:
 8. 享受**代码自动补全、内置事件补全**等功能 8. 享受**代码自动补全、内置事件补全**等功能
  
-![](脚本&框架.assets/1753340568139.png)+![](:developer:1753340568139.png) 
 + 
 + 
 + 
 + 
 + 
 + 
 + 
 + 
 + 
 + 
 + 
 + 
 + 
 + 
 </markdown> </markdown>