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

问题背景

在Tiled地图编辑器1.11.0版本中，开发者发现通过脚本API向.world文件写入自定义属性时遇到了保存问题。具体表现为：虽然通过asset.setProperty()方法可以成功设置属性值，并且通过asset.property()方法也能正确读取，但这些自定义属性最终并未被持久化保存到.world文件中。

技术分析

这个问题源于Tiled内部对World类实现的一个设计缺陷。在Tiled的架构中：

1. World类继承自Object基类，这使得World对象具备了存储自定义属性的能力
2. 然而World类的保存逻辑(save方法)没有正确处理从Object基类继承来的自定义属性
3. 由于图形界面(GUI)没有提供直接编辑World属性的功能，这个问题在早期版本中被忽视

问题复现

开发者可以通过以下步骤复现该问题：

1. 通过脚本API设置World属性：

tiled.worlds[0].setProperty("foo", "bar");

2. 验证属性设置成功：

JSON.stringify(tiled.worlds[0].properties())

3. 保存并重新加载World文件后，自定义属性丢失

解决方案

Tiled开发团队已经意识到这个问题并在内部修复。修复方案主要涉及：

1. 修改World类的保存逻辑，确保正确处理从Object基类继承的自定义属性
2. 确保World文件的序列化过程包含所有自定义属性数据

开发者建议

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

1. 建议升级到修复该问题后的Tiled版本
2. 在脚本中操作World属性时，注意检查属性是否持久化
3. 对于关键数据，建议实现双重验证机制，既检查内存中的属性值，也验证文件中的持久化结果

总结

这个问题展示了软件设计中继承关系与实际功能实现之间可能出现的不一致情况。虽然从架构设计上World应该支持自定义属性，但由于实现细节的疏忽导致了功能缺陷。这也提醒我们，在软件开发中，当扩展类的功能时，需要全面考虑所有相关方法的同步更新。