Proxyshop

Proxyshop 是一款 Photoshop 自动化应用程序，可生成高质量的 Magic the Gathering 卡渲染。受到 Chilli-Axe 原始 Photoshop 自动化脚本的启发。如果您需要此应用程序的帮助或希望解决问题，请加入我们的不和谐！

要求

• Photoshop（2017-2024 支持）
• Windows（目前与 Mac/Linux 不兼容）
• Photoshop 模板（可以在应用程序中下载）
• 所需字体（包含在fonts/中）：
  • Beleren Proxy Bold — 用于卡牌名称、类型线、力量/韧性
  • Proxyglyph — 对于法力符号，Chilli 的 NDPMTG 字体的一个分支
  • Plantin MT Pro — 对于规则文本，安装包含的所有变体
  • Beleren Smallcaps — 对于艺术家信用额度和其他
  • Gotham Medium — 用于收集器文本
• 可选（但推荐）字体：
  • 万智牌— 经典模板所需
  • Matrix Bold — Colorshifted 模板所需
  • Mana — 用于各种附加卡牌符号

设置指南

1. 下载最新版本，将其解压到您选择的文件夹中。
2. 安装fonts/文件夹中包含的字体，请注意Proxyglyph可能需要在未来版本中更新。
3. 将您想要渲染的卡片的卡片艺术放置在art/文件夹中。这些艺术作品应根据卡片命名（有关更多信息，请参阅艺术文件命名）。
4. 启动Proxyshop.exe 。单击更新按钮。 Proxyshop将加载可供下载的模板，抓取您想要的内容。
5. 点击“全部渲染”以渲染art/文件夹中的每张卡片艺术。点击“渲染目标”以渲染一种或多种特定的卡片艺术。
6. 您还可以将艺术图像或包含艺术图像的文件夹拖到 Proxyshop 应用程序上，Proxyshop 将自动开始渲染这些卡片。
7. 在渲染过程中，底部控制台会显示当前进度，并在出现失败时提示您。

？艺术文件命名

• 目前支持的艺术文件类型有： jpg 、 jpeg 、 jpf 、 png 、 tif和webp 。注意： webp需要 Photoshop 2022+。
• 艺术文件应以真实的万智牌卡牌命名，并应尽可能准确地命名，例如Damnation.jpg 。
• Proxyshop 在命名您的艺术文件时支持多个可选标签，以便您更好地控制卡片的渲染方式！
  • 设置[SET] — 强制 Photoshop 从与给定设置代码匹配的特定 MTG 扩展中渲染该卡的版本。该标签不区分大小写，因此“set”和“SET”都可以使用。

   Damnation [TSR].jpg
  

  • 收藏家编号{num} — 仅当还提供了设置标签时才有效，使用确切的设置代码和数字组合呈现该卡的版本。这在一组具有同一张卡的多个版本的情况下特别有用，例如 Secret Lair (SLD) 有 3 个不同版本的Brainstorm 。

   Brainstorm [SLD] {175}.jpg
  

  • 艺术家姓名(Artist Name) ——填写艺术家姓名时，Proxyshop 会用您提供的名称覆盖 Scryfall 数据中存在的名称。此更改纯粹是装饰性的，不会影响卡的获取方式，也不会与其他标签冲突。

   Brainstorm [SLD] {175} (Rusty Shackleford).jpg
  

  • 创建者名称$Creator Name — Proxyshop 的默认模板并未广泛支持此标签。此标签允许您插入您作为用户/设计者/创建者的首选名称，如果模板支持创建者名称功能，则此文本将放置在指定的文本图层上。可以用作您作品的一种签名。注意：此标签必须放置在艺术文件名的最末尾。

   Brainstorm [SLD] {175}$My Creator Name.jpg
  

使用 Proxyshop GUI

渲染卡选项卡

• 用于渲染真实万智牌卡牌的主选项卡。
• 渲染全部：使用art/文件夹中找到的每个艺术图像渲染卡片图像。
• 渲染目标：在 Photoshop 中打开文件选择，使用您选择的每个艺术图像渲染卡片图像。
• 全局设置：打开一个设置面板，用于更改应用程序范围内的选项：
  • 主要设置：影响模板行为，可以针对各个模板进行修改。当您单击模板旁边的图标时，将为该模板生成一个配置文件，该文件会覆盖这些设置。
  • 系统设置：影响整个应用程序，并且无法针对单个模板进行更改。
• 这些按钮下方的选项卡集代表模板类型，例如普通、MDFC、变换等。
  • 模板类型代表不同类型的模板，它们需要不同的框架元素或不同的渲染技术。
  • 如果“普通”选项卡处于活动状态，并且单击模板按钮，则该模板将被选择为“普通”模板类型。与普通类型匹配的卡片现在将使用该模板进行渲染。
  • 该模板不会被其他类型选择。例如，如果在“普通”选项卡中选择“无边框” ，但在“MDFC”选项卡中选择“普通” 。与MDFC类型匹配的卡将使用Normal MDFC进行渲染。
• 模板列表中每个模板旁边有两个图标：
  • 允许您更改此模板的主要设置，某些模板也有自己专门设计的设置，您也可以更改。
  • ？删除为此模板生成的单独配置文件，从而有效地将此模板恢复为默认设置。确保此模板的主要设置由全局设置面板管理。
• 模板选择器下方的深灰色区域是控制台，这里将显示状态消息，跟踪渲染进度和其他用户操作。
• 控制台右侧有一些有用的按钮：
  • ？固定 Proxyshop 窗口，使其保持在所有其他正在运行的程序之上
  • ？截取 Proxyshop 窗口的屏幕截图，保存到： out/screenshots/
  • ？打开您的默认 Web 浏览器，导航到 Proxyshop 的 GitHub 页面
  • ❔ 打开您的默认网络浏览器，导航到我们的社区 Discord 服务器
  • 继续：当应用程序等待用户响应时（启用手动编辑或发生错误），将变为活动状态。
  • 取消：在渲染卡片时变为活动状态，可以随时或发生错误时取消渲染操作。
  • 更新：打开更新程序面板，您可以在其中下载新模板并更新现有模板。

自定义创建者选项卡

• 此选项卡控制自定义卡片创建者。
• 此功能目前被认为是实验性测试版，可能存在问题。
• 您当前可以渲染Normal 、 Planeswalker或Saga卡，只需填写适当的数据并点击Render Custom 。
• 更多功能和卡类型将在不久的将来添加。

工具选项卡

• 此选项卡包含不断增长的有用工具和实用程序列表。
• 渲染所有展示柜：为out/文件夹中的每个卡片图像生成带边框的展示柜图像，展示柜将放置在out/showcase/中。
• 渲染目标展示：在 Photoshop 中打开选择的文件，为您选择的每个卡片图像生成带边框的展示图像。
• 压缩渲染：此工具可减小存储在out/文件夹中的卡片图像的大小。设置为：
  • 质量：JPEG保存压缩图像的质量，支持1到100之间的数字。（推荐：95-99）
  • Optimize ：启用 Pillow 的自动“优化”标志。略微降低文件大小，没有明显的缺点。 （推荐：开）
  • 800 DPI ：将高于 800 DPI 的卡片图像缩小至最大 800 DPI。大多数 Proxyshop 模板都是 1200 DPI，这比任何人真正需要的都要高得多。大多数打印服务的打印分辨率不超过 800 DPI。 （推荐：开）

？设置指南（Python环境）

为 Proxyshop 设置 Python 环境适用于高级用户、贡献者以及任何想要亲自为应用程序制作插件或自定义模板的人！本指南假设您已经安装了 Python。请参阅上面的徽章以了解受支持的 Python 版本。

1. 使用 pipx 安装 Poetry。

    # Install pipx and poetry
   python -m pip install --user pipx
   python -m pipx ensurepath
   pipx install poetry

2. 将 Proxyshop 克隆到系统上的某个位置，我们将其称为根目录。

   git clone https://github.com/MrTeferi/Proxyshop.git

3. 导航到根目录并安装项目环境。

    cd proxyshop
   poetry install

4. 安装fonts/文件夹中包含的字体。安装后不要删除它们，有些是 GUI 使用的。
5. 在根目录中创建一个名为art的文件夹。您可以在此处放置要渲染的卡片的艺术图像。
6. 运行应用程序。

    # OPTION 1) Execute via poetry
   poetry run main.py
   
   # OPTION 2) Enter the poetry environment, then execute with cli
   poetry shell
   proxyshop gui

7. 请参阅 GUI 导航的使用指南。

？手动下载模板

如果您想手动下载模板，请访问此链接。这些档案必须提取到/templates目录。必须将Investigamer和SilvanMTG驱动器文件夹中找到的存档分别提取到/plugins/Investigamer/templates和/plugins/SilvanMTG/templates 。

？我如何支持 Proxyshop？

请随意加入我们的 Discord 并参与#Proxyshop频道，我们不断集思广益并测试新功能、发布测试版并共享新插件和模板。另外，请考虑支持我们的 Patreon，它支付 Proxyshop 模板的 S3 + Cloudfront 托管费用，并允许我们自由地开发该应用程序以及其他应用程序，例如 MPC Autofill、MTG Art Downloader 等！如果 Patreon 不适合您，您也可以通过 Paypal 给我买杯咖啡。非常感谢我们出色的支持者！

❓ 常见问题解答

如何将设置的符号更改为其他符号？

在设置中，将“默认符号”更改为所需符号的设置代码，并启用“强制默认符号”。如果您想添加完全自定义的符号，请执行以下过程：

• 转到src/img/symbols/并创建一个根据新的自定义代码命名的文件夹。
• 将自定义 SVG 符号添加到您创建的文件夹中，根据其稀有性的第一个字母（大写）命名每个文件。
• 将该符号设置为“默认符号”并启用“强制默认符号”。你可以走了！

如何完全隐藏设置的符号？

在全局设置或特定模板的设置中，将“符号渲染模式”更改为“无”。这将完全禁用扩展符号。

如何隐藏 Proxyshop 模板中的图层，使其不会出现在渲染卡中？

在您选择的 Photoshop 模板中，将要隐藏的图层的不透明度更改为 0。您可以使用此方法来隐藏任何内容。这比仅仅禁用图层的可见性更安全，因为应用程序可能会强制启用和禁用图层，它也比删除图层更安全，因为这可能会导致某些模板出现错误。

哪里可以找到高品质的 MTG 艺术品？

您最好的资源将是 MTG Pics，为了进一步提高艺术质量，您可以考虑使用 Topaz/Chainner/ESRGAN 进行升级。在我们的不和谐中，我们提供了大量资源来学习如何轻松有效地提升艺术水平。如需大量下载艺术作品，请查看我的另一个项目：MTG Art Downloader

尝试输入文本时应用程序停止，并且 Photoshop 变得无响应！

有一个已知的错误，当尝试在文本框中输入太多文本时，Photoshop 会崩溃，该错误应该得到修复，但理论上可能会发生在某些无法使文本框足够大的插件模板上。解决此问题的最佳方法是在 Photoshop 中打开模板并展开规则文本框（生物和非生物）的底部边缘。

缺少所需值/RPC 服务器未响应。

有时，这可能是某些系统上发生的较为罕见但令人讨厌的错误之一。有时根本原因未知，但通常可以修复。按顺序尝试这些选项，直到有效果：

• 确保您的计算机上仅安装了一个Photoshop。同时安装两个版本的 Photoshop 可能会阻止与该应用程序的连接。如果您安装了多个版本，请卸载所有版本的 Photoshop，然后重新安装一个版本。您必须先卸载所有这些，仅删除一个可能无法解决问题。
• 确保您的 Photoshop 应用程序是使用实际的安装程序安装的。 Photoshop 的便携式安装无法与 Proxyshop 一起使用，因为 Windows 需要知道它的位置。
• 关闭 Photoshop 和 Proxyshop，然后以管理员身份运行 Photoshop 和 Proxyshop，尝试渲染某些内容。
• 关闭它们，然后在启动 Photoshop 时按住 ALT + CTRL + SHIFT，然后启动 Proxyshop，再试一次。
• 重新启动计算机，然后启动两者并重试。
• 如果您运行的防病毒软件防御过度，可能会干扰 Proxyshop 连接到 Photoshop，例如 Avast、Norton 等，请关闭您的防病毒软件，重新启动这两个软件，然后重试。您也可以尝试禁用 Windows Defender。
• 如果您的 Photoshop 安装可能会被损坏、损坏或以其他方式出现混​​乱，建议完全卸载 Photoshop 并安装您可以访问的最新版本。一般来说，Proxyshop 与较新版本的 Photoshop 配合使用效果最佳。如果使用非正版 Photoshop 版本，请验证其是否具有高质量并使用真实的安装程序。
• 如果所有这些都无法解决问题，请加入我们的 Discord（链接在顶部）并提供 Proxyshop 目录中的logs/error.txt中的错误日志，以便我们帮助找到原因:)

法力消耗、规则或其他文本巨大且无法缩小？

• 在 Photoshop 中，转到“编辑” > “首选项” > “单位和标尺” 。
• 将标尺设置为像素
• 将类型设置为点
• 该问题应该得到解决。

Photoshop 正忙！

当 Photoshop 由于繁忙而未响应命令时，会出现此错误。为了防止出现此错误，您必须确保在运行 Proxyshop 或渲染卡时 Photoshop 处于中性状态：

• Photoshop 中不应打开任何对话框或设置菜单。普通的工具面板就可以了。
• 不应该有任何工具执行任务，例如突出显示文本以使用文本工具进行编辑。
• 理想情况下，Photoshop 应全新启动，且不打开任何文档。

我收到其他错误！

在您的 proxyshop 目录中，查找名为logs的文件夹，在该文件夹中您应该看到error.txt ，检查该文件中的最后一个错误日志。如果错误不明显，请加入我们的 Discord，并随时在 #Proxyshop 频道中寻求帮助。

制作人员

• 我们令人惊叹的 Patreon 支持者确实让这个项目得以继续进行。
• Chilli Axe 因其杰出的 MTG Photoshop Automation 项目而受到 Proxyshop 的启发，并制作了许多经过修改以与 Proxyshop 配合使用的基本 PSD 模板。
• 其他模板和资产支持来自：
  • 西尔万MTG
  • 内林斯
  • Trix 是酷航的
  • 火焰之火
  • 米哈伊格德拉西尔
  • 扭曲丹迪
  • 男性MPC
  • 维托里奥·马西亚
  • 德普
  • 图皮南巴（佩德罗·内维斯）
• Andrew Gioia 的各种字体项目过去曾用于 Proxyshop。
• John Prime、Haven King 和 CCGHQ 成员提供了扩展符号 SVG。
• Hal 和其他贡献者在 Photoshop Python API 上。
• 海岸奇才队和所有才华横溢的艺术家使万智牌成为现实。
• 无数其他人为社区提供了帮助和其他资产，使各种功能成为可能。
• 代码库的所有贡献者。