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 — 用於各種附加卡牌符號
設定指南
- 下載最新版本，將其解壓縮到您選擇的資料夾中。
- 安裝
fonts/資料夾中包含的字體，請注意Proxyglyph可能需要在未來版本中更新。 - 將您想要渲染的卡片的卡片藝術放置在
art/資料夾中。這些藝術作品應根據卡片命名（有關更多信息，請參閱藝術文件命名）。 - 啟動
Proxyshop.exe 。點選更新按鈕。 Proxyshop將載入可供下載的模板，抓取您想要的內容。 - 點擊“全部渲染”以渲染
art/資料夾中的每張卡片藝術。點擊“渲染目標”以渲染一種或多種特定的卡片藝術。 - 您也可以將藝術圖像或包含藝術圖像的資料夾拖曳到 Proxyshop 應用程式上，Proxyshop 將自動開始渲染這些卡片。
- 在渲染過程中，底部控制台會顯示當前進度並提示您是否出現失敗。
？藝術檔案命名
- 目前支援的藝術檔案類型有：
jpg 、 jpeg 、 jpf 、 png 、 tif和webp 。注意： webp需要 Photoshop 2022+。 - 藝術檔案應以真實的萬智牌卡牌命名，並應盡可能準確地命名，例如
Damnation.jpg 。 - Proxyshop 在命名您的藝術檔案時支援多個可選標籤，以便您更好地控制卡片的渲染方式！
- 設定
[SET] — 強制 Photoshop 從與給定設定程式碼相符的特定 MTG 擴充功能中渲染該卡的版本。此標籤不區分大小寫，因此「set」和「SET」都可以使用。
- 收藏家編號
{num} — 僅在也提供了設定標籤時才有效，使用確切的設定代碼和數字組合呈現該卡的版本。這在一組具有同一張卡的多個版本的情況下特別有用，例如 Secret Lair (SLD) 有 3 個不同版本的Brainstorm 。
Brainstorm [SLD] {175}.jpg
- 藝術家姓名（Artist Name
(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之間的數字。
- Optimize ：啟用 Pillow 的自動「最佳化」標誌。略微降低文件大小，沒有明顯的缺點。 （推薦：開）
- 800 DPI ：將高於 800 DPI 的卡片影像縮小至最大 800 DPI。大多數 Proxyshop 模板都是 1200 DPI，這比任何人真正需要的都要高得多。大多數列印服務的列印解析度不超過 800 DPI。 （推薦：開）
？設定指南（Python環境）
為 Proxyshop 設定 Python 環境適用於高級用戶、貢獻者以及任何想要親自為應用程式製作外掛程式或自訂模板的人！本指南假設您已經安裝了 Python。請參閱上面的徽章以了解支援的 Python 版本。
- 使用 pipx 安裝 Poetry。
# Install pipx and poetry
python -m pip install --user pipx
python -m pipx ensurepath
pipx install poetry
- 將 Proxyshop 複製到系統上的某個位置，我們稱之為根目錄。
git clone https://github.com/MrTeferi/Proxyshop.git
- 導航到根目錄並安裝專案環境。
cd proxyshop
poetry install
- 安裝
fonts/資料夾中包含的字型。安裝後不要刪除它們，有些是 GUI 使用的。 - 在根目錄中建立一個名為
art的資料夾。您可以在此處放置要渲染的卡片的藝術圖像。 - 運行應用程式。
# OPTION 1) Execute via poetry
poetry run main.py
# OPTION 2) Enter the poetry environment, then execute with cli
poetry shell
proxyshop gui
- 請參閱 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 上。
- 海岸奇才隊和所有才華橫溢的藝術家使萬智牌成為現實。
- 無數其他人為社區提供了幫助和其他資產，使各種功能成為可能。
- 程式碼庫的所有貢獻者。
