Proxyshop

Proxyshop adalah aplikasi otomatisasi Photoshop yang menghasilkan render kartu Magic the Gathering berkualitas tinggi. Terinspirasi oleh skrip otomatisasi Photoshop asli Chilli-Axe. Jika Anda memerlukan bantuan dengan aplikasi ini atau ingin memecahkan masalah, silakan bergabung dengan perselisihan kami!

Persyaratan

• Photoshop (Didukung 2017-2024)
• Windows (saat ini tidak kompatibel dengan Mac/Linux)
• Template Photoshop (Dapat diunduh di aplikasi)
• Font yang diperlukan (termasuk dalam fonts/ ):
  • Beleren Proxy Bold — Untuk Nama Kartu, Garis Tipe, Kekuatan/Ketangguhan
  • Proxyglyph — Untuk simbol mana, cabang dari font NDPMTG Chilli
  • Plantin MT Pro — Untuk teks aturan, instal semua varian yang disertakan
  • Beleren Smallcaps — Untuk batas kredit Artis dan lain-lain
  • Gotham Medium - Untuk teks kolektor
• Font opsional (tetapi disarankan):
  • Magic The Gathering — Diperlukan oleh template Klasik
  • Matrix Bold — Diperlukan oleh template Colorshifted
  • Mana — Untuk berbagai simbol kartu tambahan

Panduan Pengaturan

1. Unduh rilis terbaru, ekstrak ke folder pilihan Anda.
2. Instal font yang disertakan dalam folder fonts/ , harap dicatat bahwa Proxyglyph mungkin perlu diperbarui di rilis mendatang.
3. Tempatkan seni kartu untuk kartu yang ingin Anda render di folder art/ . Karya seni ini harus diberi nama sesuai dengan kartunya (lihat Penamaan File Seni untuk informasi lebih lanjut).
4. Luncurkan Proxyshop.exe . Klik tombol Perbarui . Proxyshop akan memuat template yang tersedia untuk diunduh, ambil apa yang Anda inginkan.
5. Tekan Render All untuk merender setiap seni kartu di folder art/ . Tekan Render Target untuk merender satu atau lebih seni kartu tertentu.
6. Anda juga dapat menyeret gambar seni atau folder yang berisi gambar seni ke aplikasi Proxyshop, Proxyshop akan secara otomatis mulai merender kartu tersebut.
7. Selama proses render, konsol di bagian bawah akan menampilkan kemajuan saat ini dan menanyakan apakah terjadi kegagalan.

? Penamaan File Seni

• Jenis file seni yang saat ini didukung adalah: jpg , jpeg , jpf , png , tif , dan webp . CATATAN : webp memerlukan Photoshop 2022+.
• File seni harus diberi nama berdasarkan kartu Magic the Gathering asli dan harus diberi nama seakurat mungkin, misalnya Damnation.jpg .
• Proxyshop mendukung beberapa tag opsional saat memberi nama file seni Anda, untuk memberi Anda kontrol lebih besar atas cara kartu dirender!
  • Set [SET] — Memaksa Photoshop untuk merender versi kartu tersebut dari ekspansi MTG tertentu yang cocok dengan kode set yang diberikan. Tag ini tidak peka huruf besar-kecil, jadi "set" dan "SET" akan berfungsi.

   Damnation [TSR].jpg
  

  • Nomor Kolektor {num} — Hanya berfungsi jika tag Set juga disediakan, render versi kartu tersebut dengan kode set dan kombinasi nomor yang tepat. Hal ini sangat berguna jika suatu set memiliki beberapa versi dari kartu yang sama, misalnya Secret Lair (SLD) memiliki 3 versi Brainstorm yang berbeda.

   Brainstorm [SLD] {175}.jpg
  

  • Nama Artis (Artist Name) — Saat mengisi nama artis, Proxyshop akan mengganti nama yang ada di data Scryfall dengan nama yang Anda berikan. Perubahan ini hanya bersifat kosmetik dan tidak memengaruhi cara pengambilan kartu, juga tidak bertentangan dengan tag lainnya.

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

  • Nama Pembuat $Creator Name — Tag ini tidak didukung secara luas oleh templat default Proxyshop. Tag ini memungkinkan Anda memasukkan nama pilihan Anda sebagai pengguna/desainer/pencipta, dan jika templat mendukung fitur nama pembuat, teks ini akan ditempatkan pada lapisan teks tertentu. Dapat digunakan sebagai semacam tanda tangan untuk karya Anda. CATATAN : Tag ini HARUS ditempatkan di SANGAT AKHIR nama file seni.

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

Menggunakan GUI Proxyshop

Tab Render Kartu

• Tab utama untuk merender kartu Magic the Gathering asli.
• Render All : Merender gambar kartu menggunakan setiap gambar seni yang ditemukan di folder art/ .
• Render Target : Membuka pemilihan file di Photoshop, merender gambar kartu menggunakan setiap gambar seni yang Anda pilih.
• Pengaturan Global : Membuka panel pengaturan yang digunakan untuk mengubah opsi seluruh aplikasi untuk:
  • Pengaturan utama : Mempengaruhi perilaku template, dapat dimodifikasi untuk masing-masing template. Saat Anda mengklik ikon di samping templat, file konfigurasi dibuat untuk templat tersebut yang mengesampingkan pengaturan ini.
  • Pengaturan sistem : Mempengaruhi keseluruhan aplikasi dan tidak dapat diubah untuk masing-masing templat.
• Kumpulan tab di bawah tombol ini mewakili jenis template , misalnya Normal, MDFC, Transform, dll.
  • Jenis templat mewakili berbagai jenis templat yang memerlukan elemen bingkai berbeda atau teknik rendering berbeda.
  • Jika tab Normal aktif, dan Anda mengklik tombol templat, templat tersebut akan dipilih untuk jenis templat Normal . Kartu yang cocok dengan tipe Normal sekarang akan dirender menggunakan templat tersebut.
  • Templat itu TIDAK dipilih untuk tipe lain. Misalnya, jika Tanpa Batas dipilih di tab Normal , namun Normal dipilih di tab MDFC . Kartu yang cocok dengan tipe MDFC akan dirender menggunakan MDFC Normal .
• Di samping setiap templat dalam daftar templat terdapat dua ikon:
  • Memungkinkan Anda mengubah Pengaturan Utama untuk template ini, beberapa template juga memiliki pengaturan yang dirancang khusus yang dapat Anda ubah juga.
  • ? Menghapus file konfigurasi terpisah yang dibuat untuk templat ini, yang secara efektif mengembalikan templat ini ke pengaturan default. Memastikan Pengaturan Utama untuk templat ini diatur oleh panel Pengaturan Global .
• Area abu-abu gelap di bawah pemilih template adalah Konsol , di sinilah pesan status akan ditampilkan yang melacak kemajuan render dan tindakan pengguna lainnya.
• Di sebelah kanan Konsol terdapat beberapa tombol berguna:
  • ? Menyematkan jendela Proxyshop agar tetap berada di atas semua program lain yang sedang berjalan
  • ? Mengambil tangkapan layar jendela Proxyshop, menyimpannya ke: out/screenshots/
  • ? Buka browser web default Anda, navigasikan ke halaman GitHub Proxyshop
  • ❔ Membuka browser web default Anda, menavigasi ke server Discord komunitas kami
  • Lanjutkan : Menjadi aktif ketika aplikasi menunggu respons pengguna, baik ketika pengeditan manual diaktifkan atau terjadi kesalahan.
  • Batal : Menjadi aktif ketika kartu sedang dirender, dapat membatalkan operasi render kapan saja atau jika terjadi kesalahan.
  • Update : Membuka panel Updater yang memungkinkan Anda mendownload template baru dan memperbarui template yang sudah ada.

Tab Pembuat Kustom

• Tab ini mengontrol pembuat kartu khusus.
• Fitur ini saat ini dianggap beta eksperimental dan mungkin mengalami masalah.
• Saat ini Anda dapat merender kartu Normal , Planeswalker , atau Saga , cukup isi data yang sesuai dan tekan Render Custom .
• Lebih banyak fitur dan jenis kartu akan ditambahkan dalam waktu dekat.

Tab Alat

• Tab ini berisi daftar alat dan utilitas bermanfaat yang terus bertambah.
• Render All Showcases : Menghasilkan gambar etalase berbatas untuk setiap gambar kartu di folder out/ , etalase akan ditempatkan di out/showcase/ .
• Render Target Showcase : Membuka file yang dipilih di Photoshop, menghasilkan gambar etalase berbatas untuk setiap gambar kartu yang Anda pilih.
• Compress Renders : Alat ini mengurangi ukuran gambar kartu yang disimpan di folder out/ . Pengaturannya adalah:
  • Kualitas : JPEG menyimpan kualitas gambar terkompresi, mendukung angka antara 1 dan 100. ( Direkomendasikan : 95-99)
  • Optimalkan : Mengaktifkan tanda "optimalkan" otomatis Pillow. Menurunkan ukuran file dengan margin kecil tanpa kerugian yang terlihat. ( Direkomendasikan : Aktif)
  • 800 DPI : Menurunkan skala gambar kartu di atas 800 DPI hingga maksimum 800 DPI. Kebanyakan template Proxyshop memiliki resolusi 1200 DPI yang jauh lebih tinggi dari yang dibutuhkan siapa pun. Kebanyakan layanan pencetakan tidak mencetak di atas 800 DPI. ( Direkomendasikan : Aktif)

? Panduan Pengaturan (Lingkungan Python)

Menyiapkan lingkungan Python untuk Proxyshop ditujukan untuk pengguna tingkat lanjut, kontributor, dan siapa saja yang ingin mencoba membuat plugin atau templat khusus untuk aplikasi! Panduan ini mengasumsikan Anda sudah menginstal Python. Lihat lencana di atas untuk versi Python yang didukung.

1. Instal Puisi dengan pipx.

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

2. Clone Proxyshop di suatu tempat di sistem Anda, kami akan menyebutnya direktori root .

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

3. Arahkan ke direktori root dan instal lingkungan proyek.

    cd proxyshop
   poetry install

4. Instal font yang disertakan dalam folder fonts/ . Jangan hapus ini setelah instalasi, beberapa digunakan oleh GUI.
5. Buat folder bernama art di direktori root. Di sinilah Anda menempatkan gambar seni untuk kartu yang ingin Anda render.
6. Jalankan aplikasi.

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

7. Lihat panduan penggunaan untuk menavigasi GUI.

? Unduh Template Secara Manual

Jika Anda ingin mengunduh templat secara manual, kunjungi tautan ini. Arsip ini harus diekstraksi ke direktori /templates . Arsip yang ditemukan dalam folder drive Investigamer dan SilvanMTG harus diekstraksi ke /plugins/Investigamer/templates dan /plugins/SilvanMTG/templates .

? Bagaimana saya bisa mendukung Proxyshop?

Jangan ragu untuk bergabung dengan perselisihan kami dan berpartisipasi dalam saluran #Proxyshop tempat kami terus bertukar pikiran dan menguji fitur-fitur baru, merilis rilis beta, dan berbagi plugin dan templat baru. Selain itu, harap pertimbangkan untuk mendukung Patreon kami yang membayar hosting S3 + Cloudfront untuk template Proxyshop dan memberi kami kebebasan untuk mengerjakan aplikasi, serta aplikasi lain seperti MPC Autofill, MTG Art Downloader, dan banyak lagi! Jika Patreon bukan kesukaan Anda, Anda juga dapat membelikan saya kopi melalui Paypal. Terima kasih banyak kepada pendukung kami yang luar biasa!

❓ Pertanyaan Umum

Bagaimana cara mengubah simbol set ke yang lain?

Dalam pengaturan, ubah "Simbol Default" ke kode set simbol yang Anda inginkan, dan aktifkan "Paksa Simbol Default". Jika Anda ingin menambahkan simbol khusus, berikut prosesnya:

• Buka src/img/symbols/ dan buat folder dengan nama sesuai kode khusus baru.
• Tambahkan simbol SVG khusus Anda ke folder yang Anda buat, beri nama setiap file sesuai dengan huruf pertama kelangkaannya (dalam huruf kapital).
• Tetapkan simbol itu sebagai "Simbol Default" dan aktifkan "Paksa Simbol Default". Anda siap berangkat!

Bagaimana cara menyembunyikan simbol set sepenuhnya?

Di Pengaturan Global, atau pengaturan untuk templat tertentu, ubah "Mode Render Simbol" menjadi Tidak Ada. Ini menonaktifkan simbol ekspansi sama sekali.

Bagaimana cara menyembunyikan lapisan di templat Proxyshop agar tidak muncul di kartu yang dirender?

Di template Photoshop pilihan Anda, ubah opacity menjadi 0 pada layer yang ingin Anda sembunyikan. Anda dapat menggunakan metode ini untuk menyembunyikan apa pun. Hal ini lebih aman daripada sekadar menonaktifkan visibilitas lapisan karena lapisan mungkin diaktifkan dan dinonaktifkan secara paksa oleh aplikasi, juga lebih aman daripada menghapus lapisan karena dapat menyebabkan kesalahan pada beberapa templat.

Di mana tempat yang bagus untuk menemukan karya seni MTG berkualitas tinggi?

Sumber daya terbaik Anda adalah MTG Pics, untuk lebih meningkatkan kualitas seni, Anda dapat mempertimbangkan peningkatan dengan Topaz/Chainner/ESRGAN. Dalam perselisihan kami, kami menyediakan banyak sumber daya untuk mempelajari cara meningkatkan seni dengan mudah dan efektif. Untuk mengunduh karya seni secara massal, lihat proyek saya yang lain: MTG Art Downloader

Aplikasi berhenti ketika mencoba memasukkan teks dan Photoshop menjadi tidak responsif!

Ada bug yang diketahui di mana Photoshop mogok ketika mencoba memasukkan terlalu banyak teks ke dalam kotak teks, ini harus diperbaiki tetapi secara teori bisa terjadi pada beberapa templat plugin yang tidak membuat kotak teks cukup besar. Cara terbaik untuk memperbaikinya adalah dengan membuka templat di Photoshop dan memperluas tepi bawah kotak teks Aturan (makhluk dan bukan makhluk).

Nilai yang diperlukan tidak ada/server RPC tidak merespons.

Ini terkadang bisa menjadi salah satu kesalahan yang jarang terjadi namun menjengkelkan yang terjadi pada beberapa sistem. Terkadang penyebab utama tidak diketahui, namun biasanya dapat diperbaiki. Cobalah opsi ini secara berurutan hingga berhasil:

• Pastikan hanya ada SATU instalasi Photoshop di komputer Anda. Menginstal dua versi Photoshop secara bersamaan dapat mencegah koneksi ke aplikasi. Jika Anda menginstal lebih dari satu, hapus instalan semua versi Photoshop dan instal ulang satu versi. Anda harus menghapus instalan semuanya terlebih dahulu , menghapus satu saja kemungkinan besar tidak akan menyelesaikan masalah.
• Pastikan aplikasi Photoshop Anda diinstal menggunakan installer yang sebenarnya. Instalasi portabel Photoshop tidak berfungsi dengan Proxyshop, karena Windows perlu mengetahui di mana lokasinya.
• Tutup Photoshop dan Proxyshop, lalu jalankan Photoshop dan Proxyshop sebagai Administrator, coba render sesuatu.
• Tutup keduanya, lalu tahan ALT + CTRL + SHIFT sambil meluncurkan Photoshop, lalu luncurkan Proxyshop, coba lagi.
• Nyalakan kembali komputer Anda, lalu mulai keduanya dan coba lagi.
• Jika Anda menjalankan perangkat lunak antivirus yang terlalu defensif yang mungkin mengganggu koneksi Proxyshop ke Photoshop, seperti Avast, Norton, dll. tutup perangkat lunak antivirus Anda, luncurkan kembali keduanya, dan coba lagi. Anda juga dapat mencoba menonaktifkan Windows Defender.
• Jika ada kemungkinan instalasi Photoshop Anda rusak, rusak, atau kacau, disarankan untuk menghapus instalasi Photoshop sepenuhnya dan menginstal versi terbaru yang dapat Anda akses. Umumnya, Proxyshop bekerja paling baik dengan versi Photoshop yang lebih baru. Jika menggunakan versi Photoshop yang tidak asli, pastikan versi tersebut berkualitas tinggi dan menggunakan penginstal asli.
• Jika semua cara di atas gagal memperbaiki masalah, silakan bergabung dengan Discord kami (tertaut di atas) dan berikan log kesalahan dari logs/error.txt di direktori Proxyshop Anda, sehingga kami dapat membantu menemukan penyebabnya :)

Biaya Mana, Aturan, atau teks lainnya sangat besar dan tidak berkurang?

• Di Photoshop, buka Edit > Preferensi > Unit & Penggaris .
• Atur Penggaris ke Piksel
• Atur Jenis ke Poin
• Masalah ini harus diperbaiki.

Photoshop sedang sibuk!

Kesalahan ini terjadi ketika Photoshop tidak merespon perintah karena sedang sibuk. Untuk mencegah kesalahan ini, Anda harus memastikan Photoshop dalam keadaan netral ketika Anda menjalankan Proxyshop atau merender kartu:

• Seharusnya tidak ada kotak dialog atau menu pengaturan yang terbuka di Photoshop. Panel alat normal baik-baik saja.
• Seharusnya tidak ada alat yang melakukan tugas, misalnya teks disorot untuk diedit dengan alat teks.
• Idealnya Photoshop harus diluncurkan dalam keadaan segar, tanpa dokumen terbuka.

Saya mendapatkan kesalahan lainnya!

Di direktori proxyshop Anda, cari folder bernama logs , di dalam folder itu Anda akan melihat error.txt , periksa log kesalahan terakhir di file itu. Jika kesalahannya tidak terlihat jelas, bergabunglah dengan Discord kami dan jangan ragu untuk meminta bantuan di saluran #Proxyshop.

Kredit

• Pendukung Patreon kami yang luar biasa yang menjaga proyek ini tetap berjalan.
• Chilli Axe atas proyek Otomasi MTG Photoshopnya yang luar biasa yang menginspirasi Proxyshop, dan untuk memproduksi banyak templat PSD dasar yang telah dimodifikasi agar berfungsi dengan Proxyshop.
• Dukungan template dan aset tambahan dari:
  • SilvanMTG
  • Nelyn
  • Trix untuk Scoot
  • FeuerAmeise
  • michayggdrasil
  • Warpdandy
  • PriaMPC
  • Vittorio Masia
  • iDerp
  • Tupinamba (Pedro Neves)
• Andrew Gioia untuk berbagai proyek fontnya yang pernah digunakan untuk Proxyshop di masa lalu.
• John Prime, Haven King, dan anggota CCGHQ yang menyediakan simbol perluasan SVG.
• Hal dan kontributor lainnya di Photoshop Python API.
• Wizards of the Coast dan semua seniman berbakat yang membuat Magic the Gathering menjadi kenyataan.
• Tak terhitung banyaknya orang lain yang telah memberikan bantuan dan aset lain kepada komunitas yang memungkinkan berbagai fitur.
• Semua kontributor basis kode.