Unciv游戏资源显示功能回归分析

背景介绍

Unciv是一款开源的文明类游戏，在游戏开发过程中，资源管理是核心玩法之一。近期发现了一个关于资源显示功能的回归问题：当玩家尚未拥有某种战略资源(如石油)时，游戏界面无法显示该资源的全局分布情况，导致玩家难以规划资源获取策略。

问题现象

在游戏当前版本中，当玩家研究出"生物学"科技后，地图上会显示石油资源的位置。然而，如果玩家领土内没有石油资源，在"概览-资源"界面中就不会显示石油这一栏。这使得玩家无法通过界面提供的资源循环查看功能来定位地图上所有的石油资源点，只能手动扫描整个地图来寻找。

技术分析

通过查看源代码，发现问题出在资源列表的合并逻辑上。游戏中有两个资源列表：

1. resourceDrilldown - 玩家当前拥有的详细资源列表
2. extraDrilldown - 额外资源列表(包含已发现但未拥有的资源)

在合并这两个列表时，代码使用了ResourceSupplyList().apply { add(...) }的方式，这会丢失extraDrilldown中设置的keepZeroAmounts = true参数，导致未拥有资源被过滤掉。

解决方案

修复方案是恢复之前的序列合并方式，使用resourceDrilldown.asSequence() + extraDrilldown来合并两个资源列表。这样可以保留所有已发现资源的信息，无论玩家是否拥有它们。

同时修复了另一个相关问题：在检查资源是否应该显示时，需要传入玩家状态参数，以确保某些特殊资源(如模组添加的资源)的正确显示逻辑。

影响范围

该修复将影响所有战略资源和奢侈资源的显示逻辑。修复后，玩家将能够：

1. 在资源概览界面看到所有已发现资源类型
2. 通过点击资源图标循环查看地图上的所有该资源位置
3. 更好地规划资源获取策略

技术实现细节

关键修改点包括：

1. 改变资源列表合并方式，保留零数量资源
2. 完善资源显示过滤逻辑，正确处理特殊资源
3. 确保界面显示的稳定性和一致性

用户体验改进

这一修复将显著提升游戏体验，特别是对于战略规划型玩家。现在他们可以：

• 全面了解资源分布情况
• 更有效地制定扩张和战争策略
• 减少不必要的界面操作和地图搜索时间

总结

资源显示功能的回归修复不仅解决了当前的问题，还增强了游戏的核心玩法体验。通过正确处理资源数据的合并和显示逻辑，确保了游戏信息的完整性和可用性，使玩家能够做出更明智的战略决策。