27 lines
1.3 KiB
Plaintext
27 lines
1.3 KiB
Plaintext
---
|
||
description: Godot 素材引用、导入一致性与可替换占位规范
|
||
globs: "**/*.{gd,tscn,tres,res}"
|
||
alwaysApply: false
|
||
---
|
||
|
||
# Godot 素材与占位
|
||
|
||
## 正式素材
|
||
|
||
- 面向用户的成品视觉应使用项目批准的正式素材；程序绘制只用于确属程序化的视觉、调试或明确的临时占位。
|
||
- 沿用项目现有素材目录、命名、尺寸基准和导入预设，不假设固定路径或分辨率。
|
||
- 文件命名保持稳定、可搜索；移动或重命名后检查场景、资源和脚本引用。
|
||
- 纹理过滤、mipmap、压缩、循环和采样等导入设置按素材用途确定，同类素材保持一致。
|
||
- 逻辑层只引用稳定的资源标识或数据，不直接依赖表现素材。
|
||
|
||
## 缺失素材占位
|
||
|
||
正式素材缺失时可以占位，但必须满足：
|
||
|
||
- 视觉上明显区别于成品，并显示或记录可搜索的 asset key；
|
||
- 在代码或清单中标注 `PLACEHOLDER`，注明期望用途和替换条件；
|
||
- 占位节点尺寸、锚点和接口与目标素材兼容，替换时不要求改业务逻辑；
|
||
- 项目已有统一占位生成器或缺失素材清单时必须复用；没有时采用最小可删除实现，不额外建立复杂系统。
|
||
|
||
提交或交付前搜索未解决的 `PLACEHOLDER`，明确哪些仍被允许保留。
|