meta data for this page
  •  

📚 差别

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

到此差别页面的链接

两侧同时换到之前的修订记录前一修订版
后一修订版		前一修订版
manual:native [2025/07/17 15:40] – bibiboxsmanual:native [2025/08/28 06:20] (当前版本) – bibiboxs
行 31: 行 31:
 | `SandtableEngine_Data` | 沙盘引擎关键数据目录（Unity Build）<br />*不应该在此处放置任何其他文件* | | `SandtableEngine_Data` | 沙盘引擎关键数据目录（Unity Build）<br />*不应该在此处放置任何其他文件* |
  
-| 文件                      | 说明                                      | +| 文件                      | 说明                           | 
-| ------------------------- | ----------------------------------------- | +| ------------------------- | ------------------------------ | 
-| **`SandtableEngine.exe`** | 引擎主要程序（启动程序）                  | +| **`SandtableEngine.exe`** | 引擎主要程序（启动程序）       | 
-| `Engine.json`             | 引擎[本地用户配置](reference/engine_json) | +| `Engine.json`             | 引擎本地用户配置               | 
-| `MasterServer.cfg`        | 主服务器信息配置，通常无需改动            |+| `MasterServer.cfg`        | 主服务器信息配置，通常无需改动 |
  
  
行 85: 行 85:
 ## 游戏控制台 ## 游戏控制台
  
-沙盘引擎 内置了一个方便的调试工具，此功能可通过**设置菜单**进行开启或关闭。+沙盘引擎 内置了一个方便的**调试工具**，此功能可通过**设置菜单**进行开启或关闭。
  
 无论是开发者还是玩家，均可以在此功能**开启状态**下，使用按键`[~]`进行控制台激活。 无论是开发者还是玩家，均可以在此功能**开启状态**下，使用按键`[~]`进行控制台激活。
行 134: 行 134:
 | `mainscene`               |                                        | 立即跳转到【Main】主世界初始场景（不会保存当前数据）         | | `mainscene`               |                                        | 立即跳转到【Main】主世界初始场景（不会保存当前数据）         |
 | `updatesdk`               |                                        | **为当前模组更新`ModSDK`内容==（覆盖模组目录）==<br />（模组开发环境、VSCode最新声明文件等）** | | `updatesdk`               |                                        | **为当前模组更新`ModSDK`内容==（覆盖模组目录）==<br />（模组开发环境、VSCode最新声明文件等）** |
 +
 +
 +
 +## 快捷日志输出
 +
 +在任何情况下，**按下**默认`[F3]`按键开关**快捷日志输出**。
 +
 +这是一个**简单\快速**的日志查看方式，通常用于开发阶段调试使用，每次开关都会**清空**上次记录。
 +
 +
 +
 +## 硬件信息输出
 +
 +在任何情况下，**按住**默认`[F4]`按键开关**硬件信息输出**。
 +
 +此方法可以快速查看**硬件信息、游戏帧数、帧数抖动**等调试信息。
 +
 +
 +
 +## 启动参数&命令行
 +
 +> 《沙盘引擎》支持对`SandtableEngine.exe`编写启动参数&命令行，以达到高级自定义的启动及使用。
 +
 +
 +
 +### 参数列表
 +
 +| Command                                      | 说明                                                         | 示例                                                   |
 +| -------------------------------------------- | ------------------------------------------------------------ | ------------------------------------------------------ |
 +| `@Package`                                   | 加载指定包名的模组                                           | `@com.sengine.introduce`                               |
 +| `#Address`<br />`#Address|Password|UserData` | 直接尝试连接到指定IP\联机地址，**允许附加参数**<br />联机成功后通常会自动同步模组资源 | `#127.0.0.1:8192`<br />`#127.0.0.1:8192|password|test` |
 +| `-debugmode`                                 | 以临时**DOS附加窗口**的方式启动游戏，额外启动一个DOS输出调试窗口 | -                                                      |
 +| `-frame_XX`                                  | 设置最大游戏帧数（重定向）<br />**- 专用服务器：最大逻辑处理帧率（数值越大服务器越流畅，CPU占用越多）** | `-frame_60` //MAX 60 FPS                               |
 +| `-port_XX`                                   | 设置网络连接端口（重定向），此参数通常用于BAT模式            | `-port_8192`                                           |
 +| `-startup_XX`                                | 设置模组`Startup.json`配置文件（重定向），此参数通常用于BAT模式 | `-startup_test` //test.json                            |
 +| `-nographics -batchmode -serverbuild`        | 以无DX窗口方式启动[专用服务器](reference/dedicatedserver)，需要搭配`@`使用 | -                                                      |
 +| `-force-glcore`                              | 以`GLCore`渲染方式启动游戏，主要针对`DX11`模式不适用的情况<br />对于部分显卡，可能游戏性能稍有提升 | -                                                      |
 +| `-force-vulkan`（实验性）                    | 以`Vulkan`渲染方式启动游戏，主要针对`DX11`模式不适用的情况<br />对于部分显卡，可能游戏性能稍有提升 | -                                                      |
 +| `-force-d3d12`（实验性）                     | 以`DX12`渲染方式启动游戏，主要针对`DX11`模式不适用的情况<br />对于部分显卡，可能游戏性能稍有提升 | -                                                      |
 +| `-lowresolution`                             | 以较低分辨率启动游戏，主要用于默认分辨率异常的情况           | -                                                      |
 +| `-mapeditor`                                 | 直接启动[地图编辑器](reference/mapeditor)，通常更建议在模组加载后启动 | -                                                      |
 +| `-local`                                     | 强制以本地玩家方式（非Steam用户）启动，如果Steam已被启动，则不会启用Steam验证<br />==注意：有些服务器可能会阻止非Steam用户加入== | -                                                      |
 +
 +
 +
 +### 使用示例
 +
 +1. 复制`SandtableEngine.exe`，拷贝**快捷方式**至指定位置
 +2. 右键**快捷方式**点击属性，在**快捷方式**“目标”文本后插入命令行，通常以空格分割多个参数
 +3. 例如：`D:\SandtableEngine\SandtableEngine.exe -debugmode -local #127.0.0.1:8192`
 +4. 解释：启动沙盘引擎，并且开启DOS输出窗口，同时以非Steam方式启动，并且尝试连接到`127.0.0.1:8192`服务器
 +
 +
 +
 +## Startup.TXT
 +
 +在某些情况下，开发者可能希望**整合引擎+模组**，尤其是希望运行`SandtableEngine.exe`后自动加载某模组（或执行其他命令）。
 +
 +此情况可在**引擎目录**新建`Startup.txt`文件，在文件内正常填写命令行参数，启动引擎程序时将会**优先采用此命令行参数**。
 +
 +> 执行优先级：系统快捷方式 > `Startup.txt`
 +
 +
 +
 +## Engine.JSON 配置文件
 +
 +此文件记录**引擎全局通用配置项**（包括玩家配置选项），如文件不存在将会自动生成。
 +
 +> 通常情况下，在将游戏本体分享给其他人时，应该忽略此文件的打包，因为每个人的**玩家设定\配置**是不同的，不应该直接沿用。
 +
 +
 +
 +### 主要配置说明
 +> 此配置文件比较重要且相对庞大，下方仅展示**部分关键配置属性**，具体可参考引擎目录`Engine.json`文件。
 +
 +| 配置                       | 说明                                                         | 默认值               |
 +| -------------------------- | ------------------------------------------------------------ | -------------------- |
 +| `Language`                 | 引擎默认用户语言（优先）                                     | `English`            |
 +| `VerifyServerUniqueUser`   | 是否检查服务器内相同的连接用户<br />**如果开启，则会阻止相同IP\UUID的用户同时进入（`DuplicateNameOrUUID`）**<br />**==（开发者在测试联机阶段，应该关闭这个属性，否则将无法本地测试）==** | `true`               |
 +| `VerifyServerSteamEdition` | 是否检查服务器内Steam版连接用户<br />**如果开启，则会阻止非Steam用户进入服务器**<br />**==（如果服务器受到玩家欺骗和骚扰，可以开启此选项以仅限制Steam用户连接）==** | `false`              |
 +| `NetworkAddress`           | 作为主机\服务器时的**优先绑定IPV4地址**（Steam服务器模式无效） | `0.0.0.0`            |
 +| `NetworkProtocol`          | 作为主机\服务器时的**网络协议**（Steam服务器模式无效）       | 默认`udp`<br />`tcp` |
 +
 +
 +
 +## 文件注意事项
 +> 基于**Steam版本更新机制**，每当 沙盘引擎 提交新版更新时，可能会**自动替换\删除**游戏目录的许多文件，这其中可能包括**游戏语言、内置模组、内置地图**等文件及目录。
 +>
 +> ==如果玩家有**自定义修改**需求（例如二次创作**语言、地图、模组**等），务必**拷贝**相关文件，而不是直接修改**原始文件**。==
 +
 +- **示例#1：**希望增加新的自定义引擎翻译，应该拷贝相关语言文件并重命名，而不是直接修改目标语言文件
 +- **示例#2：**希望修改内置模组或二次创作，应该完整拷贝目标模组，并重命名模组目录名，而不是直接修改模组内的文件
 +
 +**（注意：此机制仅对 沙盘引擎 版本内置文件生效，自定义等文件不会被更新替换，但需要注意命名避免冲突）**
 +
 +
 +