卡牌翻转视图

本游戏中的卡牌向来只展示正面。卡牌翻转视图改变了这一点。将一张卡牌拉入近距倾斜视图后，你现在可以将其旋转来查看背面，或将其侧转，像手持实体卡牌一样阅读。除此之外，模组作者还可以将单张卡牌标记为自行以特定方式摆放——在卡册中展示背面、飞入近距视图时已经翻转过来，或者在你从架子上或卡包中取出它们的瞬间就以预设姿态呈现。

这是一个轻量级的体验优化模组，无需任何依赖。放入即可生效。


打开一个卡册并点击一张卡牌，将其拉入靠近鼠标的“向鼠标倾斜”特写视图，然后：

• 鼠标中键 - 将卡牌翻转过来，让你可以查看和检视其背面。鼠标倾斜功能照常运作，因此背面的行为与正面完全一致。
• Ctrl + 鼠标中键 将牌在正面旋转四分之一圈，使其横向放置。
  

两者都是开关——再次按下即可切换回来。你新抽到的每张卡都是全新开始。

• 鼠标按键反转 - 在特写视图中，哪个按钮可以翻转卡牌（默认鼠标中键；左键或右键也可以）。Ctrl 加同一个按钮可以进行侧翻。
• 装订卷度数 - 侧向滚动会使卡片旋转的角度（默认90）。
• 启用模组 - 主控开关。
• 调试模式 - 额外日志记录，默认关闭。
  

除了实时控制之外，模组还可以为特定卡牌设置固定的朝向，使其始终以特定方式呈现：

• 又回到收藏册里了 卡片在收藏册页面网格中展示时背面朝上，计数标签等依然可读。
• 飞入后掉头 - 卡牌进入特写时已经背对玩家，并在飞入过程中平滑过渡到拾取姿态。
• 手持姿势 - 无论从架子上、卡包里还是活页夹中拿起来，卡牌一拿到手中就会立刻翻转和/或卷曲。
  

这就是为什么双面卡牌或需要横向阅读的卡牌能自动呈现出正确的方向感。



你无需手动编写以下任何文件。 PTCGO EPL 管理器 桌面仪表板会在每个发行版的功能列表中列出卡牌翻转视图——点击它创建每张卡牌的朝向文件，再次点击即可在内置编辑器中打开。管理器会为你处理文件夹放置、扩展包名称以及卡牌索引查找，因此创作只需点击几下，而无需手动编辑 JSON。卡牌翻转视图是那里仅限集换式卡牌游戏的功能，与定价、卡包以及其他按发行版的模组并列。

更想手动操作？完整文件格式如下——管理器会直接为你写入这些内容。



方向由小型“附属”JSON文件驱动。将它们放在模组自身文件夹下的任意位置：

BepInEx/plugins/卡牌翻转视图/

• 递归扫描 每 .json 该文件夹下的内容会被加载，包括任意子文件夹和任意文件名。没有必须放置的子文件夹；分文件夹只是为了方便你自己整理。
• 受内容约束，而非路径 一个文件通过以下方式与集合匹配： 扩展包 其价值在于内在，而非所处位置。
• 每个扩展包对应一个逻辑文件 - 如果多个文件指向同一集合，它们会合并，而在重复的卡牌索引上，后加载的文件会覆盖先前的文件。
• 按需加载一次 首次查询卡牌时会加载文件（确保所有系列先完成注册），之后便保持缓存。修改附属文件后需重启游戏才能看到变更。
  

已部署 示例.json.模板 记录形状；将其重命名为 .json 让它加载。

{
  "扩展": "MT_BaseSet_MT",
  “卡牌”：{
    “0”：{“BinderFlip”：真，“HandFlip”：真，“HandRollZ”：90}
  }
}

• 资料片 - 此文件适用的扩展包。EPL集使用经过清理的捆绑包名称（例如 基础套组）；原版套装使用其简单名称（例如 特特拉蒙）。必须完全匹配，但忽略大小写。
• 卡牌 - 以……为键的映射 卡牌索引 （以字符串形式书写）。每个条目包含以下方向标志。
  

• 翻页夹 （真/假）- 卡牌在活页夹网格中时显示背面，这也是它飞入特写时起始的姿态。
• 翻手 （真/假）——卡牌在手牌中时会翻转过来，这也是卡牌飞入时近景动画朝向的姿态。
• 手卷Z （度）——卡牌被拾取时在其正面滚动的距离（侧向及更远方向）。没有活页夹网格的对应项——活页夹姿态受倾斜限制——但特写镜头在卡牌飞入时会逐渐过渡到此值。
  

简而言之： 活页夹翻页 设置休息/网格姿势，同时 手部翻转 和 汉德尔罗兹 设置特写镜头飞入时的手持姿势。

• 索引是卡牌在系列显示列表中的位置，从0开始计数 - 与其余部分（EPL 捆绑包、定价附属文件以及 Binder）所使用的相同数组顺序索引。 这不是印在卡上的号码。 按卡牌编号排序会导致编号顺序与卡牌顺序不一致的系列中每张卡牌都映射错误。
• 同一张卡的边框和闪卡变体共用一个索引 - 它以卡片为键，而非以变体为键。
• 如果某个旗标似乎没有任何效果，请先检查扩展名称。 名称与已加载集合不匹配，意味着对该文件的每次查找都会静默失效。单个文件有问题只会被跳过并记录日志，不会影响其他文件。