SettingsConfig

hunternif.mc.atlas.SettingsConfig。Forge Configuration 驱动的单一 .cfg 性能/界面配置，14 项，分 3 个分类，在 preInit 从 config/antiqueatlas/settings.cfg 加载，配置版本 VERSION = 3。

基本信息

属性	值
类	`hunternif.mc.atlas.SettingsConfig`
文件	`config/antiqueatlas/settings.cfg`
内部版本	3
选项数	14（Gameplay 3 + Interface 5 + Performance 6）
全局实例	`AntiqueAtlasMod.settings`（`public static final`）
加载时机	`AntiqueAtlasMod.preInit()` → `settings.load(new File(proxy.configDir, "settings.cfg"))`

Gameplay 分类

配置键	类型	默认值	取值范围	作用
`do_save_browsing_pos`	boolean	`true`	—	是否记住每本图册每个维度上次打开的浏览位置与缩放。关闭后所有维度、所有图册共用同一坐标，地图默认「跟随玩家」
`auto_death_marker`	boolean	`true`	—	玩家死亡时是否在死亡点自动加本地「墓碑」标记
`auto_village_markers`	boolean	`true`	—	是否为 NPC 村庄自动添加全局标记

Interface 分类

配置键	类型	默认值	取值范围	作用
`do_scale_markers`	boolean	`false`	—	标记图标是否随缩放级别改变大小
`default_scale`	float	`0.5`	`0.001953125` ~ `16`	默认缩放级别，即 1 个方块相对 1 个 GUI 像素的尺寸；建议取 2 的幂
`min_scale`	float	`1.0/32.0` = `0.03125`	`0.001953125` ~ `16`	最小缩放级别；更小的值会降低性能
`max_scale`	float	`4`	`0.001953125` ~ `16`	最大缩放级别
`do_reverse_wheel_zoom`	boolean	`false`	—	`false` 时滚轮上=放大、下=缩小；`true` 时反转

0.001953125 即 2 的负 9 次方 = 1/512，是 Forge 侧硬编码的下界。

Performance 分类

配置键	类型	默认值	取值范围	作用
`area_scan_radius`	int	`11`	`1` ~ `256`	定期扫描玩家周围区域的半径（区块）。除非开启 `force_chunk_loading`，否则不会强制远处区块加载。调小可提升性能
`force_chunk_loading`	boolean	`false`	—	即使超出常规区块加载距离也强制加载扫描半径内的区块。开启会严重降低性能
`area_scan_interval`	float	`1.0`	`1/20` ~ `3600`	两次区域扫描之间的秒数。调大可提升性能
`do_rescan`	boolean	`true`	—	是否重扫已绘制过的区块。用于海岸线变化（含小水塘/岩浆塘）或天世界陆地消失的情况。关闭可提升性能
`area_rescan_rate`	int	`4`	`1` ~ `1000`	每多少次区域扫描才做一次完全重扫。调大可提升性能
`do_scan_ponds`	boolean	`true`	—	是否额外扫描以定位小水塘/岩浆塘。关闭可提升性能

其它 JSON 配置文件

config/antiqueatlas/ 下另有 5 个 JSON 文件，由 AbstractJSONConfig 子类各自管理，版本均为 1：

文件	配置类	端	内容
`tileids.json`	`ExtTileConfig`	双端	自定义 tile 名 → 伪群系 ID 的持久化映射。存在于此是因为图册 NBT 里只存 ID 不存名字
`texture_sets.json`	`TextureSetConfig`	客户端	纹理集名 → 纹理组定义（`TextureSetMap`）
`biome_textures.json`	`BiomeTextureConfig`	客户端	原版群系 ID → 纹理集。旧文件名 `textures.json` 会在 `ClientProxy.preInit` 自动 `renameTo`
`tile_textures.json`	`ExtTileTextureConfig`	客户端	自定义 tile 名 → 纹理集名
`marker_textures.json`	`MarkerTextureConfig`	客户端	标记类型名 → 材质 `ResourceLocation`