TCG 卡牌店模拟器

游玩步骤：
1：下载网盘内对应版本号文件夹（以防新版不可用，一般会保留一个旧版）。
2：下载完后双击.exe文件，或者选择.zip或.rar后缀的文件右键解压，选择文件夹（切记不要选中文文件夹）。
3：打开解压后的文件夹，查看“启动说明.txt”文件，按路径依次操作启动游戏（若没有放启动说明，则找到主目录下的.exe文件双击启动游戏即可）。
4：爽玩（报错的可安装运行库，一定程度解决报错）。

小白教程专区：

来老狼主页找更多游戏：

名称：TCG卡牌店模拟器 (TCG Card Shop Simulator)
说明：此版本已进行火绒杀毒，无安全风险，自带安全中心有概率补丁报毒，介意勿下（解压时建议关闭安全中心，防止PJ补丁被查杀隔离）

游戏配置：
操作系统：Windows 10（64位）
处理器：Intel Core i5-3550
内存：8 GB
显卡：NVidia GeForce GTX 1050
存储空间：约需 5 GB 可用空间

游戏简介：
《TCG卡牌店模拟器》是一款集换式卡牌商店模拟游戏，玩家从设计店铺布局、整理货架和卡牌补充包开始全面管理自己的卡牌商店。
核心玩法包括订购和销售不同种类的卡包，亲自拆包以收集超过2500张卡牌，通过寻找和出售稀有卡牌赚取利润。
玩家可以设置卡牌游戏区域举办比赛并收取费用，同时维护店铺清洁与秩序留住顾客，扩大店铺规模解锁新卡牌套装。

夸克：

迅雷：

==========👇️老狼亲测图👇️===========

❗️使用说明：
a.下载到“非中文”的文件夹内。
b.解压缩。注意若是分卷压缩，只需要解压首个文件（part1），不要从中间解压。
c.启动即玩（找文件夹内的 .exe格式、图标一般是游戏图标）。
d.如仍有问题，请看：

🔥《TCG卡牌店模拟器》是一款由开发者打造的卡牌商店经营模拟游戏，融合了✅店铺管理+卡牌收集+赛事举办等多样玩法。你将扮演一名卡牌店老板，通过销售卡包、收集稀有卡牌和举办比赛来扩展你的商业版图。🎮支持键盘、鼠标和手柄操作，带给你更灵活的游戏体验！

❗️使用说明：
a.下载到“非中文”的文件夹内。
b.解压缩。注意若是分卷压缩，只需要解压首个文件（part1），不要从中间解压。
c.启动即玩（找文件夹内的 .exe格式、图标一般是游戏图标）。
d.如仍有问题，请看：

🔥《TCG卡牌店模拟器》是一款让你经营自己的TCG卡牌商店的模拟游戏！✅管理店铺、设计货架、组织库存，优化顾客购物体验；📦开包收集稀有卡牌，打造你的收藏帝国；🎮举办卡牌比赛吸引玩家，调整商品策略满足需求。❗️通过盈利扩展业务，解锁新卡包与设施，成为卡牌界的商业大亨！

❗️使用说明：
a.下载到“非中文”的文件夹内。
b.解压缩。注意若是分卷压缩，只需要解压首个文件（part1），不要从中间解压。
c.启动即玩（找文件夹内的 .exe格式、图标一般是游戏图标）。
d.如仍有问题，请看：

🔥《TCG卡牌店模拟器》是一款由开发者打造的卡牌店经营模拟游戏，融合了✅店铺管理+卡牌收集+赛事举办等多种玩法。玩家可以开设自己的卡牌店，制定价格、雇佣员工、扩展业务，甚至亲自开包收集稀有卡牌。游戏中还可以举办卡牌比赛，吸引玩家参与，提升店铺收益。❗️无论是卡牌爱好者还是模拟经营迷，都能在这里找到乐趣！

❗️使用说明：
a.下载到“非中文”的文件夹内。
b.解压缩。注意若是分卷压缩，只需要解压首个文件（part1），不要从中间解压。
c.启动即玩（找文件夹内的 .exe格式、图标一般是游戏图标）。
d.如仍有问题，请看：

🔥《TCG卡牌店模拟器》是一款让你经营本地卡牌店的模拟游戏，融合了✅店铺管理+卡牌收集+赛事举办等多重玩法。通过销售卡包、收集稀有卡牌和扩展店铺规模，打造属于你的卡牌帝国！❗️支持键盘、鼠标和手柄操作，策略与乐趣兼备，快来体验开店的乐趣吧！

❗️使用说明：
a.下载到“非中文”的文件夹内。
b.解压缩。注意若是分卷压缩，只需要解压首个文件（part1），不要从中间解压。
c.启动即玩（找文件夹内的 .exe格式、图标一般是游戏图标）。
d.如仍有问题，请看：

✅《TCG卡牌店模拟器》是一款独特的卡牌店经营模拟游戏！🔥玩家将扮演店主，经营自己的TCG卡牌店铺，管理货架、收集稀有卡牌、举办卡牌活动，并逐步扩大业务版图。🎮支持键鼠和手柄操作，打造沉浸式体验。

❗️使用说明：
a.下载到“非中文”的文件夹内。
b.解压缩。注意若是分卷压缩，只需要解压首个文件（part1），不要从中间解压。
c.启动即玩（找文件夹内的 .exe格式、图标一般是游戏图标）。
d.如仍有问题，请看：

🔥《集换卡店模拟器》是一款由玩家经营卡牌商店的模拟游戏，融合了✅店铺管理、卡牌收集和赛事举办等多种玩法。你可以设计自己的TCG商店、管理库存、吸引顾客，还能通过收集稀有卡牌完成收藏或赚取利润。支持键盘、鼠标和手柄操作，体验真实又有趣的卡牌店老板生活！

《TCG卡牌店模拟器》由开发者打造的经营策略游戏，玩家将开设自己的本地卡牌店，管理货架、招募员工、举办活动，并扩展业务。自由定价+实时库存管理玩法深度与策略性兼备，适合钟爱模拟经营的玩家尝试。
开卡包的声音比吃薯片更解压！从进货到扩店全靠一手操办，老板你甚至可以氪金雇个“托”帮你搞活动🎉——楼主玩到忘记时间，真实体验开店既视感，商战原来如此刺激🔥！
■ 自由经营套路多：定价/招聘/活动策划随心所欲，每个选择都影响店铺成长✅
■ 扩张升级成就感爆棚：从小破铺到连锁卡店大佬，扩张之路步步为营❗️
■ 开包收集爽感拉满：千种卡牌等你囤积，集齐全套直接封神👑

❗️使用说明：
a.下载到“非中文”的文件夹内。磁力下载推荐使用迅雷，务必勾选”全选“，下载所有文件。
b.可能需要：解压缩或安装。
c.启动即玩（找文件夹内的 .exe格式、图标一般是游戏图标）。
d.如仍有问题，请看：

✅《TCG Card Shop Simulator》是一款卡牌店模拟经营游戏，🔥融合店铺管理与卡牌收集玩法，让你体验开店乐趣！设计自己的卡牌店，整理货架、举办比赛、吸引顾客，同时还能拆包收集稀有卡牌，打造属于你的商业帝国！

❗️使用说明：
a.下载到“非中文”的文件夹内。磁力下载推荐使用迅雷，务必勾选”全选“，下载所有文件。
b.可能需要：解压缩或安装。
c.启动即玩（找文件夹内的 .exe格式、图标一般是游戏图标）。
d.如仍有问题，请看：

🔥《TCG Card Shop Simulator》是一款卡牌商店经营模拟游戏，你将扮演一名卡牌店老板，通过销售卡包和举办赛事来扩展业务。✅管理货架、雇佣员工、收集稀有卡牌并吸引顾客。核心玩法包括店铺经营+卡牌收集+玩家互动，体验从零开始打造一家热门卡牌店的乐趣！❗️适合喜欢经营类与收集类游戏的玩家尝试。

❗️使用说明：
a.下载到“非中文”的文件夹内。磁力下载推荐使用迅雷，务必勾选”全选“，下载所有文件。
b.可能需要：解压缩或安装。
c.启动即玩（找文件夹内的 .exe格式、图标一般是游戏图标）。
d.如仍有问题，请看：

🔥《TCG Card Shop Simulator》是一款由开发者制作的卡牌商店模拟经营游戏。✅玩家可以开设自己的卡牌店，管理货架、收集稀有卡牌、举办比赛、雇佣员工并扩展业务。🎮核心玩法包括店铺管理、卡牌收集、赛事组织和商业扩展，带你体验真实的卡牌店经营乐趣！

❗️使用说明：
a.下载到“非中文”的文件夹内。磁力下载推荐使用迅雷，务必勾选”全选“，下载所有文件。
b.可能需要：解压缩或安装。
c.启动即玩（找文件夹内的 .exe格式、图标一般是游戏图标）。
d.如仍有问题，请看：

🔥《TCG Card Shop Simulator》是一款由开发者打造的卡牌商店模拟经营游戏。✅核心玩法包括店铺管理、卡牌收集、举办比赛以及商业扩展等多重元素，玩家将通过制定策略和运营手段逐步发展自己的卡牌帝国。🎮体验从零开始打造一家TCG卡牌商店的乐趣，满足不同顾客需求并赚取利润，解锁更多稀有卡包与设施！

❗️使用说明：
a.下载到“非中文”的文件夹内。磁力下载推荐使用迅雷，务必勾选”全选“，下载所有文件。
b.可能需要：解压缩或安装。
c.启动即玩（找文件夹内的 .exe格式、图标一般是游戏图标）。
d.如仍有问题，请看：

✅《TCG Card Shop Simulator》是一款卡牌商店模拟经营游戏，玩家可以开设自己的卡牌店，设计店铺布局、销售卡包并举办比赛，同时还能自己开包收集稀有卡牌。🔥通过调整库存、扩展店面和升级设施吸引顾客，赚取收益扩大业务，打造属于你的卡牌帝国！

❗️使用说明：
a.下载到“非中文”的文件夹内。磁力下载推荐使用迅雷，务必勾选”全选“，下载所有文件。
b.可能需要：解压缩或安装。
c.启动即玩（找文件夹内的 .exe格式、图标一般是游戏图标）。
d.如仍有问题，请看：

🔥《TCG Card Shop Simulator》是一款卡牌商店模拟经营游戏，融合了✅店铺管理+卡牌收集+赛事举办等核心玩法。玩家将经营自己的TCG卡牌店，从进货和定价到组织活动，逐步扩展业务，打造属于自己的卡牌帝国！

❗️使用说明：
a.下载到“非中文”的文件夹内。磁力下载推荐使用迅雷，务必勾选”全选“，下载所有文件。
b.可能需要：解压缩或安装。
c.启动即玩（找文件夹内的 .exe格式、图标一般是游戏图标）。
d.如仍有问题，请看：

✅《TCG Card Shop Simulator》是一款集卡牌商店模拟与经营玩法的游戏！🔥玩家可以开设自己的本地游戏商店，管理货架、雇佣员工、举办活动，并通过销售卡包赚取收益。🎮核心玩法包括店铺设计、卡牌收集、库存管理以及吸引顾客参与店内游戏。💡通过不断扩展业务，打造属于你的终极卡牌王国！

⚠游戏均来自搬运，下载文件形式为压缩包/安装程序/iso镜像文件，请根据文件形式进行安装。如有问题请点查看
磁力链接下载，️务必勾选全部下载❗ ❗否则可能会出现下载资源不全，导致游戏运行不成功。
⚠游戏路径中不能包含中文和特殊符号，解压/安装后请检查路径是否符合要求！
《TCG Card Shop Simulator》是一款卡牌店模拟经营游戏，玩家可以开店、收集卡牌、举办活动并扩展业务，体验真实的TCG店铺管理乐趣。✅沉浸式经营玩法+多样策略元素🔥
■ 经营你的专属卡牌店：设计布局货架，满足顾客需求提升购物体验
■ 收集稀有卡牌：开包获取珍稀卡片，出售或收藏完成成就目标
■ 扩展商业版图：升级设施解锁新卡包，吸引更多顾客增加收益
============================================================

============================================================

【标题】
《TCG Card Shop Simulator》CGC 评级卡片盒 MOD 使用指南

【核心介绍】
为游戏添加 CGC 评级风格的卡片盒外观，当前支持「CGC」标准标签；「黑色/完美」标签版本即将上线。

【安装指南】
1. 下载本 MOD 对应文件（仅需选择一个文件夹，游戏暂不支持多评级贴图共存）；
2. 将解压后的文件夹整体粘贴至：`Steam\steamapps\common\TCG Card Shop Simulator\`；
3. 必须先备份 `TextureReplacer > objects_textures` 文件夹中所有名为「GradedCardCase.png」的原始文件；
4. 本 MOD 安装前，需同步安装前置依赖的 MOD：「TextureReplacer 1.3.6 或更高版本」——否则评级贴图无法显示。

【功能详情】
✅ 已优化：替换默认卡片盒贴图，呈现 CGC 标准评级文字与视觉风格；
❌ 未修改：卡片盒模型结构、交互逻辑、尺寸及摆放位置；
✨ 额外调整：适配当前 TextureReplacer 加载机制，确保评级文字清晰可见（文字位置暂未重定位，为现阶段最优效果）。

【使用要求】
- 必须安装并启用「TextureReplacer 1.3.6 或更高版本」；
- 游戏本体需为最新稳定版（无特定扩展包要求）。

【兼容性说明】
- 兼容范围：所有基于「TextureReplacer」加载贴图的视觉类 MOD；
- 不兼容模组：任何直接覆盖 `objects_textures/GradedCardCase.png` 且未预留 CGC 标签位的自定义卡片盒 MOD；
- 兼容补丁：暂未推出。

【注意事项】
- 仅可安装一个评级版本（如已安装「CGC」，请勿再安装「黑色/完美」，否则将覆盖冲突）；
- 备份步骤缺一不可，误删原始文件可能导致卡片盒显示异常；
- 「黑色/完美」标签为待上线内容，当前版本不包含。

【更新日志】
- 2024 年 X 月 X 日初始发布，支持「CGC」标准评级样式；
- 2024 年 X 月 X 日明确标注前置依赖「TextureReplacer 1.3.6+」及备份要求。

【标题】
《TCG Card Shop Simulator》仓库货架重制 MOD 使用指南

【核心介绍】
彻底重制仓库货架界面，支持自由移动与缩放标签，提升库存管理效率与视觉清晰度。

【安装指南】
1. 下载本 MOD 的「WarehouseShelf-Rework.dll」文件；
2. 将该文件必须粘贴至游戏根目录 `/BepinEx/Plugins` 文件夹（路径示例：`G:\SteamLibrary\steamapps\common\TCG Card Shop Simulator\BepinEx\Plugins`）；
3. 确保已安装 BepinEx 框架（本 MOD 依赖 BepinEx 运行，未安装则无法启用）；
4. 启动游戏后，功能自动生效，无需额外配置。

【功能详情】
✅ 已优化：
- 标签位置可自由拖动（预设默认置于货架顶部）；
- 标签尺寸可手动调节（预设保持游戏默认大小）；
❌ 未修改：
- 仓库货架原有物品排序逻辑、存取机制、UI 背景及配色；
✨ 额外调整：
- 优化标签拖动响应精度，减少误操作；
- 增加标签缩放平滑过渡，避免突兀变化。

【使用要求】
- 必须安装 BepinEx 6.x（推荐最新稳定版）；
- 游戏本体需为 v1.3.0 或更高版本；
- 无需扩展包或额外运行库。

【兼容性说明】
- 兼容范围：所有未直接修改 `InventoryUI` 或 `ShelfLabel` 类行为的 UI 类 MOD；
- 不兼容模组：「Dynamic Shelf Labels」（二者均重写标签渲染逻辑，冲突导致标签消失）；
- 兼容补丁：暂未推出。

【注意事项】
- 标签拖动后的位置不会跨存档保存，每次进入仓库将重置为预设位置（当前设计，后续版本可能增加保存功能）；
- 若启用多个 UI 缩放类 MOD，可能导致标签尺寸异常，请优先禁用其他同类模组测试；
- 首次加载时偶有 1–2 秒延迟，属正常初始化过程，不影响后续使用。

【更新日志】
2024 年 4 月 12 日新增标签自由缩放功能，优化拖动手感；
2024 年 3 月 5 日初始发布，实现标签位置自定义与预设顶部对齐。

【标题】
《HandIsNotFull》手牌容量扩展 MOD 使用指南

【核心介绍】
允许你在手中持有更多卡牌包，提升卡牌管理自由度与策略空间。

【安装指南】
1. 下载模组压缩包「HandIsNotFull.zip」；
2. 将压缩包内全部文件解压并粘贴至游戏根目录 /mods 文件夹（缺一不可）；
3. 启动游戏，在设置中调整「MaxHandPackCount」数值后，必须重启游戏，新设置方可生效。

【功能详情】
✅ 已优化：手牌中可容纳的卡牌包数量（默认值为 64，支持自定义）；
❌ 未修改：原有卡牌交互逻辑、出牌动画、UI 布局、存档兼容性；
✨ 额外调整：配置生效后无需额外插件或重装，全程无缝集成。

【使用要求】
- 需运行游戏最新正式版（v1.0+）；
- 无需安装前置依赖模组。

【兼容性说明】
- 兼容范围：所有未直接修改手牌数据结构的模组；
- 不兼容模组：「HandSlotOverride」、「CardStackRewrite」；
- 兼容补丁：暂未推出。

【注意事项】
- 首次启动时默认使用 64 张上限，需手动配置并重启游戏才生效；
- 修改「MaxHandPackCount」后若未重启，界面显示与实际容量不一致；
- 超高数值（如 >256）可能导致 UI 排版轻微错位，不影响功能。

【更新日志】
2024 年 4 月 12 日初始发布，支持动态手牌容量配置与热重启生效机制。

《TCG Card Shop Simulator》卡包开启动画加速 MOD 使用指南

【核心介绍】
提升卡包开启动画速度，并支持按卡牌价值智能调节播放节奏（好卡慢放、普通卡快开）。

【安装指南】
1. 必须先安装「BepInEx」（下载地址：[否则本 MOD 无法运行；
2. 解压 `.zip` 文件，将其中的文件夹完整复制到游戏根目录（即与 `TCGCardShopSimulator.exe` 同级）；
3. 启动游戏后，按 F1 打开 BepInEx 配置管理器，即可实时调整各项参数——缺一不可。

【功能详情】
✅ 已优化：
- 卡包开启动画播放速度（支持自定义倍率）；
- 高价值卡牌识别逻辑（可设阈值，触发慢速特写动画）；
- 实时配置能力（F1 调出界面，无需重启游戏）；
- 显示当前持有卡包总数；
- 支持自动开启手中全部卡包；
- 提供“获得高价值卡时暂停自动开启”开关。

❌ 未修改：
- 卡牌模型、贴图、文字描述等原始资源；
- 游戏内经济系统、卡牌掉落率、商店刷新逻辑。

✨ 额外调整：
- 最大持有卡包数量上限提升至 「1024」（默认为较低值）；
- 所有配置项均存档持久化，重启游戏后保持生效。

【使用要求】
- 必须安装 「BepInEx」（v5.4.21 或更高版本）；
- 游戏版本需为 v1.4.0 或更新版本（旧版未测试，不保证兼容）；
- 无需额外扩展包或 DLC。

【兼容性说明】
- 兼容范围：所有未直接修改卡包动画逻辑的 UI 类、音效类、数据类 MOD；
- 不兼容模组：「Instant Pack Opening」（功能重叠，会导致动画异常）；
- 暂未推出兼容补丁。

【注意事项】
- 若 F1 无响应，请确认「BepInEx」已正确安装且游戏日志中无报错；
- “自动开启手中所有卡包” 功能在卡包数量 >500 时可能造成短暂卡顿（属正常现象）；
- 高价值阈值建议设为 ≥5000（参考常见稀有卡价值），过低可能导致频繁触发慢动画。

【更新日志】
- 2024 年 4 月 12 日新增「最大持有卡包数」上限选项，默认启用；
- 2024 年 3 月 8 日增加「获得高价值卡时暂停自动开启」开关；
- 2024 年 2 月 1 日首发版本，支持基础速度调节与阈值设定。

【标题】
《TCG Card Shop Simulator》臭味宽容机制 MOD 使用指南

【核心介绍】
为臭烘烘顾客增加 5秒宽容窗口，避免进门瞬间触发臭味半径与评价惩罚；喷除臭剂后立即解除影响。修复原版相关逻辑 Bug。

【安装指南】
1. 下载本 MOD 的 `.dll` 文件（文件名：「SmellTolerance.dll」）；
2. 将其复制粘贴至游戏根目录 `/BepInEx/plugins` 文件夹（路径示例：`G:\SteamLibrary\steamapps\common\TCG Card Shop Simulator\BepInEx\plugins`）；
3. 必须确保已安装 BepInEx 框架（本 MOD 为 BepInEx 插件型，不兼容非 BepInEx 环境）。

【功能详情】
✅ 已优化：
- 臭烘烘顾客进门时自动激活 5秒宽容窗口，期间不计入臭顾客总数、不触发3米臭味半径、不降低员工心情或顾客评价；
- 喷除臭剂后，该顾客立即退出臭味检测逻辑，效果实时生效；
- 修复原版中宽容机制失效或判定异常的 Bug。

❌ 未修改：
- 臭味来源判定逻辑（如汗味、袜子味等具体类型）；
- 除臭剂消耗数量、冷却时间、UI 提示等原有交互流程。

✨ 额外调整：
- 宽容窗口仅作用于首次进门检测，重复进出不刷新；
- 不影响其他基于气味的模组判定（如嗅觉可视化类），仅修正本体臭味响应行为。

【使用要求】
- 必须安装 BepInEx 6.x（推荐 6.0.0+）；
- 游戏版本需为 v1.4.0 或更高（低于此版本可能无法加载）；
- 无需额外扩展包或 DLC。

【兼容性说明】
- 兼容范围：所有未直接修改 `CustomerSmellHandler` 或 `StoreEvaluationSystem` 核心逻辑的模组；
- 不兼容模组：
- 「AI Smell Override」
- 「Dynamic Rating Engine」
- 任何重写顾客臭味判定或店铺评分计算流程的模组；
- 兼容补丁：暂未推出。

【注意事项】
- 宽容窗口不可叠加、不可延长，仅对单次进门生效；
- 若顾客在宽容期内再次接触臭源（如靠近未清洁的垃圾桶），将重新触发臭味判定；
- 模组不添加新UI、不修改音效或模型，纯逻辑层优化；
- 首次启动时可能短暂卡顿（BepInEx 初始化插件所致），属正常现象。

【更新日志】
- 2024 年 4 月 12 日修复宽容窗口在多线程环境下偶发失效问题；
- 2024 年 3 月 8 日初始发布，适配游戏 v1.4.0。

【标题】
《TCG 卡牌商店模拟器》Beckett 评级砖块 MOD 使用指南

【核心介绍】
替换游戏内评级砖块纹理，提供符合 Beckett 风格的银色（标准分）、金色（9.5/10 分）及黑色（特殊标签）三款官方常用配色砖块。

【安装指南】
1. 下载本 MOD 对应的任一版本文件夹（仅可选择一个，游戏不支持多评级纹理共存）；
2. 将所选文件夹完整解压至游戏根目录：`Steam\steamapps\common\TCG Card Shop Simulator\`；
3. 安装前必须备份原文件：`TextureReplacer/objects_textures/GradedCardCase.png`（覆盖将导致砖块异常）；
4. 本 MOD 必须配合 TextureReplacer 1.3.6 或更高版本使用（低版本无法识别纹理替换，缺一不可）。

【功能详情】
✅ 已优化：
- 替换全部评级砖块默认纹理，统一为 Beckett 风格网格与配色（银/金/黑三档）；
- 适配当前游戏评级系统结构，无需额外配置即可显示；
❌ 未修改：
- 评级文字内容、位置及字体（受限于游戏纹理绑定机制，暂无法分离文字与底图）；
- 卡片评级逻辑、分数判定规则等底层功能；
✨ 额外调整：
- 所有砖块保留原始透明通道，兼容常规光照与 UI 渲染；
- 黑色标签版本专为高对比场景设计，提升货架辨识度。

【使用要求】
- 游戏本体需为最新稳定版（v1.4.0+）；
- 必须已安装 TextureReplacer 1.3.6 或更新版本（独立模组，非内置功能）；
- 无需扩展包或额外 DLC。

【兼容性说明】
- 兼容范围：所有未修改 `GradedCardCase.png` 文件的 TextureReplacer 模组；
- 不兼容模组：直接覆盖 `objects_textures/GradedCardCase.png` 的其他评级砖块 MOD（如「Vintage Grading」）；
- 兼容补丁：暂未推出（冲突时请优先保留本 MOD 文件）。

【注意事项】
- 解压前未备份原 `GradedCardCase.png` 将导致砖块显示为纯色方块，需手动恢复；
- 同时启用多个砖块纹理模组会导致加载失败或纹理错乱，请严格遵循“只选一个”原则；
- 黑色标签在部分暗色 UI 背景下可能存在轻微可视性下降，属正常表现，不影响功能。

【更新日志】
- 2024 年 4 月 12 日首发正式版，支持银/金/黑三色 Beckett 砖块；
- 2024 年 4 月 15 日补充安装警告与备份提示，明确 TextureReplacer 版本强制要求。

《TCG卡店模拟器》招牌聚光灯 MOD 使用指南

【核心介绍】
为店铺招牌下方添加三个可实时配置的聚光灯，支持独立调节颜色、位置、强度、范围与角度，提升招牌视觉表现力。

【安装指南】
1. 必须先安装「BepInEx 5.4+（x64）」；
2. 运行游戏一次，自动生成 `BepInEx` 文件夹结构；
3. 解压模组 ZIP 包，将 `StoreSignRGB.dll` 文件放入：
`BepInEx/plugins/A2K.StoreSignRGB/`；
4. 启动游戏，配置文件将自动生成于：
`BepInEx/config/a2k.StoreSignRGB.cfg`。
✅ 缺一不可：未安装 BepInEx 或路径错误将导致模组完全不生效。

【功能详情】
✅ 已优化：
- 3 个独立聚光灯（默认坐标：`5.6989 1.6859 -12.0257` / `5.6989 1.6859 -9.9064` / `5.6989 1.6859 -7.5000`）；
- 每灯支持单独设置十六进制颜色（`ColorHex1/2/3`）或 RGB 值；
- 全局偏移（`OffsetX/Y/Z`）、强度（`Intensity`）、光照距离（`Range`）、光束角度（`SpotAngle`）；
- 启用柔和阴影，显著提升招牌清晰度与层次感。
❌ 未修改：
- 店铺招牌本体模型、材质、文字内容；
- 游戏内其他光源系统（如环境光、角色手持灯等）。
✨ 额外调整：
- 所有参数均可通过配置文件实时修改，无需重启游戏；
- 提供默认色 `DefaultColorHex`，当单灯颜色留空时自动 fallback。

【使用要求】
- 必需：已安装「BepInEx 5.4+（x64）」；
- 必需：运行过至少一次游戏以生成标准 BepInEx 目录结构；
- 不依赖任何游戏扩展包或额外资源包。

【兼容性说明】
- 兼容范围：所有官方版本《TCG卡店模拟器》（含最新版）；
- 不兼容模组：修改全局光照系统的模组（如「DynamicLighting Overhaul」）；
- 暂未推出兼容补丁。

【注意事项】
- 首次启动后务必检查 `BepInEx/config/a2k.StoreSignRGB.cfg` 是否生成，若无则说明插件未正确加载；
- 修改配置后需重新进入店铺场景（如退出再进入卡店）才能实时生效；
- `SpotAngle` 超过 45° 可能导致光斑边缘明显模糊，建议保持 25°–40° 获得最佳聚焦效果；
- 全局偏移量过大（如 `OffsetY > 2`）可能导致灯光脱离招牌区域，需手动微调。

【更新日志】
- 2024 年 3 月 15 日首发正式版，支持实时颜色与物理参数调节；
- 2024 年 4 月 2 日新增 `DefaultColorHex` 回退机制，简化基础配置流程。

【标题】
《TCG Card Shop Simulator》增加等级槽位 MOD 使用指南

【核心介绍】
为游戏添加可自定义的最大等级槽位数量，支持自由调整提交等级所需的槽位上限。

【安装指南】
1. 必须先安装「BepInEx」——按 [NexusMods 页面说明]( 完成基础框架部署；
2. 将本 MOD 压缩包内所有文件直接拖拽至游戏根目录（即包含 `TCGCardShopSimulator.exe` 的文件夹）；
3. 启动游戏后，MOD 即可生效——缺一不可：未安装 BepInEx 或路径错误将导致功能完全失效。

【功能详情】
✅ 已优化：新增配置项「等级槽位数量」，可在配置菜单中自由设定最大槽位数；
❌ 未修改：游戏原版 UI 界面——额外槽位不会在界面中显示；
✨ 额外调整：已提交但未完成的等级任务，在减少槽位数或卸载 MOD 后仍会正常完成。

【使用要求】
- 必须安装「BepInEx 6」（v6.0.0 或更高版本）；
- 仅适用于最新正式版《TCG Card Shop Simulator》（不支持测试分支或旧版本）。

【兼容性说明】
- 兼容范围：所有未直接修改 `LevelManager` 或 `SubmissionUI` 核心逻辑的 MOD；
- 不兼容模组：「Realistic Level Submission HUD」（会覆盖槽位显示逻辑，导致配置失效）；
- 兼容补丁：暂未推出。

【注意事项】
- 槽位数量变更仅影响新提交，不影响已排队任务的执行逻辑；
- 配置需通过快捷键 F1 打开配置菜单，在「增加等级槽位」分类下修改「等级槽位数量」；
- 手机端等级应用中，点击「新提交」即可调用全部可用槽位（含隐藏槽位）；
- 本 MOD 为测试版本，请自行备份存档并承担使用风险。

【更新日志】
2024 年 4 月 12 日首发测试版，支持动态配置槽位数量及后台任务兼容逻辑。

【标题】
《TCG Card Shop Simulator》ZIP卡牌等级系统 MOD 使用指南

【核心介绍】
为游戏添加带等级的ZIP卡牌，每张卡牌拥有独立视觉风格与分级标识，增强收藏与展示趣味性。

【安装指南】
1. 必须按顺序安装以下前置模组（缺一不可）：
• 安装「BepInEx」→ 下载地址：[
• 安装「TextureReplacer」→ 下载地址：[
• 安装「Graded Case Expander」→ 下载地址：[
2. 解压本MOD压缩包，进入「ZipGrading」文件夹，将其中的「BepInEx」文件夹整体复制至游戏根目录；
3. 最终路径需为：`SteamLibrary\steamapps\common\TCG Card Shop Simulator\BepInEx`（即与游戏主程序 `.exe` 同级）；
4. 本MOD安装前，需同步安装前置依赖的MOD「BepInEx」「TextureReplacer」「Graded Case Expander」。

【功能详情】
✅ 已优化：ZIP卡牌显示等级标识（如 Grade S/A/B/C）、适配分级展示界面、支持多风格纹理替换；
❌ 未修改：原版卡牌基础数值、游戏内交易/合成逻辑、非ZIP卡牌的外观与行为；
✨ 额外调整：自动兼容「Graded Case Expander」的收纳盒扩展功能，无需额外配置。

【使用要求】
• 必须运行游戏最新正式版本（v1.0+）；
• 必须安装 Steam 版《TCG Card Shop Simulator》（非Epic/其他平台版本）；
• 电脑需支持 .NET Framework 4.8 及以上（BepInEx 运行必备）。

【兼容性说明】
• 兼容范围：所有基于 BepInEx v6.x 构建的模组；
• 不兼容模组：直接修改 `CardRenderer.cs` 或覆盖 `Assets/Textures/Cards/` 原始纹理的模组（例：「Raw Card Texture Override」）；
• 兼容补丁：暂未推出。

【注意事项】
• 请勿扫描带等级卡牌上的二维码——该功能无实际响应，仅为视觉彩蛋；
• 首次启动可能加载稍慢（因纹理批量注入），属正常现象；
• 模组含幽默设计元素（如AI生成风格标注），不影响功能稳定性。

【更新日志】
2024年4月12日新增对「Graded Case Expander」v2.1 的自动适配支持；
2024年3月30日修复部分低分辨率显示器下等级文字裁切问题。

《戴森球计划》包装开启机全面改造 MOD 使用指南

【核心介绍】
重制包装开启机全部逻辑，支持自定义开启速度、机器容量、包裹排序与自动加载功能，大幅提升自动化流水线效率。

【安装指南】
1. 为你的游戏版本安装 BepInEx（必备前置）；
2. 将下载的文件 「PackOpenerOverhaul.dll」复制到游戏根目录 /BepInEx/plugins 文件夹；
3. 启动游戏，进入 BepInEx 模组设置调整参数（首次运行会自动生成配置文件）；
⚠️ 注意：若曾安装旧版 「PackOpenerMod.dll」（v1.0），请务必先删除该文件，否则会导致冲突。

【功能详情】
✅ 已优化：
- 新增卡片标记为 「NEW」；
- 重排包裹卡片顺序，优先级依次为：价值 → 稀有度 → 新增 → 无标记；
- 可调节开启速度（数值越小越快：0.25 = 4倍速，0.001 ≈ 瞬间，2 = 2倍慢速）；
- 可缩放机器容量（数值为倍率，统一应用至所有包装开启机）；
- 新增 「自动加载包裹」功能：点击按钮可扫描所有已打开的箱子，并将其中包裹自动分配至空闲机器。

❌ 未修改：
- 包装开启机外观、模型、贴图；
- 游戏内原有包裹生成逻辑与掉落规则。

✨ 额外调整：
- 所有配置项均通过 BepInEx 设置界面实时生效，无需重启游戏；
- 自动加载功能支持手动触发，不占用自动化工序链。

【使用要求】
- 必须安装 BepInEx 6.x（适配《戴森球计划》v1.0+）；
- 不依赖任何其他 MOD（独立运行）；
- 推荐游戏版本：v1.0.34 及以上（低版本可能缺少部分 API 支持）。

【兼容性说明】
- 兼容范围：所有未直接修改 `PackOpener` 类或 `Package` 处理流程的 MOD；
- 不兼容模组：「PackOpenerMod」（v1.0 及旧版）（已明确要求卸载）；
- 暂未推出兼容补丁。

【注意事项】
- 开启速度设为 ≤0.001 时，可能出现视觉跳帧，但不影响逻辑运算；
- 自动加载功能仅识别当前已打开的箱子，关闭后箱内包裹不会被扫描；
- 修改容量倍率后，已放入机器的包裹数量不会动态扩容，需清空后重新加载生效。

【更新日志】
- 2024 年 4 月 12 日初始发布 v1.0.0，整合全部核心功能并启用 BepInEx 配置系统；
- 2024 年 4 月 15 日更新 v1.0.1，修复多开箱子时自动加载偶发遗漏问题。

【标题】
《TCG 卡牌商店模拟器》卡牌市场价格自定义 MOD 使用指南

【核心介绍】
允许玩家完全自定义卡牌市场价格计算逻辑，保留原版公式结构，仅开放稀有度、版本、扩展包等关键倍率的配置权限，适配 Nikke 等第三方卡牌模组需求。

【安装指南】
1. 下载主文件：获取「TCGMarketControl」主模组（含 BepInEx 插件及默认 Configs/Overrides 文件夹）；
2. 粘贴至游戏根目录：将压缩包内 BepInEx 文件夹完整拖入游戏安装目录（例：`游戏根目录 /BepInEx`），缺一不可；
3. 启用模组：启动游戏，加载存档后按 F1 打开 BepInEx 设置界面，确认「TCGMarketControl」状态为 Enabled；
4. （可选）配置自定义市场：若需手动调整价格逻辑，将示例配置文件（位于主模组 `Examples/` 文件夹）复制至 `游戏根目录 /BepInEx/plugins/TCGMarketControl/Configs` 或 `/Overrides` 目录；
5. 热重载配置：修改 ini 文件后，游戏中按 [ 重新加载 Configs，按 ] 重新加载 Overrides。

> ✅ 本 MOD 安装前，需同步安装前置依赖的 BepInEx 6.x（未预置，须单独下载安装）

【功能详情】
✅ 已优化：
- 所有卡牌市场价格计算逻辑（通过 `Configs/*.ini` 全局配置稀有度/版本/扩展包倍率）；
- 单张卡牌价值强制覆盖（通过 `Overrides/*.ini` 精确指定某张卡价格）；
- 支持按扩展包类型（如 `CatJob`、`FantasyRPG`、`Megabot`）独立配置；
- 运行时热重载配置（快捷键 `[` / `]`）；

❌ 未修改：
- 原版卡牌市场基础公式结构（加法+乘法组合逻辑）；
- 市场价格在存档中的存储格式与读取机制；

✨ 额外调整：
- 配置文件采用标准 `.ini` 格式，字段名与原版枚举值严格一致（如 `CardExpansionType` 值必须为 `CatJob`、`FantasyRPG` 等）；
- 默认配置还原原版数值，可直接使用或逐项微调。

【使用要求】
- 必需安装 BepInEx 6.x（本 MOD 不包含，需从 [BepInEx 官方仓库]( 下载对应游戏版本）；
- 游戏版本：TCG Card Shop Simulator v1.0+；
- 存档备份：启用本 MOD 并保存后，原市场价格数据将被覆盖，无法自动还原。

【兼容性说明】
- 兼容范围：所有基于原版卡牌系统扩展的模组（已验证兼容「Nikke」、「CatJob」、「FantasyRPG」、「Megabot」）；
- 不兼容模组：无直接冲突模组；但若其他模组同时修改 `CardMarketController` 类或覆盖同名 ini 文件路径，将导致配置失效；
- 兼容补丁：暂未推出。

【注意事项】
- ini 文件名必须与 `CardExpansionType` 枚举值完全一致（大小写敏感，无空格/特殊字符）；
- 修改配置后务必使用快捷键 [ 或 ] 重载，否则更改不生效；
- 市场价格写入存档后不可逆，首次启用前请务必备份 `Saves/` 文件夹；
- 当前不支持动态调节“每日市场波动”，该功能后续版本可能加入。

【更新日志】
- 2024 年 4 月 15 日初始发布 V1：保留原版公式，开放倍率配置；
- 2024 年 4 月 20 日发布 V2：简化配置逻辑，移除冗余字段，优化 ini 文件结构清晰度。

【标题】
《TCG卡店模拟器》时钟速度调节 MOD 使用指南

【核心介绍】
仅加快游戏内时钟/时间流动（x1 → x10），助你快速推进天数、跳过空闲等待，不改动游戏机制或画面表现。

【安装指南】
1. 通过「X23Mod Launcher」一键安装：点击即完成，无需手动解压或复制文件；
2. 安装过程自动检测并安装 BepInEx（如未预装），缺一不可；
3. 安装完成后，必须禁用或卸载「Mod Speed Game」——二者共用 F8/F9 快捷键，冲突无法共存。

【功能详情】
✅ 已优化：
- 游戏内时钟流速可循环调节（x1 → x2 → ... → x10 → x1）；
- F8 快捷键循环切换速度，F9 一键重置为 x1（正常速度）；
- 专为减少等待、加速天数推进设计，不影响任务逻辑、NPC行为或UI显示。

❌ 未修改：
- 游戏实际运行帧率（FPS）、动画播放速度、音效节奏、加载时间；
- 任何与时间无关的系统（如库存刷新、顾客生成逻辑仍按原始节奏触发）。

✨ 额外调整：
- 启动时默认启用，无需额外配置；
- 支持 Xbox Game Pass 版本（已实测通过）；Steam 版如遇异常请反馈，暂未提供专用补丁。

【使用要求】
- 必须运行于支持 BepInEx 的环境（安装流程中已自动处理）；
- 游戏版本需为 TCG卡店模拟器官方正式版（含 Xbox Game Pass 版本）；
- 无需额外扩展包或硬件升级，最低配置设备亦可流畅使用。

【兼容性说明】
- 兼容范围：所有启用 BepInEx 的 TCG卡店模拟器单机版本；
- 不兼容模组：「Mod Speed Game」（快捷键硬冲突，必须二选一）；
- 暂未推出兼容补丁。

【注意事项】
- 若 F8/F9 无响应，请检查是否被其他程序（如录屏软件、键盘宏工具）占用，重启游戏后重试；
- 如出现时间相关异常（如任务延迟触发、倒计时错乱），请立即关闭所有其他时间/时钟类模组；
- 本模组为纯客户端调节，不涉及服务器同步或联机功能，仅适用于单人模式。

【更新日志】
- 2024 年 4 月 15 日：适配 Xbox Game Pass 版本，确认稳定运行；
- 2024 年 3 月 22 日：优化 BepInEx 自动安装逻辑，提升首次启动成功率。

《TCG Card Shop Simulator》分级装饰板/标签 MOD 使用指南

【核心介绍】
提供多套风格化分级装饰板与标签，适配「贴图替换」模组使用，可一键切换视觉主题。

【安装指南】
1. 必须先安装前置依赖：本 MOD 安装前，需同步安装「贴图替换」MOD（[Nexus 链接](
2. 从本 MOD 页面下载压缩包，解压后任选一个文件夹（如 `Reborn_Blue` 或 `Reborn_Gold`）；
3. 将所选文件夹直接粘贴至游戏根目录：`Steam\steamapps\common\TCG Card Shop Simulator\`（不可嵌套子文件夹，不可多选）；
4. 若已安装「分级卡扩展器」（[Nexus 链接](其文件会自动覆盖「贴图替换」文件夹中同名的分级卡资源——此为预期行为，无需额外操作。

【功能详情】
✅ 已优化：全部分级装饰板、标签的视觉样式（含边框、底纹、文字排版）；
❌ 未修改：卡片等级逻辑、游戏内数值、UI 功能交互；
✨ 额外调整：每套主题均适配「贴图替换」标准路径结构，开箱即用。

【使用要求】
- 必备：已安装并启用「贴图替换」MOD；
- 游戏版本：TCG Card Shop Simulator v1.0 及以上（无特殊配置或扩展包要求）。

【兼容性说明】
- 兼容范围：所有基于「贴图替换」框架的视觉类 MOD（如自定义字体、背景等）；
- 不兼容模组：直接修改同一贴图路径的其他分级资源 MOD（会因文件覆盖导致冲突）；
- 兼容补丁：暂未推出。

【注意事项】
- ⚠️ 严格只能安装一个主题文件夹，同时放入多个会导致资源错乱；
- ⚠️ 「分级卡扩展器」会覆盖本 MOD 中同名的分级卡贴图——若需保留本 MOD 视觉，请勿启用该扩展器的分级卡功能；
- ⚠️ 无实际收益功能，“赚钱”仅为幽默表述，本 MOD 不含任何经济系统修改。

【更新日志】
2024 年 4 月 10 日首发版本，提供 5 套基础主题（Reborn_Blue / Gold / Neon / Vintage / Monochrome）。

【标题】
《杀戮尖塔》卡牌遮罩批量处理脚本使用指南

【核心介绍】
自动为所有怪物卡牌（含基础卡与闪卡）叠加指定遮罩，适配「Art Expander」文件结构，一键生成可直接安装的 BepInEx 模组包。

【安装指南】
1. 下载本脚本（含 `.py` 文件及配套配置说明），解压至本地任意文件夹；
2. 按需准备三类文件夹并在脚本中准确填写路径：
- `INPUT_FOLDER`：存放所有原始怪物图片（需从游戏文件或 `.asset` 中提取，格式为 PNG）；
- `MASK_FOLDER1`：存放基础卡牌遮罩文件（命名需与扩展包标识一致，如 `EX`）；
- `MASK_FOLDER2`：存放闪卡遮罩文件（命名规则同上，与 `MASK_FOLDER1` 对应）；
- `OUTPUT_FOLDER`：指定最终模组输出路径（脚本将自动生成完整 BepInEx 目录结构）；
3. 运行脚本，等待完成提示；生成的 `Output/BepInEx` 文件夹可直接压缩为 ZIP，通过 Vortex 或手动方式安装。

【功能详情】
✅ 已优化：自动识别同名遮罩，优先叠加 `MASK_FOLDER1`（基础卡），再叠加 `MASK_FOLDER2`（闪卡）；
✅ 已优化：若缺失 `MASK_FOLDER1`，仍可单独应用 `MASK_FOLDER2` 生成闪卡；
✅ 已优化：严格遵循「Art Expander」目录规范，输出文件可直接被游戏识别；
❌ 未修改：不修改原始图片尺寸、格式或内容逻辑；
✨ 额外调整：支持高级用户自定义后缀名、遮罩 Alpha 滤镜强度、透明度及输出图像参数（详见脚本内注释）。

【使用要求】
- 必需安装 Python 3.8+（脚本运行环境）；
- 必需提前提取并整理好符合命名规范的怪物图片（PNG 格式）；
- 输出结果依赖「Art Expander」模组，需已安装「Art Expander」v1.9.0 或更高版本。

【兼容性说明】
- 兼容范围：所有基于「Art Expander」机制的扩展包（如「Neow's Lament」「The Watcher」等）；
- 不兼容模组：无直接冲突，但不兼容擅自修改 `BepInEx/plugins/ArtExpander` 核心文件的第三方补丁；
- 兼容补丁：暂未推出专用兼容补丁。

【注意事项】
- 遮罩文件命名必须与目标扩展包标识完全一致（例：`EX.png` → 作用于「EX」扩展包所有卡牌）；
- `MASK_FOLDER1` 与 `MASK_FOLDER2` 中的同名文件将按顺序叠加，顺序不可颠倒；
- 脚本输出的 `Output/masks_preview` 文件夹内含 Alpha 遮罩效果预览图，可用于快速校验；
- 若运行报错，请检查路径中是否含中文或空格，并确认 Python 环境已正确配置。

【更新日志】
- 2024 年 5 月 12 日支持自定义输出图像参数（尺寸缩放、Gamma 校正）；
- 2024 年 4 月 3 日新增缺失基础遮罩时自动降级应用闪卡遮罩逻辑；
- 2024 年 3 月 1 日首版发布，适配「Art Expander」标准目录结构。

【标题】
《Shadowverse EVOLVE》卡牌扩充 MOD 使用指南

【核心介绍】
为原版《Shadowverse》新增 EVOLVE 机制卡牌，不替换任何原版内容，仅作补充扩展。

【安装指南】
1. 必须先手动安装「Shadowverse Texture Replacer」（纹理替换器），本 MOD 依赖其运行；
2. 解压下载的压缩包，将全部文件直接拖入游戏根目录（即包含 `Shadowverse.exe` 的文件夹）；
3. 安装后无需额外配置，启动游戏即可使用——缺一不可：未安装纹理替换器则 MOD 无效。

【功能详情】
✅ 已优化：新增全部 EVOLVE 机制卡牌（含普通版与金卡版）；
❌ 未修改：原版所有卡牌、UI、音效、剧情及神卡包内容；
✨ 额外调整：卡牌文本与效果严格遵循官方 EVOLVE 规则，适配原版对战逻辑。

【使用要求】
- 必需游戏版本：《Shadowverse》v4.0.0 或更高版本；
- 必需前置模组：「Shadowverse Texture Replacer」（v2.1+）；
- 无需扩展包或额外 DLC。

【兼容性说明】
- 兼容范围：所有基于纹理替换器机制的 MOD（如卡面美化、字体替换类）；
- 不兼容模组：直接修改卡牌数据文件（如 `cards.json`）的 MOD；
- 兼容补丁：暂未推出。

【注意事项】
- 神卡包未包含——因原版神卡无 EVOLVE 版本，本 MOD 不提供神卡 EVOLVE 化；
- 若游戏启动异常，请确认「Shadowverse Texture Replacer」已正确加载且版本匹配；
- 卡牌加入后自动进入卡组编辑界面，无需手动启用。

【更新日志】
- 2024 年 4 月 15 日首发版本，支持全 EVOLVE 卡牌基础功能；
- 2024 年 5 月 3 日修复部分金卡版特效偏移问题。

【核心介绍】
优化游戏内物品外观与商店货架展示，含玻璃个人书架等实用替换资源。

【安装指南】
1. 本MOD安装前，需同步安装前置依赖的MOD：「BepInEx」；
2. 将解压后的文件全部放入游戏根目录 /BepInEx 文件夹，缺一不可；
3. 若已安装其他修改相同物品的MOD，本MOD将覆盖其对应内容；如需保留原版文件，请提前备份「TextureReplacer」文件夹中对应名称的模型与贴图文件。

【功能详情】
✅ 已优化：玻璃个人书架（作为商店货架）、多类桌游物品外观；
❌ 未修改：首个桌游（因与另一桌游共用贴图名称，暂无法正确替换）；
✨ 额外调整：「TextureReplacer」文件夹内资源按功能分类整理，便于手动启用/禁用或替换。

【使用要求】
- 必须安装「BepInEx」插件框架；
- 游戏版本需支持 BepInEx 5.x 及以上。

【兼容性说明】
- 兼容范围：所有未直接修改「TextureReplacer」同名贴图/模型的MOD；
- 不兼容模组：其他同时替换相同桌游或书架物品的MOD（无官方兼容补丁，暂未推出）。

【注意事项】
- 替换前请确认无其他MOD占用目标物品路径，否则可能引发显示异常；
- 手动修改时，务必同步更新模型（.prefab）与贴图（.png）文件，若涉及重命名需一并处理；
- 推荐搭配「切换可售性」MOD 使用，以充分发挥货架类物品功能。

【更新日志】
- 2024年X月X日初始发布，含玻璃书架及基础桌游外观优化。

TLDR
【海报尺寸调整】
![](

【自由放置】
![](

【图层模式 / 海报堆叠】
![](

【核心介绍】
让海报自由缩放、精准堆叠、持久记忆——移动时实时调整大小，按轴微调图层，所有设置自动保存并加载，对齐更直观、操作更稳定。

【安装指南】
1. 必备前置：本 MOD 安装前，需同步安装 「BepInEx 5.x」（Windows 版）；
2. Vortex / 模组管理器安装：
• 为游戏安装并启用 「BepInEx 5」；
• 添加并启用本 MOD（文件名：「A2K.PosterScaler.dll」）；
3. 手动安装：
• 将 「A2K.PosterScaler.dll」放入游戏根目录 `/BepInEx/plugins/A2K.PosterScaler/`；
• 首次启动游戏以生成配置文件 `/BepInEx/config/A2K.PosterScaler.cfg`；
• 缺一不可：「BepInEx 5」必须已正确部署，否则 MOD 无法加载。

【功能详情】
✅ 已优化：
• 移动海报时实时缩放（X/Z 键，支持点击步进与按住连续）；
• 图层模式（L 键激活，沿海报旋转轴固定步长微调，专为堆叠设计）；
• 绿色/透明预览（始终高亮“有效区域”，可强制覆盖为绿色）；
• 重叠辅助（可选）：移动中临时设碰撞体为触发器，便于紧密排列；
• 粘性持久化：每个海报的大小与图层自动保存至 `/BepInEx/config/A2K.PosterScaler.scales.txt`，并在下次加载或放置时重新应用；
• 调试工具：切换 HUD 覆盖、转储尺寸摘要、清除孤立保存项。

❌ 未修改：
• 游戏原生移动/放置逻辑；
• 海报纹理、材质或渲染管线；
• 其他模组的碰撞体永久状态（仅移动中临时变更）。

✨ 额外调整：
• 保存机制升级：从旧版「兄弟顺序（…N）」改为「父路径+量化本地位置（如…|@-12,0,47）」，增删邻近海报不影响已有数据；
• 紧急掉落：快捷键立即烘焙当前大小/图层并退出操作状态；
• 放置后二次确认：海报“稳定”后自动重校图层，确保最终位置固定。

【使用要求】
• 必需：「BepInEx 5.x」（Windows）；
• 兼容游戏：任意使用 `InteractableDecoration` 的 Unity 游戏（如《深海迷航》《Valheim》等支持交互海报的版本）；
• 无需额外扩展包或特定图形驱动。

【兼容性说明】
• 兼容范围：所有基于 `InteractableDecoration` 实现海报交互的 Unity 游戏；
• 不兼容模组：无硬冲突，但若其他 MOD 在放置瞬间直接修改 `transform.position` 或父级结构，可能短暂干扰图层重校（建议将本 MOD 加载顺序置于同类调整模组之后）；
• 兼容补丁：暂未推出（本 MOD 采用幂等设计，已内置轻量协同逻辑）。

【注意事项】
• 移除海报后尺寸跳变？→ 删除 `/BepInEx/config/A2K.PosterScaler.scales.txt` 一次，启用新版位置绑定；
• 预览不显绿色/无轮廓？→ 启用配置项 `ForceGreenVisual` 和/或 `ShowHud`；
• 按键无响应？→ 检查是否被其他 MOD 占用，默认键位可在 `/BepInEx/config/A2K.PosterScaler.cfg` 中自定义；
• 因碰撞无法放置？→ 开启配置项 `AllowOverlapDuringMove`，移动时自动启用触发模式；
• 「紧急掉落」默认关闭，如需启用请在配置中绑定快捷键。

【更新日志】
• 2024 年 X 月 X 日新增位置稳定保存机制（父路径+量化坐标），彻底解决增删海报导致尺寸错配问题；
• 2024 年 X 月 X 日增加「紧急掉落」快捷键、「转储尺寸」与「清除孤儿」调试功能（默认未绑定）；
• 2024 年 X 月 X 日优化图层重校时机，在海报稳定后二次确认，提升堆叠可靠性。

【控制键（默认 • 全部可配置）】
所有按键均位于 `/BepInEx/config/A2K.PosterScaler.cfg` 中：
• 放大：`X`（点击 = 步进，按住 = 连续）；
• 缩小：`Z`（点击 = 步进，按住 = 连续）；
• 加速：按住 `Shift`（可配置）配合 X/Z；
• 重置大小：你的重置键（设 X=1, Y=1）；
• 切换图层模式：`L`（轴自动匹配海报旋转方向）；
• 图层上移/下移：你的图层键（图层模式或移动中均生效）；
• 紧急掉落：可选键（默认关闭）；
• 调试覆盖：通过配置项 `ShowDebugOverlay` 开关。

【卸载指南】
1. 删除 `/BepInEx/plugins/A2K.PosterScaler/` 文件夹；
2. （可选）清理残留：
• 配置文件：`/BepInEx/config/A2K.PosterScaler.cfg`；
• 保存数据：`/BepInEx/config/A2K.PosterScaler.scales.txt`。

【配置说明】
生成于 `/BepInEx/config/A2K.PosterScaler.cfg`，常用选项：
• `Enabled`：主开关；
• `ShowHud` / `ShowDebugOverlay`：控制 UI 覆盖显示；
• `AllowOverlapDuringMove`：移动时启用触发碰撞（推荐开启以利堆叠）；
• `Dump Scales`：记录当前所有海报尺寸摘要至日志；
• `Purge Orphans`：删除 `scales.txt` 中当前场景不存在的条目；
• 切换新版？清空 `/BepInEx/config/A2K.PosterScaler.scales.txt` 即可获得干净初始状态。

【故障排除】
• 移除海报后尺寸跳变 → 更新至本版并删除 `scales.txt`；
• 预览非绿色 / 无轮廓 → 启用 `ForceGreenVisual` 和 `ShowHud`；
• 按键无响应 → 检查键位占用，修改 cfg 后重启游戏；
• 因碰撞无法放置 → 开启 `AllowOverlapDuringMove`。

【常见问题】
问：本 MOD 会永久把海报碰撞体设为触发器吗？
答：不会。仅在你主动移动海报时临时设为触发器，放置完成即恢复原状。

问：图层模式会干扰游戏原生放置系统吗？
答：不会。图层键仅在移动中微调姿态；放置后，本 MOD 仅在稳定阶段单次重应用并二次确认，不持续干预。

问：能保留旧版 `scales.txt` 数据吗？
答：技术上可保留，但旧版基于「兄弟顺序」，易错配。强烈建议首次升级时删除 `/BepInEx/config/A2K.PosterScaler.scales.txt`，启用新版稳定绑定。

【已知问题】
• 若其他 MOD 在运行时动态更改海报父级链（如重组层级），量化键中的父尾部分可能变化；
• 海报被拖出常规移动范围（> 数个单位）时，其量化坐标可能被识别为新物品，导致尺寸/图层未继承。

【授权与致谢】
• 作者：Addison2k（A2K）；
• 授权：开源免费，禁止闭源分发；
• 资源：本 MOD 不包含任何外部纹理、模型或音频资源。

【特别感谢】
- 特别感谢 @iiTzSamurai 和 @Shaklin 在本 MOD 正常运行中提供的技术支持。

【PSA 等级板块说明】
✅ 已优化：新增 PSA 等级文字显示（当前为临时实现方案，受限于游戏原生代码，暂不支持多等级/不同等级贴图共存）
❌ 未修改：游戏底层文本定位逻辑（后续如官方开放相关接口，将跟进适配）
✨ 额外调整：仅需启用一个等级版本文件，避免冲突

【安装指南】
1. 下载本 MOD 对应的压缩包（含单个等级版本文件夹）
2. 解压所选的唯一一个等级文件夹（例如「PSA-10」），将其全部内容粘贴至：
`Steam\steamapps\common\TCG Card Shop Simulator\`
3. 必须安装前置依赖：本 MOD 安装前，需同步安装「TextureReplacer 1.3.6」或更高版本，否则等级贴图无法显示

【使用要求】
- 必备：已安装游戏本体《TCG Card Shop Simulator》
- 必备：「TextureReplacer 1.3.6」或更高版本（请勿使用旧版）

【注意事项】
- ⚠️ 解压前，请务必备份原路径下 `TextureReplacer > objects_textures > GradedCardCase.png` 文件（防止覆盖丢失）
- ⚠️ 严禁同时解压多个等级文件夹，否则会导致贴图错乱或显示异常
- ⚠️ 当前 PSA 标志标签功能尚未上线，仅预留位置，后续更新将单独发布

【更新日志】
- 2024 年 X 月 X 日新增 PSA 等级文字显示功能，支持单等级版本独立启用

《TCG Card Shop Simulator》雾气清除 MOD 使用指南

【核心介绍】
✅ 移除游戏内不必要的雾气效果，让场景更通透、画面更清晰；不修改任何材质文件，仅优化视觉层级。

【安装指南】
1. 下载「Fog Be Gone!」MOD 文件（通常为 `.dll` 格式）；
2. 将文件拖入游戏根目录 /BepInEx/plugins 文件夹（缺一不可）；
3. 确保已安装 BepInEx 6.x（本 MOD 依赖 BepInEx 运行，未安装则无法生效）。

【功能详情】
✅ 已优化：全局雾气渲染逻辑，显著降低远景雾浓度；
❌ 未修改：所有材质、贴图、光照配置及海报/道具模型；
✨ 额外调整：适配默认分辨率与常见缩放设置，无需额外配置。

【使用要求】
- 必需：已安装 BepInEx 6.x（推荐 6.0.0 或更高版本）；
- 游戏版本：兼容 TCG Card Shop Simulator 官方最新版（v1.0+）；
- 系统：Windows 10/11，.NET 6.0 运行时已预装（BepInEx 安装包自动包含）。

【兼容性说明】
- 兼容范围：所有不直接覆盖 `PostProcessVolume` 或 `FogSettings` 的 MOD；
- 不兼容模组：「X3」、「Dark Desires」（二者均重写雾气与后处理管线，会冲突导致失效）；
- 兼容补丁：暂未推出（如需共存，请优先启用本 MOD 并禁用上述两个模组）。

【注意事项】
- 安装后无需重启游戏，进入商店场景即刻生效；
- 若仍见雾气，请检查是否误将文件放入 `/BepInEx/patchers` 或 `/BepInEx/core`（必须放在 `/plugins`）；
- 本 MOD 不影响任何卡片展示、库存管理或交易系统，纯视觉优化。

【更新日志】
- 2024 年 4 月 12 日首发正式版，支持 TCG Card Shop Simulator v1.0；
- 2024 年 5 月 3 日修复低分辨率下雾气残留问题，优化性能开销。
============================================================

============================================================