用途:创建和编辑 Defold 引擎中以 Protobuf Text Format 序列化的资源与组件文件,不覆盖 Lua 脚本(.script、.gui_script、.render_script、.editor_script)和 GLSL 着色器(.vp、.fp、.glsl)。
主要能力:支持 .collection、.go、.gui、.atlas、.sprite、.collisionobject、.convexshape、.label、.font、.material、.model、.mesh、.particlefx、.sound、.camera、.factory、.collectionfactory、.collectionproxy、.tilemap、.tilesource、.objectinterpolation 等类型,每种类型在 references/ 下有字段参考文件。附带脚本:get_image_size.py 读取 PNG/JPEG 尺寸;gen_convexshape.py 从图像轮廓生成 .convexshape;gen_silhouette_chain.py 生成带旋转盒链的 .collisionobject。
使用方式:新建文件时先确定类型与路径,查阅对应 reference 文件,设置必填字段,仅在非默认值时设置可选字段,按 proto 字段编号顺序排列。编辑时只改指定字段,保留原有值与顺序,并移除等于默认值的字段。
格式规则:省略等于默认值的字段;消息用 field_name { ... };浮点带小数点,整数不带;字符串双引号;枚举用常量名不加引号;布尔用 true/false;重复字段逐行书写;无尾随逗号或分号;缩进 2 空格。向量类型(Vector3、Vector3One、Vector4、Vector4One、Vector4WOne、Quat)只写与默认值不同的分量。嵌入数据字符串需按嵌套层级转义,双层嵌套时内层引号与换行需双重转义,内层 data 的结束引号处换行用单转义。
限制:不处理 Lua 脚本与着色器文件;GUI 组件不能内联嵌入,只能作为引用组件添加;.go 或 .collection 中嵌入组件类型字符串需使用规定值(如 tilemap 的类型为 "tilegrid")。着色器与材质关系、实例化属性 mtx_world/mtx_normal 等细节见资料,但本技能不编辑着色器文件。