Tiled地图编辑器中的World文件自定义属性保存问题解析

问题背景

在Tiled地图编辑器1.11.0版本中，开发者发现通过脚本API为World文件设置的自定义属性无法被正确持久化保存。虽然通过asset.setProperty()方法可以临时设置属性值，并且通过asset.property()也能读取到该值，但当World文件被重新加载时，这些自定义属性就会丢失。

技术原理分析

World文件作为Tiled中用于管理多个地图文件关联关系的特殊资源类型，其底层实现经历了重要演变。在Tiled 1.11.0版本中，World类从Object类派生而来，这使得World对象继承了设置自定义属性的能力。然而，World类的保存逻辑中却遗漏了对自定义属性的处理。

具体表现为：

1. 脚本API层面可以正常调用setProperty()设置属性
2. 内存中的World对象确实保存了这些属性
3. 但World::save()方法没有将这些属性写入.world文件
4. 导致World文件重新加载时属性丢失

解决方案实现

该问题已在最新代码中得到修复。开发团队在World类的保存逻辑中增加了对自定义属性的处理，确保：

• 自定义属性会被序列化到.world文件中
• 文件重新加载时能正确恢复这些属性
• 保持与其他Tiled资源类型（如TileMap）的行为一致性

开发者建议

对于需要使用此功能的开发者，建议：

1. 升级到包含此修复的Tiled版本（1.11.0之后的版本）
2. 在脚本中使用标准属性API操作World属性
3. 注意World文件是纯文本JSON格式，可以手动验证属性是否被正确保存

技术启示

这个案例展示了框架演进过程中可能出现的接口与实现不一致问题。当World类获得新能力（继承自Object的属性系统）时，需要同步更新所有相关功能（如序列化逻辑），才能保证功能的完整性。这也提醒开发者在扩展类功能时，需要全面考虑所有相关组件的适配工作。