小地图

贝尔蒙特小地图 1.1.4

一个实时角落小地图，使用游戏自带的地图渲染、图标和探索数据，外观与原生全地图完全一致。

功能
• 在显示设置中，地形亮度（50–200%，以5%为步进）和阴影增强（伽马1.00–0.50，以0.05为步进）。默认值为100%亮度和0.70阴影伽马；较低的伽马值会提亮暗色。升级时会保留现有设置。图标和游戏画面保持不变。
• 房间收集品数量在地图外有一个单独的雙列面板，文字更大；按键绑定标签与其他设置行对齐。
• 三种预设尺寸或按屏幕百分比自定义尺寸（放大后仍保持在屏幕内），可置于四角任意位置，支持缩放调节、背景/内容不透明度以及金色边框。
• 按类别标记开关：存档点、门、快速旅行门、机关、角色、地标等，遵循原生地图的可见性规则。
• 跟随玩家或锁定当前房间；在房间之间无缝更新，无需重新打开完整地图。
• 在对话、过场动画和菜单期间自动隐藏；将游戏通知移开右上角；可选在Boss战中淡出。
• 战争迷雾与原生全地图一致：未探索区域保持遮盖。开启“显示全部地形”辅助选项即可看到全部内容。
• 辅助选项（默认全部关闭，包含剧透内容）：秘密区域、全部地形、当前房间内剩余收集品，以及生命/法力碎片、攻击/防御之书、宝箱和经验来源的位置。
• 原生全地图辅助：相同的收集品图标、光标所在房间的剩余数量、秘密以及全地形选项在全地图上同样有效。“显示完成度缺口”会列出原生完成度低于100%的类别。
• 前往标记点（辅助功能，默认关闭）：可在任意距离精准降落；若落点不安全，则自动改为降落在目标区域内最近的可用的镜子／渡口。参见下方控制说明。
• 显示功能不会写入游戏存档，也不会改变探索/进度。旅行会移动玩家；跨区域旅行使用原生区域加载器，该加载器会在出发时自动保存一次进度。模组不会在标记处保存。

设置
• 暂停菜单 → MODS → 小地图 → 设置。四个标签页：显示 / 标记 / 行为 / 辅助。Q/E 或 L1/R1 切换标签页；鼠标滚轮滚动。更改立即生效；文本跟随游戏语言（英语 / 简体中文）。
• 快捷键（显示/隐藏、循环大小、按住放大）默认未绑定。在“行为”选项卡中，选择一行并按下一个键：Esc 取消，Backspace 清除，10 秒后自动取消。仅限键盘。绑定会拒绝游戏过程中使用的按键（移动、跳跃、攻击、打开菜单等，遵循你当前的游戏绑定）以及其他小地图快捷键，包括传送键；游戏自身的绑定永远不会被更改。直接编辑配置文件会绕过此检查。
• 旅行：在辅助功能中启用“前往标记”（小地图本身可能处于关闭状态）。在地图上放置所选旅行图标的标记（默认为月亮），关闭地图，然后按住手柄R3键0.5秒或按G键。当屏幕提示出现时，在3秒内再次按下以确认（再次按下前请松开R3）。键盘按键可在辅助功能中重新绑定；手柄长按为固定操作。战斗、过场动画、菜单和加载期间无法旅行；受到伤害或房间切换会取消确认。
• 配置文件：BepInEx/config/local.belmont.minimap.cfg（菜单会编辑此文件）。

翻译
你可以在 BepInEx/plugins/BelmontMinimap/lang/ 中添加自己的语言。复制 en.txt 并将副本重命名为游戏语言代码，例如 ko.txt（韩语）、ja.txt（日语）、fr.txt、de.txt、it.txt、es.txt、pt-BR.txt、ru.txt 或 zh-TW.txt。已包含英文和简体中文（zh-CN.txt）模板以及巴西葡萄牙语（pt-BR.txt）翻译。请以 UTF-8 保存（带或不带 BOM 均可）；文件名不区分大小写。
只翻译=之后的文本。保留键名、{0}等占位符以及\n换行符。保留值开头/结尾的空格。以#开头的行是注释。缺失的条目使用en.txt，然后使用内置英文（简体中文则使用内置简体中文）。无效的占位符或当前游戏字体中缺失的字符，该条目将回退为英文。本模组不添加字体。切换游戏语言离开再切回以重新加载已编辑的文件；没有lang文件夹则保留原始英文/简体中文文本。这些文件涵盖小地图和共享的MODS控制项；其他模组保留各自的文本。
请在Nexus评论区分分享你的翻译！

需求
• Windows x64 平台的 Steam 版本，游戏 BuildID 25975867。
• BepInEx 6 Unity IL2CPP x64（前沿版本 #788）： 官方下载请使用 Unity.IL2CPP-win-x64，而不是 Mono 或 x86 版本。如果已经安装过，则无需重新安装。
• 游戏专用Nexus包 《恶魔城》BepinEx （6.0.788，同一构建版本）也可用且已测试。

安装/升级
1. 退出游戏。首次使用 BepInEx：将其解压到游戏文件夹中（与游戏可执行文件放在一起），启动游戏一次以让其初始化，然后退出。
2. 将此模组的 zip 文件解压到游戏文件夹中，保留 BepInEx/plugins/BelmontMinimap/ 目录结构。升级时直接覆盖即可，你的设置会被保留。
3. 开始游戏。

卸载
退出游戏并删除 BepInEx/plugins/BelmontMinimap/ 文件夹。你可以保留配置文件以备后用。请勿删除整个 BepInEx 文件夹或其他模组。

兼容性与游戏更新
• 此模组在暂停菜单中提供“模组”选项卡；支持的模组（如“无限护符”）会自动出现在其列表中。1.1.0 版本为支持的模组添加了滑块和选项控件。没有此模组时，它们仍可通过各自的配置文件继续工作。
• 已在游戏 1.1.3 版本（BuildID 25975867）上测试。如果游戏更新后某个功能出错，只会禁用该功能，并将错误记录到 BepInEx/LogOutput.log；无法可靠放置的房间或收集品会被隐藏。较大的游戏更新可能仍需要更新模组。

已知限制
• 少数特殊房间（如快速旅行房间）仅在其位置能够可靠映射时才会显示，否则将被隐藏。
• 收集品状态来自游戏已记录的内容。游戏尚未记录的项目视为“未知”：默认隐藏（辅助选项会将其显示为问号），且不计入房间的剩余数量。
• 在底部角落，小地图可能会与游戏的教学/按钮提示重叠（默认的右上角不受影响）。

常见问题
• 无 MODS 选项卡：检查 BepInEx/LogOutput.log 中是否有 Belmont Minimap 消息（例如“MODS disabled…”），并将其包含在你的报告中。
• BepInEx 控制台窗口被刷屏了：这些大多是游戏自身的 Unity 警告。在 BepInEx/config/BepInEx.cfg 中的 [Logging.Console] 下将 Enabled 设为 false 即可隐藏。
• 报告问题：请附上游戏 BuildID、模组版本、分辨率、游戏语言、截图以及 BepInEx/LogOutput.log。如遇显示问题，请在配置文件的 [Keys] 下为 Snapshot 设置一个按键（例如 F9），并在问题出现时按下该键。

更新日志
1.1.4
• 镜厅中的标记传送现已可用：解锁后其码头将作为着陆点；在此之前，仍可在当前房间内传送。
• 现在屏幕上会显示一条简短提示，说明无法快速旅行的情况（标记区域内没有标记点，或没有可用的传送镜/码头），而不是毫无反应。
• 添加了由 RondoRevolution 提供的巴西葡萄牙语 (pt-BR) 翻译。
1.1.3
• 特殊背景房间（主要是城堡主厅，以及贫民街和地下墓穴Boss房间中的少数几个）中的27个收集品现在会显示其地图位置；此前它们仅被计数。
• 修复了全地图房间提示偶尔消失的问题（1.1.2 字体变更）。
1.1.2
• 菜单、小地图和全地图文本使用游戏自带的、适合您语言的显示字体（长描述则保留普通字体）。
• 已完成的区域在小地图上保持金色，与全地图上一致，而不会在切换房间后再次变为紫色。
• 通往已完成区域的门使用游戏的金色门图标（静态，无闪烁）。
• 设置窗口：滚动时页面注释保持在标签页下方；窗口标题不再与标签页重叠。
1.1.1
• 通过 lang 文件夹添加你自己的翻译；内含英文和简体中文模板。
1.1.0
• 新增可选的地图标记旅行功能，使用按住 R3 键或可重新绑定的 G 键，再按一次确认；不安全的落点会回退到附近的镜像或渡口。跨区域旅行使用原生加载和出发存档，标记处不保存。
• 新增原生全地图辅助功能：收集品图标、光标所在房间剩余数量、秘密、全部地形及原生完成度缺失项。
• 新增地形亮度和阴影增强滑块；新配置的阴影伽马默认值为 0.70。
• 将房间收集品计数移至地图外，放大文字并固定行距。
• 已将小地图快捷键行与其他设置标签对齐。
• 为其他模组添加了模组滑块和选项控件。
1.0.0
• 首次发布。

制作人员
• BepInEx 由 BepInEx 团队（包括 Il2CppInterop 和 HarmonyX）制作——本模组所运行的框架。
• 《恶魔城》BepinEx 由KZekai制作——本游戏的BepInEx整合包。

• KeinZantezuken 的调试模组 — 启发了使用原生强制房间切换。
• toxicgtr 制作的贝尔蒙特快速旅行（MIT）——研究参考。
• 巴西葡萄牙语翻译： 回旋革命.



中文说明

屏幕角落的实时小地图，直接使用游戏自己的地图画面、图标和探索记录，看起来和原版大地图一致。

功能
• 显示页新增地形亮度（50%–200%，每档 5%）和暗部提升（gamma 1.00–0.50，每档 0.05）。默认亮度 100%、暗部 gamma 0.70，gamma 越小暗部越亮；升级保留已有设置；不改变图标与游戏画面。
• 房间收集品统计移到地图外侧的独立双列面板，文字加大、行距固定；三行改键标签与其他设置对齐。
• 三档预设尺寸，或按画面百分比自定尺寸（放大时也不会超出画面），四个角任选，可调缩放、背景与内容透明度、金色外框。
• 标记按类别单独开关：存档点、门、快速旅行门、机关、角色、地标等，显示规则与原版大地图相同。
• 跟随玩家或固定当前房间；换房间无缝更新，不用重开大地图。
• 对话、过场、菜单时自动隐藏；位于右上角时将游戏通知下移避让；Boss 战可淡出。
• 迷雾与原版大地图一致：没探索到的地方照样遮住；想看全图可开辅助选项"显示全部地形"。
• 辅助选项（默认全关，含剧透）：秘密区域、全部地形、当前房间剩余收集品提示，以及生命/魔力碎片、攻/防书、宝箱、经验来源的位置。
• 大地图辅助：原有收集品图标、光标所在房间剩余数、秘密区域、全部地形开关同时作用于原版大地图；新增“显示完成度差项”，列出原版完成度未满的类别。
• 传送到标记（辅助选项，默认关闭）：任意距离精确落点；落点不安全时改去目标区域最近的合资格镜子 / 码头。操作见下方。
• 显示功能不写入游戏存档，也不修改探索或进度。传送会移动玩家；跨区域时使用原版区域加载，原版会在出发时自动保存一次进度。插件不会在标记位置存档。

设置
• 暂停菜单 → MODS → 小地图 → 设置。四个分页：显示／标记／行为／辅助选项；Q/E 或 L1/R1 切换分页，鼠标滚轮可滚动。设置即时生效，文字跟随游戏语言（简体中文 / English）。
• 快捷键（显示/隐藏、切换尺寸、按住放大）默认不绑定。在“行为”页选中一行后按一个键即可绑定：Esc 取消，Backspace 清除，10 秒不按自动取消。只支持键盘。绑定时会拒绝游戏进行中用到的键（移动、跳跃、攻击、打开菜单等，按你当前的游戏键位）和其他小地图快捷键（含传送键）；不会改动游戏自己的按键。直接改配置文件不经过这项检查。
• 传送：在“辅助选项”打开“传送到标记”（小地图本身可关闭）。在地图放下所选传送图标的标记（默认月亮）→ 关闭地图 → 手柄长按 R3 0.5 秒 / 键盘 G → 出现屏幕提示后，3 秒内再按一次确认（R3 需先松开再短按）。键盘键可在辅助页修改，手柄长按固定。战斗、剧情、菜单、加载时不可发起；受伤、换房会取消确认。
• 配置文件：BepInEx/config/local.belmont.minimap.cfg（菜单里改的就是它）。

翻译
可在 BepInEx/plugins/BelmontMinimap/lang/ 添加自己的语言。复制 en.txt，按游戏语言代码改名，例如韩语 ko.txt、日语 ja.txt、fr.txt、de.txt、it.txt、es.txt、pt-BR.txt、ru.txt 或繁中 zh-TW.txt；随包提供英文与简中 zh-CN.txt 模板，以及巴西葡萄牙语 pt-BR.txt 翻译。保存为 UTF-8（有无 BOM 都可），文件名不区分大小写。
只翻译等号右侧，保留键名、{0} 等占位符及表示换行的 \n，并保留文字首尾空格；# 开头为注释。缺项逐条查 en.txt，再回退内置英文（简中最终回退内置简中）；占位符错误或当前游戏字体缺字时，仅该条回退英文，插件不会补字。修改后把游戏语言切走再切回来即可重读；没有 lang 文件夹时沿用原有中英文。这些文件覆盖小地图与共用 MODS 控件，其他 mod 的文字由各自提供。
欢迎在 Nexus 评论里分享你的翻译！

前置
• Steam 版 Windows x64，游戏 BuildID 25975867。
• BepInEx 6 Unity IL2CPP x64（前沿版本 #788）：官方下载务必选择 Unity.IL2CPP-win-x64，不能使用 Mono 或 x86 版本。已经安装好的无需重新安装。
• 也可以使用 Nexus 上本游戏的 BepInEx 包：《恶魔城》BepinEx（6.0.788，与上面是同一构建，已测试）。

安装 / 升级
1. 退出游戏。首次使用 BepInEx：把框架解压到游戏根目录（与游戏 exe 同级），启动一次游戏完成初始化后退出。
2. 将本 mod 的 zip 解压到游戏根目录，保持 BepInEx/plugins/BelmontMinimap/ 层级。升级时直接覆盖，原有设置保留。
3. 启动游戏。

卸载
退出游戏，删除 BepInEx/plugins/BelmontMinimap/ 文件夹。配置文件可留着重装用。不要删除整个 BepInEx 或其他 mod。

兼容与游戏更新
• 暂停菜单里的 MODS 页由本 mod 提供，其他支持的 mod（如 Charms Unlimited）会自动出现在列表里；1.1.0 新增供其他 mod 使用的滑块与枚举选项；没装本 mod 时，它们照常通过各自的配置文件工作。
• 已在游戏 1.1.3（BuildID 25975867）上测试。游戏更新后如果某项功能出错，只停用该功能并写入 BepInEx/LogOutput.log，其余照常；位置对不上的房间或收集品会隐藏。大的游戏更新仍可能需要更新本 mod。

已知限制
• 快速旅行房间等少数特殊房间只在位置能可靠对应时显示，否则隐藏。
• 收集品的拾取状态以游戏已有的记录为准；游戏还没有记录状态的物品算作“未知”，默认不显示（可在辅助选项里改为显示问号），房间剩余数也不计入它们。
• 放在底部两角时，可能与游戏的教程 / 按键提示重叠（默认右上角不受影响）。

常见问题
• 没看到 MODS 页：查看 BepInEx/LogOutput.log 里 Belmont Minimap 的提示（如“MODS disabled…”），反馈时附上。
• BepInEx 控制台窗口刷屏：那些多是游戏自身的 Unity 警告。可在 BepInEx/config/BepInEx.cfg 的 [Logging.Console] 中将 Enabled 设为 false 来关闭窗口。
• 反馈问题：请附游戏 BuildID、mod 版本、分辨率、游戏语言、截图和 BepInEx/LogOutput.log。小地图显示问题，可在配置文件 [Keys] 里给 Snapshot 设一个键（如 F9），出问题时按一下，状态会写进日志。

更新记录
1.1.4
• 镜之厅现在可以传送到标记：码头解锁后作为落脚点；解锁前也能在当前房间内传送。
• 无法传送时（没有标记，或标记所在地图没有可用的镜子 / 码头）屏幕中央会短暂提示，不再毫无反应。
• 新增巴西葡萄牙语（pt-BR）翻译，译者 RondoRevolution。
1.1.3
• 特殊背景房间里的 27 件收集品（大多在恶魔城中央区，另有贫民街几间和地下墓穴 Boss 房）现在会在地图上标出位置，以前只计入房间数。
• 修复大地图房间提示偶尔消失（1.1.2 字体改动引起）。
1.1.2
• 菜单、小地图和大地图文字改用游戏对应语言的原版装饰字体（长说明仍用普通字体）。
• 已收集齐的地区在小地图上保持金色，与大地图一致（以前换房间后会变回紫色）。
• 通往已完成区域的门改用原版金色门图标（静态，不闪动）。
• 设置窗口：页面说明固定在标签下方，不再随列表滚走；窗口标题不再压住标签。
1.1.1
• 可通过 lang 文件夹自行添加翻译，附英文与简中模板。
1.1.0
• 新增可选的传送到标记：长按 R3 / 可改的 G 键触发，再按确认；落点不安全时退到附近镜子 / 码头。跨区沿用原版加载与出发存档，不在标记处存档。
• 新增大地图辅助：收集品图标、光标房间剩余数、秘密、全部地形与原版完成度差项。
• 新增地形亮度与暗部提升滑条，新配置的暗部 gamma 默认 0.70。
• 房间收集品统计已移出地图，文字已放大并修正行距。
• 小地图改键行与其他设置标签对齐。
• MODS 菜单新增供其他 mod 使用的滑块与枚举选项。
1.0.0
• 首个版本。

致谢
• BepInEx（BepInEx 团队，含 Il2CppInterop、HarmonyX）——本 mod 运行所依赖的框架。
• 《恶魔城》BepinEx（KZekai）——本游戏的 BepInEx 整合包。

• Debug Mod（KeinZantezuken）——启发了使用原生强制换房的思路。
• 贝尔蒙特快速旅行（toxicgtr，MIT）——研究参考。
• 巴西葡萄牙语翻译：回旋革命。