昆特牌玩家地图

[size=5][b]昆特牌玩家地图[/b][/size]

[quote][b]1.0.9：[/b]移除了四张无法被击败的史凯利格牌。 [b]1.0.8：[/b]在[b]昆特牌[/b]地图筛选器中，每张卡牌现在正好位于其玩家所站的位置；在其他筛选器中，卡牌保持在商店图标旁边（[i]图标放置[/i]选项已移除）。新增选项[b]显示谁出售昆特牌[/b]。[/quote] 一个适用于[b]《巫师3：狂猎（重制版 / 次世代版）》[/b]的小型模组，将每个你可以挑战的昆特牌玩家放置在世界地图上：店主、铁匠、防具师、旅店老板、草药师以及其他愿意和你打牌赢卡的商人。目标很简单：找到还有牌可以给你的玩家，从而壮大你的牌组。

你已击败的玩家会以灰色显示，就像游戏将你已清理的地点变灰一样。

[size=4][b]功能[/b][/size]

[list] []每个昆特牌玩家在世界地图上都有一个卡牌图标：你还能赢取东西时显示为白色，击败他们后变为灰色。[/] []一个[b]“昆特牌”地图筛选器[/b]：在筛选器选择器（地图左下角）中选择它，即可只显示昆特牌玩家。卡牌也会在“全部”和“默认”下显示。[/] []地图图例中的[b]“昆特牌玩家”一行[/b]，包含卡牌图标、数量，以及从一个玩家跳转到下一个玩家的箭头。[/] []将鼠标悬停在卡牌上可查看其身份以及是否已被击败（例如“昆特牌玩家” / “铁匠 - 尚未击败。”）。[/] []兼容你当前的存档：安装模组前已击败的商人也会正确显示为已击败（参见“工作原理”）。[/] []覆盖白果园、威伦、诺维格瑞、牛堡、史凯利格和陶森特，包括《石之心》和《血与酒》添加的少数商人。[/] [][b]两种卡牌尺寸[/b]：采用游戏自身图标风格的小卡牌，或经典大卡牌。[/] [][b]支持所有游戏语言（18种）[/b]，内置于主文件中。[/] []选项菜单：隐藏标记、隐藏已击败的玩家（仅显示剩余的）、显示哪些玩家也出售昆特牌、选择卡牌尺寸、开启或关闭“已击败”通知，以及“调试信息”开关。[/] [/list]

[size=4][b]须知：商人会给你什么[/b][/size]

[list] [][b]普通商人[/b]（威伦、诺维格瑞、史凯利格、《石之心》马戏团）：首次击败每个人会从共享的51张牌池中随机获得一张[b]随机卡牌[/b]，绝不会是你已从其他商人处获得的牌。一旦该牌池用尽，剩余商人将给予[b]制作材料[/b]而非卡牌。因此地图上的白色卡牌意味着“尚未击败”，而不一定“有新卡牌给你”。[/] [][b]陶森特玩家[/b]（《血与酒》）：每人给予一张属于自己的[b]固定卡牌[/b]，因此那里每张白色卡牌都是新卡牌。[/] [][b]任务玩家[/b]（血腥男爵、维米·维瓦尔第、斯特凡、奥利维尔、格雷米斯特等）：每人拥有一张独特卡牌；他们的标记会显示你是否已获得。[/] [/list]

[size=4][b]要求[/b][/size]

[list] []《巫师3：狂猎》当前版本：[b]重制版[/b]（也称为次世代版，从补丁4.0开始）。[b]1.0.5及更高版本为游戏补丁5.01构建[/b]；在补丁5.0上使用1.0.4版本。旧的1.32版本[b]不[/b]受支持：脚本使用了1.32没有的注解（[i]@wrapMethod[/i]、[i]@addMethod[/i]、[i]@addField[/i]）。[/] []已在Steam重制版补丁5.01（DX12）上测试。[/] [/list]

[size=4][b]安装[/b][/size]

[list] []下载主文件（[i]GwentPlayersMap.zip[/i]）。[/] []将其解压到你的游戏文件夹（包含[i]bin[/i]和[i]content[/i]的文件夹）。它会添加：[/] [/list]

[code]mods\modGwentPlayersMap\                                        (the mod) bin\config\r4game\user_config_matrix\pc\modGwentPlayersMap.xml  (options menu)[/code]

[list] []启动游戏。脚本将在首次启动时编译。[/] [/list]

不会替换磁盘上的任何游戏文件。选项菜单文件是可选的：没有它，模组将以默认设置运行。

[b]选项菜单没有显示？[/b]某些设置只加载[i]bin\config\r4game\user_config_matrix\pc\dx11filelist.txt[/i]和[i]dx12filelist.txt[/i]中列出的菜单文件。如果你的游戏中有这些文件，请向两者都添加以下行：

[code]modGwentPlayersMap.xml;[/code]

[size=4][b]选项[/b][/size]

[b]选项 > 模组 > 昆特牌玩家地图[/b]（标题为你的游戏语言；安装的版本由[i]调试信息[/i]显示）

[list] [][b]显示昆特牌标记[/b]：开启或关闭地图上的所有卡牌。[/] [][b]显示已击败的玩家[/b]：关闭以仅显示你仍需击败的玩家。[/] [][b]显示谁出售昆特牌[/b]（默认关闭）：其商店也出售昆特牌的玩家，在其标记上会显示[i]“也出售昆特牌。”[/i]，前提是该商店仍有你未拥有的卡牌（它会检查你的昆特牌收藏，因此对进行中的存档也有效）。不显示卡牌名称。[/] [][b]卡牌尺寸[/b]：[i]小[/i]（新安装的默认值）或[i]大（经典）[/i]，即1.0.0-1.0.6的卡牌。从早期版本更新的玩家在更改之前会保留大卡牌。[/] [][b]玩家被标记为已击败时通知[/b]：当一场胜利将玩家标记在地图上时显示通知（默认关闭）。开启后每次都会收到消息。[/] [][b]调试信息[/b]：每次世界地图构建标记时显示一行信息，例如[i]Gwent Players Map 1.0.9: 47 markers on novigrad, map file loaded[/i]（安装的版本在前）。当某些内容未显示时很有用（参见“故障排除”）。[/] [/list]

卡牌位置遵循地图筛选器（自1.0.8起；过去是[i]图标放置[/i]选项）： [list] [][b]昆特牌[/b]筛选器：仅列出卡牌，因此每张卡牌正好位于其玩家所站的位置。[/] [][b]默认[/b]、[b]全部[/b]及其他筛选器：卡牌位于商人商店图标旁边，因此两者都保持可读。[/] [/list]

[size=4][b]工作原理[/b][/size]

[b]玩家在哪里。[/b]昆特牌玩家列表来自[url=https://witcher3map.com]witcher3map.com[/url]的交互式地图（其“Gwent Player”图层）。这些位置被转换为游戏内坐标，然后与游戏自身数据进行核对：每个商人的位置从游戏世界文件中读取并在可用时使用，还添加了交互式地图未列出的少数商人（并移除了少数列出但不打昆特牌的商人）。

[b]谁已被击败。[/b]

[list] [][i]商人[/i]（店主、铁匠、旅店老板……）：首次击败一个时，游戏本身会将其记录在你的存档中。模组读取该记录，因此安装模组前击败的商人也会正确显示。[/] [][i]任务玩家[/i]（例如血腥男爵、维米·维瓦尔第、牛堡的斯特凡、翠鸟酒馆的奥利维尔、十字路口旅店的老板、格雷米斯特）：标记显示“已获得卡牌”或“尚未获得卡牌”，依据其独特卡牌是否在你的物品栏中。[/] []每次击败就在你身边的玩家，模组也会记录。[/] [/list]

[b]地图文件。[/b]卡牌图标和“昆特牌”筛选器位于游戏世界地图文件的修改副本中（[i]panel_worldmap.redswf[/i]，在[i]blob0.bundle[/i]内），基于游戏自身文件构建。

[size=4][b]兼容性[/b][/size]

已针对以下模组进行检查（检查其文件和脚本，而非游戏中的每种组合），以及玩家的报告：

[list] []All Quest Markers Plus：是，在补丁5.01上一起测试过（它挂载了相同的地图函数，但只编辑任务和“？”标记；自定义标记与两者兼容）[/] []Quest Levels on Map：是[/] []Colored Map Markers：是（它更改小地图，而非世界地图）[/] []Missing Gwent Cards Tracker And Trader：是[/] []Gwent Card Notification：是[/] [][url=https://github.com/mateusands/witcher3-witcher-gear-map]Witcher Upgrade Gear Map[/url]：是，使用可选的合并地图文件（WitcherGearMap-GwentPlayersMap-Combined），在补丁5.01上一起测试过。从1.0.8起使用为其制作的合并文件（[i]WitcherGearMap-GwentPlayersMap-Combined-1.0.3[/i]）：旧版本仍可使用，但在[i]昆特牌[/i]筛选器中也会将卡牌保持在商店图标旁边[/] []Witcher's Path：[b]否[/b]：两者都替换[i]panel_worldmap.redswf[/i][/] []Map Quest Objectives：[b]否[/b]：两者都替换[i]panel_worldmap.redswf[/i][/] []True Map POIs：未知：它附带预编译的地图菜单，可能会关闭此模组的地图挂载[/] []Seamless HUDs Maps：是，玩家报告：给Seamless HUDs Maps比此模组[b]更高的优先级[/b]（更低的数字）；卡牌将使用其地图风格[/] []The Stable - Roach-Horse Customization：是，使用rhazzy在[url=https://www.nexusmods.com/witcher3/mods/13834]Witcher 3 Remastered - Patch HUB[/url]中的兼容补丁（两个模组都替换[i]panel_worldmap.redswf[/i]，因此没有它无法一起工作）。查看其页面以获取与此模组和你的游戏补丁匹配的版本[/] [][url=https://www.nexusmods.com/witcher3/mods/13121]Quest Level Markers[/url]：是，使用rhazzy在[url=https://www.nexusmods.com/witcher3/mods/13834]Witcher 3 Remastered - Patch HUB[/url]中的兼容补丁（它也有针对此模组 + The Stable + Quest Level Markers 组合的补丁）[/] [][url=https://www.nexusmods.com/witcher3/mods/13846]World Map Merger[/url]：可以将多个替换[i]panel_worldmap.redswf[/i]的模组合并为一个（目前仅限Vortex）。其作者表示支持昆特牌玩家地图；我本人尚未测试（我在Linux上玩，没有Vortex）。如果你尝试了，请告诉我结果，我会更新此列表[/] [/list]

[list] [][b]昆特牌大改（Gwent Redux及类似）：[/b]标记工作方式相同。安装此模组前击败的商人通过游戏自身的奖励记录检测；如果大改更改了奖励发放方式，这些可能不会显示为已击败，但新的胜利始终会被标记。[/] [][b]脚本挂载：[/b][i]CR4MapMenu.UpdateEntityPins[/i]（将卡牌添加到世界地图）和[i]CR4Player.SetGwintMinigameState[/i]（检测赢得的比赛），均通过[i]@wrapMethod[/i]，另向[i]CR4Game[/i]添加了一个字段和一个方法，并向[i]CR4MapMenu[/i]添加了一个事件（[i]OnGwmMapFilter[/i]，当筛选器更改时由模组的地图文件调用）。不替换任何原版脚本文件，因此不需要Script Merger。[/] [][b]地图模组：[/b]任何替换[i]panel_worldmap.redswf[/i]的模组都与此模组冲突：该文件只能加载一个副本。优先级更高的模组获胜（在你的模组管理器或[i]mods.settings[/i]中数字更小；没有优先级时，排序靠前的文件夹名称获胜）。[b]合并地图和补丁[/b]（World Map Merger、Patch HUB、Witcher Upgrade Gear Map合并文件）携带此模组地图的副本：从1.0.8之前的版本更新后，请重建或更新它们（1.0.9未更改地图）。较旧的合并地图在[i]小[/i]尺寸下仍可工作（使用旧卡牌外观），但[i]大[/i]尺寸需要1.0.7的地图文件，而早于1.0.8的地图文件在所有筛选器中都会将卡牌保持在商店图标旁边，包括[i]昆特牌[/i]筛选器。[/] [/list]

[size=4][b]故障排除[/b][/size]

在选项中开启[b]调试信息[/b]并打开世界地图：

[list] [][b]“…… markers on ……, map file loaded”[/b]：模组正常工作。如果你仍然看不到任何内容，请检查地图筛选器（左下角）和[i]显示昆特牌标记[/i]。[/] [][b]“MAP FILE NOT LOADED”[/b]：标记存在（悬停时显示其工具提示）但卡牌图标缺失。检查[i]mods\modGwentPlayersMap\content\blob0.bundle[/i]和[i]metadata.store[/i]是否已安装。[/] [][b]完全没有消息[/b]：模组的地图脚本未运行。通常是游戏启动时的脚本编译错误，或另一个替换或预编译地图菜单的模组。检查文件是否确切位于[i]<game>\mods\modGwentPlayersMap\content\scripts\local\gwm.ws[/i]（模组管理器有时会添加额外的文件夹层级）。模组管理器还可能留下你已卸载模组的[i].ws[/i]脚本文件；残留脚本可能破坏脚本编译，因此请移除不再使用的模组的任何散落文件。[/] [][b]仍然不工作：[/b]提交问题或评论，附上调试消息、你是如何安装模组的、任何错误消息以及你的其他模组。[/] [/list]

[size=4][b]已知限制[/b][/size]

[list] [][b]并非每个玩家都在地图上。[/b]列表来自交互式地图加上在游戏文件中能匹配到的内容。某些玩家可能缺失，少数标记可能稍微偏离其确切位置。重点是商人、铁匠、旅店老板和其他给你卡牌的固定玩家；一次性任务比赛（锦标赛、剧情场景）不会被标记。[/] [][b]玩家遵循游戏自身的时间表。[/b]标记显示玩家工作的地点。商人通常只在工作时间出现（例如从清晨到傍晚），有些在附近剧情任务进行时会离开，或只打招呼而不开店。这是游戏行为，不是模组的问题：稍后再来（冥想有帮助）或完成该任务后再来。[/] [][b]依赖剧情的玩家：[/b]少数玩家只在你帮助后出现，或在某个任务后不再出现。他们的标记会显示简短、无剧透的注释。当游戏记录某玩家永久消失时，卡牌变为灰色并显示“不再可用。”仅标记游戏文件中确认的情况；对于其他玩家，标记保持原样。[/] [][b]一个铁匠没有游戏记录：[/b]Fyresdal铁匠打昆特牌，但游戏没有击败他的记录。只有在安装模组后击败他时，他才会变灰。[/] [][b]卡池用尽后击败的商人：[/b]一旦共享商人牌池中的所有卡牌被收集，商人将给予制作材料，游戏不保留胜利记录。这些胜利仅在安装模组后击败商人（站在其标记附近）时才会被标记；安装模组前的胜利无法检测。[/] [][b]在昆特牌筛选器之外[/b]卡牌在世界中移动固定距离，因此当地图缩得很远时，卡牌和商店图标仍可能接触。[/] [][b]游戏更新。[/b]模组附带游戏世界地图文件的修改副本，基于特定游戏补丁构建（1.0.5至1.0.9：补丁5.01）。未来更改世界地图的补丁需要模组的新版本；在此之前模组将显示较旧的地图。如果更新后地图表现异常，请卸载模组直到有修复。[/] [][b]测试有限。[/b]在Steam重制版（DX12）上测试，通过Proton在Linux上，巴西葡萄牙语，搭配少量其他模组。请备份你的存档。[/] [/list]

[size=4][b]语言[/b][/size] 自1.0.7起，模组文本支持所有游戏语言（18种），内置于主文件中；无需单独的翻译文件（旧的可选翻译文件不再需要）。巴西葡萄牙语和俄语（由CredereNemo翻译）是经过审校的翻译；其他语言是机器辅助的草稿，非常欢迎在[url=https://github.com/mateusands/witcher3-gwent-players-map]GitHub[/url]上提供更正。缺失的文本将回退到英语。

非常感谢所有翻译过此模组的人：[b]CredereNemo[/b]（俄语，包含在主文件中）、[b]LootGoBrrr[/b]（中文）和[b]MonsieurFrance[/b]（法语）。他们的中文和法语翻译在Nexus上；如果你更喜欢它们而非内置草稿，请在主文件之后安装。

[size=4][b]从旧版本更新[/b][/size] 首先删除旧的[i]mods\modGwentPlayersMap[/i]文件夹，然后安装新版本（或让模组管理器替换文件）。这样不会留下过时的脚本。 更新时不会丢失任何内容：胜利记录存储在你的存档中（游戏自身的记录加上此模组写入的事实，绑定到永不改变的标记编号），你的选项保持你设置的状态。

[size=4][b]卸载[/b][/size]

删除[i]mods\modGwentPlayersMap[/i]和[i]bin\config\r4game\user_config_matrix\pc\modGwentPlayersMap.xml[/i]（以及[i]modGwentPlayersMap.xml;[/i]行，如果你已将其添加到[i]dx11filelist.txt[/i]/[i]dx12filelist.txt[/i]）。

模组仅向你的存档写入少量事实（它自己记录的胜利），移除模组后游戏会忽略这些，因此可以随时卸载。

[size=4][b]更新日志[/b][/size]

[list] [][b]1.0.9[/b]：移除了四张无法被击败的史凯利格卡牌：Kaer Trolde港口店主和Rannvaig鱼贩（游戏中不存在）、Svorlag铁匠（没有昆特牌游戏）和Larvik铁匠（游戏从未记录对他的胜利）。感谢报告这些的玩家。[/] [][b]1.0.8[/b]：卡牌位置遵循地图筛选器：在[i]昆特牌[/i]筛选器中位于玩家所站位置，在[i]默认[/i]、[i]全部[/i]及其他筛选器中位于商店图标旁边。[i]图标放置[/i]选项已移除；如果你使用了[i]替换[/i]，请将地图切换到[i]昆特牌[/i]筛选器以仅查看玩家所站位置的卡牌。新增选项[b]显示谁出售昆特牌[/b]（默认关闭）。修复斯特凡名字的俄语翻译（感谢CredereNemo）。移除了诺维格瑞南部Bits的“店主”卡牌：游戏从不生成该商人（他的时间表指向一个不存在的工作地点），因此无法被击败。选项标题现在已翻译且没有版本号（版本在调试信息行中）；感谢CredereNemo的建议。[/] [][b]1.0.7[/b]：所有游戏语言（18种）内置于主文件（俄语由CredereNemo翻译；添加了乌克兰语；大多数语言是机器辅助草稿）。新增[b]卡牌尺寸[/b]选项：采用游戏图标风格的较小卡牌（新安装的默认值）或经典大卡牌（为更新的玩家保留）。卡牌不再显示在“商人和工匠”下（“昆特牌”筛选器、“全部”和“默认”仍显示它们）。如果你使用合并地图或Witcher Upgrade Gear Map合并文件，也请更新它。[/] [/list]

[size=4][b]AI披露[/b][/size]

此模组是在AI助手（Anthropic的Claude）的帮助下制作的：脚本、数据提取、地图图标和地图筛选器由AI编写，我本人在游戏中测试了模组。这是一个业余项目。

[size=4][b]致谢[/b][/size]

[list] []昆特牌玩家位置：[url=https://witcher3map.com]witcher3map.com[/url] / [url=https://github.com/untamed0/witcher3map]untamed0/witcher3map[/url]及其贡献者。[/] [][url=https://www.nexusmods.com/witcher3/mods/13409]Gwent Card Notification[/url] by funkyblackcat，用作选项菜单、字符串文件和bundle布局的参考。[/] []Witcher's Path，用作向世界地图添加筛选器的参考。[/] [][url=https://github.com/jindrapetrik/jpexs-decompiler]JPEXS Free Flash Decompiler[/url]，用于编辑地图的ActionScript。[/] []翻译：CredereNemo（俄语）、LootGoBrrr（中文）和MonsieurFrance（法语）。[/] []《巫师3》及其所有资产归CD PROJEKT RED所有。[/] [/list]

源码和发布：[url=https://github.com/mateusands/witcher3-gwent-players-map]github.com/mateusands/witcher3-gwent-players-map[/url]

[size=4][b]贡献[/b][/size] 发现昆特牌玩家缺失或标记错误，或想帮助修复或翻译？在[url=https://github.com/mateusands/witcher3-gwent-players-map]GitHub[/url]上提交问题或拉取请求。这里的评论也可以！