meta data for this page
  •  

📚 差别

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

到此差别页面的链接

两侧同时换到之前的修订记录前一修订版
后一修订版		前一修订版
extend:model [2023/09/17 13:37] – bibiboxsextend:model [2023/10/17 22:41] (当前版本) – bibiboxs
行 1: 行 1:
 <markdown> <markdown>
-#模型开发扩展+# 模型开发扩展
  
 在《沙盘引擎》世界场景中，模型占据了视觉上绝大部分，**任何3D模型都被统称为“模型”（Model）。** 在《沙盘引擎》世界场景中，模型占据了视觉上绝大部分，**任何3D模型都被统称为“模型”（Model）。**
行 6: 行 6:
 沙盘引擎默认内置了不同分类下的**多种预制模型**，进阶玩家\开发者可直接在此基础上使用《地图编辑器》进行地图的创作，以供不同模组的调用使用。 沙盘引擎默认内置了不同分类下的**多种预制模型**，进阶玩家\开发者可直接在此基础上使用《地图编辑器》进行地图的创作，以供不同模组的调用使用。
  
-除了内置的预制模型外，沙盘引擎也**支持导入外部文件到当前模组**（支持`gltf\obj`格式），通过此机制，进阶玩家\模组开发者可以将自己想要的模型导入到引擎，同时引擎会自动（或辅助注册`json`）将模型添加到世界列表，无论是地图编辑器或脚本Exec，都可以直接进行创建模型对象及修改属性。+除了内置的预制模型外，沙盘引擎也**支持导入外部文件到当前模组**（支持`gltf\obj`格式）。
  
-> 本文将主要介绍模型开发教程及扩展规范，如果有意将自定义模型导入到沙盘引擎使用，建议参考本文介绍。+通过外部导入机制，开发者可将自己想要的模型导入到世界，同时引擎会自动（或开发者手动注册`json`）将模型添加到世界列表，无论是地图编辑器或脚本API，均可直接创建模型对象及修改属性。 
 + 
 +> **本文将主要介绍模型开发教程及扩展规范，如果有意将自定义模型导入到沙盘引擎使用，建议参考本文介绍。**
 > >
-> 在此之前，建议优先查看[《世界资源实例》](reference/instances)介绍，以了解沙盘引擎内“模型”的基础概念。+> **在此之前，建议优先查看[《世界资源实例》](reference/instances)介绍，以了解沙盘引擎内“模型”的基础概念。**
  
-##模型导入及注册 
  
-如果你已经拥有一些模型等待被导入，那么可以参考以下步骤和介绍。 
  
-首先，任何模型都是基于模组框架下来注册的，你应该先选择（或新建）一个模组目录，并找到目录下的`Store\Model`文件夹，将任何你想要添加的模型文件放置到这里。+## 模型导入及注册
  
-*前提：必须是受支持的模型格式（如：`gltf及obj文件`）*+> 如果拥有一些外部模型想要导入到模组中，那么可以参考以下步骤和介绍。 
 +> 
 +> **导入前提：必须是受支持的模型格式（如：`gltf及obj文件`）** 
 + 
 +模型的导入与注册全部基于模组框架，首先找到模组目录下的`Store\Model`文件夹，将任何你想要导入的模型文件放置到这里，**并正确修改标准文件名（例如：`ID_Name | 10000_Model`）（如果没有修改ID文件名则不会被识别）**。 
 + 
 + 
 +![](asset:1695012629646.png)
  
 > 模型的注册和导入都会在**引擎加载模组时进行**。 > 模型的注册和导入都会在**引擎加载模组时进行**。
 > >
-> 所以在添加新的模型后，**必须进行重载模组指令或重启引擎程序来触发更新。**+> 所以在添加新的模型后，**必须进行重载模组指令（`reload`）或重启引擎程序来触发更新。** 
 + 
 +在完成上述步骤后，如果模型文件本身没有特别的问题，那么最简单的方式，可以打开《地图编辑器》在模型列表中找到导入成功的模型==**（文件名绑定的ID就是引擎内模型ID）**==，反之可以查看[~]控制台是否出现异常报错。 
 + 
 + 
 + 
 +### GLTF格式注意事项 
 + 
 +GLTF模型仅支持导入**标准\规范格式**的文件，如果出现==导入报错或不确定是否能导入==，可通过[【glTF Viewer】](https://gltf-viewer.donmccurdy.com/ "【glTF Viewer】")验证模型完整\兼容性。 
 + 
 +**建议优先使用：gltf+模型与贴图一体格式。** 
 + 
 + 
 + 
 +### OBJ格式注意事项 
 + 
 +OBJ格式通常由多个文件组成一个模型（例如：`.obj|.mtl|.png`等），这些文件分别表示【模型网格、材质配置、材质贴图等】，如果缺少部分文件可能会导致显示异常（GLTF模型通常为一体化的文件格式，则可以忽略这个问题）。 
 + 
 +**基于多文件组成的原因，导入OBJ模型时需要注意：==只将`.obj`文件修改前缀ID文件名，其他附带文件通常不需要更改。==** 
 + 
 +> 示例：开发者希望导入一套obj模型（`Book.obj | Book.mtl | Book.png`），首先**按照正常步骤**将所有文件放置到`LocalMod\Store\Model`目录内，紧接着**==只==需要修改`Book.obj`文件名为`10000_Book.obj`即可**，其他的`mtl\png`等附带文件不需要修改前缀。
  
-在完成上述步骤后，如果模型文件本身没有特别的问题，那么最简单的方式，可以打开《地图编辑器》在模型列表中找到导入成功的模型，反之，你也可以优先查看[~]控制台是否出现异常报错。 
  
-**注意：模型仅支持导入标准\规范格式的文件，如果出现==导入报错或不确定是否能导入==，可通过[【glTF Viewer】](https://gltf-viewer.donmccurdy.com/ "【glTF Viewer】")验证模型完整\兼容性（建议使用：gltf+模型与贴图一体格式）。** 
  
 ### 高级设定 ### 高级设定
行 40: 行 65:
 如果你看过了[《世界资源实例》](reference/instances)文章，那么你应该大致了解《沙盘引擎》以提前为不同种类的模型设定好了分类，并且是以`Package包`的形式来呈现的，实际上每个包就相当于一个json注册文件。 如果你看过了[《世界资源实例》](reference/instances)文章，那么你应该大致了解《沙盘引擎》以提前为不同种类的模型设定好了分类，并且是以`Package包`的形式来呈现的，实际上每个包就相当于一个json注册文件。
  
-根据上述提及的文章所示，==**任何非官方内置的模型资源，模型ID都是从10000开始递增的**，也就是说**无论外部模型是否进行了高级设定注册，模型的ID都永远不会是10000以下的数字，且默认被放置到`模组资源包（特殊）`包内==**。+根据上述提及的文章所示，==**任何非官方内置的模型资源，模型ID都是从10000开始递增的**，也就是说**无论外部模型是否进行了高级设定注册，模型的ID都永远不会是10000以下的数字，且默认被放置到【模组资源包（特殊）】包内==**。
  
----+ 
 + 
 +### 高级设定步骤
  
 那么如果想要为模型注册高级设定，请参考以下步骤来进行操作： 那么如果想要为模型注册高级设定，请参考以下步骤来进行操作：
  
-首先找到模组目录下的`Data\Model`文件夹，然后找到或新建一个`json`文件，打开进行编辑（默认原始情况下，此目录可能需要手动新建一个json文件）。+首先找到模组目录下的`Store\Data\Model`文件夹，然后找到或新建一个`json`文件，打开进行编辑（默认原始情况下，此目录可能需要手动新建一个json文件）。
  
 > **注意：这里的json文件命名会有一些讲究。** > **注意：这里的json文件命名会有一些讲究。**
行 64: 行 91:
 > **扩展：**根据《世界实例资源》文档介绍，`0004_TEST.json`应该表示**乡村资源包**，如你所见，命名最关键的主要是"_"前半部分的索引ID，至于后面的名字可以合理的自定义修改。 > **扩展：**根据《世界实例资源》文档介绍，`0004_TEST.json`应该表示**乡村资源包**，如你所见，命名最关键的主要是"_"前半部分的索引ID，至于后面的名字可以合理的自定义修改。
  
-*当然，如果你已经理解了这些内容，你完全可以决定是否这样做，这会增加一些操作成本，但是会换取一些分类便利。*+*当然，如果你已经理解了这些内容，你完全可以决定是否这样做，这会增加一些操作成本，但是也许会换取一些分类便利。*
  
-### 高级设定配置+ 
 + 
 +### 配置文件
  
 根据上方介绍的高级设定内容，应该已经大致了解设定注册的意义，现在开始介绍具体的json配置方式。 根据上方介绍的高级设定内容，应该已经大致了解设定注册的意义，现在开始介绍具体的json配置方式。
行 114: 行 143:
 > >
 > 只是更多为有兴趣建模的开发者指引一条可能的道路和指引。 > 只是更多为有兴趣建模的开发者指引一条可能的道路和指引。
 +
 +
  
 ### 推荐建模工具 ### 推荐建模工具
行 132: 行 163:
  
 *有关建模工具的教程请参考http://www.bilibili.com/搜索查看。* *有关建模工具的教程请参考http://www.bilibili.com/搜索查看。*
 +
 +
  
 ## 特殊模型规范 ## 特殊模型规范
 +
 +### LOD模型及命名
 +注意：如果模型存在父子节点关系，应该避免将子物体命名包含`_LOD`相关字样，这可能会触发引擎其他机制，导致碰撞等系统出现问题。
  
 ### 可进入建筑模型 ### 可进入建筑模型
行 139: 行 175:
  
 ==（此处内容等待同步更新完善）== ==（此处内容等待同步更新完善）==
 +
 +
 +