实例
< Zh
Jump to navigation
Jump to search
实例（Instance）是通过func_instance实体引用的地图文件（.vmf），可配合func_instance_parms和/或func_instance_io_proxy实体使用。
注意:为使实例能编译进地图，gameinfo.txt中必须包含指向游戏FGD文件的GameData键值。仅
求生之路2及后续版本与
军团要塞2默认包含此配置。其他游戏需手动添加才能启用实例功能。也可使用下文提到的预编译器，但若实例旋转角度非正交方向，此方法会显著增加编译成本。注意:在 求生之路2之前的引擎分支中，实例存在功能缺失或异常：不支持实例I/O系统、不可嵌套实例、实例内env_displacement可能编译失败，且实例内所有env_cubemap不会编译进最终地图。注意:引用实例会导致编译后地图的mapversion键值取自某个实例的版本号。实例的应用价值包括：
- 作为预制件的动态替代方案——实例地图的修改会实时同步到所有引用处
- 替代可视分组管理大型地图——将庞大地图拆分为多个易管理的小型地图（支持多人协作）
- 简化非正交角度构造——在独立地图中正向建造结构，再通过旋转的
func_instance导入主地图（相比直接编译旋转结构，此法能减少刷子表面数量从而优化性能，但可能影响物理特性如滑行玩法) - 实现跨平台兼容——例如同时支持
求生之路和 求生之路2版本的地图
实例I/O系统
使用func_instance_io_proxy
求生之路2及后续版本支持实例收发输入输出。需在实例内配置名为proxy的func_instance_io_proxy实体。向实例内实体发送输入的格式如下：
我的输出 目标实体 目标输入 参数 延迟 仅触发一次 
<输出名称> <实例实体> instance:<实体名>;<输入名> <无> 0.00 否
接收实例内实体输出的格式：
我的输出 目标实体 目标输入 参数 延迟 仅触发一次 instance:<实体名>;<输出名> <外部实体> <输入名> <无> 0.00 否
注意:Hammer编辑器应自动补全这些输入输出。即使显示为无效，游戏中仍能正常运行。无func_instance_io_proxy方案
求生之路2之前的游戏需手动处理I/O。发送输入时直接引用修正后的实体名：
My Output Target Entity Target Input Parameter Delay Only Once <输出名称> <修正名>-<实体名> <输入名> <无> 0.00 否
接收输出需通过logic_auto的AddOutput动态添加：
My Output Target Entity Target Input Parameter Delay Only Once OnMapSpawn <修正名>-<实体名> AddOutput <输出名> <目标实体>:<目标输入>::0:-1 0.00 否
注意:若使用Hammer增强插件，推荐改用comp_kv_setter实体在编译时而非运行时添加输出注意:Hammer不会自动补全且会标记为无效，但游戏中仍有效。若实例的"实体名修正规则"设为后缀模式，需交换修正名与实体名的位置。清单系统
通过清单（Manifests）可进一步扩展实例功能。清单将地图内容拆分为特殊的"子地图"实例。与传统实例不同：
- Hammer无需单独打开VMF即可无缝切换子地图
- 子地图视为主地图的延伸（不支持名称修正或位置偏移）
- 单个子地图可被多个清单复用
清单的核心优势：
- 支持多人实时协作开发
- 隔离地图损坏风险（问题仅影响单个子地图）
- 为地图区域分配直观名称
- 优化版本控制系统（如Git）的管理效率
可通过"实例"菜单创建清单。
注意:
Hammer++不支持清单系统，但其实例工具已集成清单核心功能：注意:* 工具 -> 转换实例为选区 可将选区转为实例注意:* 在3D视图中右键实例或点击属性栏的编辑实例（预览），可在主地图参照下编辑实例
证实:修复:
Source 2013 模组可通过代码修改修复VBSP问题：修复:* DeathByNukes分支包含多项通用修复
代码修复:* Mapbase仓库适配
Half-Life 2 并优化实例功能预编译器方案
Metapyziks开发的预编译器可在每次编译前将实例合并到主VMF。虽然GameData方案已使其过时，但技术爱好者可通过二次开发添加新功能（如实例I/O支持或可视分组开关）。
