Proxyshop

Proxyshop é um aplicativo de automação do Photoshop que gera renderizações de cartões Magic the Gathering de alta qualidade. Inspirado nos scripts de automação originais do Photoshop de Chilli-Axe. Se precisar de ajuda com este aplicativo ou quiser solucionar um problema, entre em nosso discord!

Requisitos

• Photoshop (compatível com 2017-2024)
• Windows (atualmente incompatível com Mac/Linux)
• Os modelos do Photoshop (podem ser baixados no aplicativo)
• Fontes necessárias (incluídas em fonts/ ):
  • Beleren Proxy Bold — Para nome de cartão, tipo de linha, potência/resistência
  • Proxyglyph — Para símbolos de mana, um fork da fonte NDPMTG da Chilli
  • Plantin MT Pro — Para texto de regras, instale todas as variantes incluídas
  • Beleren Smallcaps — Para linha de crédito de artista e diversos
  • Gotham Medium – Para texto de colecionador
• Fontes opcionais (mas recomendadas):
  • Magic The Gathering – exigido pelo modelo clássico
  • Matrix Bold – exigido pelo modelo Colorshifted
  • Mana — Para vários símbolos de cartas adicionais

Guia de configuração

1. Baixe a versão mais recente e extraia-a para uma pasta de sua escolha.
2. Instale as fontes incluídas na pasta fonts/ , observe que Proxyglyph pode precisar ser atualizado em versões futuras.
3. Coloque as artes dos cartões que você deseja renderizar na pasta art/ . Essas artes devem ser nomeadas de acordo com o cartão (veja Nomenclatura de Arquivos de Arte para mais informações).
4. Inicie Proxyshop.exe . Clique no botão Atualizar . O Proxyshop carregará modelos disponíveis para download, pegue o que quiser.
5. Clique em Render All para renderizar todas as artes dos cartões na pasta art/ . Clique em Render Target para renderizar uma ou mais artes de cartão específicas.
6. Você também pode arrastar imagens artísticas ou pastas contendo imagens artísticas para o aplicativo Proxyshop, o Proxyshop começará a renderizar automaticamente esses cartões.
7. Durante o processo de renderização, o console na parte inferior exibirá o progresso atual e avisará se ocorrer alguma falha.

? Nomenclatura de arquivos de arte

• Os tipos de arquivos artísticos atualmente suportados são: jpg , jpeg , jpf , png , tif e webp . NOTA : webp requer Photoshop 2022+.
• Os arquivos de arte devem ter nomes de cartas reais de Magic the Gathering e devem ser nomeados com a maior precisão possível, por exemplo, Damnation.jpg .
• O Proxyshop suporta diversas tags opcionais ao nomear seus arquivos de arte, para lhe dar mais controle sobre como o cartão é renderizado!
  • Set [SET] — Força o Photoshop a renderizar uma versão desse cartão a partir de uma expansão MTG específica que corresponda ao código do conjunto fornecido. Esta tag não diferencia maiúsculas de minúsculas, então tanto "set" quanto "SET" funcionarão.

   Damnation [TSR].jpg
  

  • Número do coletor {num} — Funciona apenas se a tag Set também tiver sido fornecida, renderize uma versão desse cartão com o código exato do conjunto e a combinação de números . Isto é particularmente útil em casos onde um conjunto possui múltiplas versões da mesma carta, por exemplo Secret Lair (SLD) possui 3 versões diferentes de Brainstorm .

   Brainstorm [SLD] {175}.jpg
  

  • Nome do Artista (Artist Name) — Ao preencher o nome do artista, o Proxyshop substituirá o nome presente nos dados do Scryfall pelo nome que você fornecer. Esta mudança é puramente cosmética e não afeta a forma como o cartão é obtido, nem entra em conflito com outras etiquetas.

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

  • Nome do Criador $Creator Name — Esta tag não é amplamente suportada pelos modelos padrão do Proxyshop. Esta tag permite que você insira seu nome preferido como usuário/designer/criador e, se o modelo suportar o recurso de nome do criador, esse texto será colocado em uma camada de texto especificada. Pode ser usado como uma espécie de assinatura para o seu trabalho. NOTA : Esta tag DEVE ser colocada no FINAL do nome do arquivo de arte.

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

Usando a GUI do Proxyshop

Guia Renderizar Cartões

• A guia principal para renderizar cartas autênticas de Magic the Gathering.
• Renderizar tudo : Renderiza uma imagem de cartão usando cada imagem artística encontrada na pasta art/ .
• Destino de renderização : abre a seleção de arquivo no Photoshop, renderiza uma imagem de cartão usando cada imagem artística selecionada.
• Configurações globais : abre um painel de configurações usado para alterar as opções de todo o aplicativo para:
  • Configurações principais : Afeta o comportamento do modelo, pode ser modificado para modelos individuais. Quando você clica no ícone próximo a um modelo, um arquivo de configuração é gerado para esse modelo que substitui essas configurações.
  • Configurações do sistema : Afetam todo o aplicativo e não podem ser alteradas para modelos individuais.
• O conjunto de guias abaixo desses botões representa tipos de modelos , por exemplo, Normal, MDFC, Transformar, etc.
  • Os tipos de modelo representam diferentes tipos de modelos que requerem diferentes elementos de quadro ou diferentes técnicas de renderização.
  • Se a guia Normal estiver ativa e você clicar em um botão de modelo, esse modelo será selecionado para o tipo de modelo Normal . Cartões que correspondem ao tipo Normal agora serão renderizados usando esse modelo.
  • Esse modelo NÃO é selecionado para outros tipos. Por exemplo, se Sem borda estiver selecionado na guia Normal , mas Normal estiver selecionado na guia MDFC . Os cartões que correspondem ao tipo MDFC serão renderizados usando Normal MDFC .
• Ao lado de cada modelo na lista de modelos existem dois ícones:
  • Permite alterar as configurações principais deste modelo. Alguns modelos também terão suas próprias configurações especialmente projetadas que você também pode alterar.
  • ? Exclui o arquivo de configuração separado gerado para este modelo, retornando efetivamente este modelo às configurações padrão. Garante que as configurações principais deste modelo sejam controladas pelo painel Configurações globais .
• A área cinza escuro abaixo do seletor de modelos é o Console , onde as mensagens de status serão exibidas acompanhando o progresso da renderização e outras ações do usuário.
• À direita do Console estão alguns botões úteis:
  • ? Fixa a janela do Proxyshop, para que ela permaneça acima de todos os outros programas em execução
  • ? Faz uma captura de tela da janela do Proxyshop e salva em: out/screenshots/
  • ? Abre seu navegador padrão, navegando até a página GitHub do Proxyshop
  • ❔ Abre seu navegador padrão, navegando até nosso servidor Discord da comunidade
  • Continuar : fica ativo quando o aplicativo está aguardando uma resposta do usuário, seja quando a edição manual está habilitada ou quando ocorreu um erro.
  • Cancelar : Torna-se ativo quando os cartões estão sendo renderizados, pode cancelar a operação de renderização a qualquer momento ou se ocorrer um erro.
  • Atualizar : abre o painel Atualizador que permite baixar novos modelos e atualizar os existentes.

Guia Criador Personalizado

• Esta guia controla o criador do cartão personalizado.
• Este recurso é atualmente considerado beta experimental e pode apresentar problemas.
• Atualmente você pode renderizar cartas Normal , Planeswalker ou Saga , basta preencher os dados apropriados e clicar em Renderizar Personalizado .
• Mais recursos e tipos de cartão serão adicionados em um futuro próximo.

Guia Ferramentas

• Esta guia contém uma lista crescente de ferramentas e utilitários úteis.
• Renderizar todos os mostruários : gera uma imagem de mostruário com borda para cada imagem de cartão na pasta out/ , os mostruários serão colocados em out/showcase/ .
• Render Target Showcase : Abre uma seleção de arquivo no Photoshop, gera uma imagem de exibição com borda para cada imagem de cartão selecionada.
• Compactar renderizações : esta ferramenta reduz o tamanho das imagens do cartão armazenadas na pasta out/ . As configurações são:
  • Qualidade : Qualidade de salvamento JPEG da imagem compactada, suporta um número entre 1 e 100. ( Recomendado : 95-99)
  • Otimizar : ativa o sinalizador automático de "otimização" do Pillow. Reduz o tamanho do arquivo em uma pequena margem sem nenhuma desvantagem perceptível. ( Recomendado : ativado)
  • 800 DPI : Reduz imagens de cartão acima de 800 DPI para um máximo de 800 DPI. A maioria dos modelos do Proxyshop tem 1200 DPI, o que é muito mais alto do que alguém realmente precisa. A maioria dos serviços de impressão não imprime acima de 800 DPI. ( Recomendado : ativado)

? Guia de configuração (ambiente Python)

A configuração do ambiente Python para Proxyshop é destinada a usuários avançados, colaboradores e qualquer pessoa que queira colocar a mão na massa criando um plugin ou modelo personalizado para o aplicativo! Este guia pressupõe que você já tenha o Python instalado. Veja o emblema acima para ver as versões Python suportadas.

1. Instale Poesia com pipx.

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

2. Clone o Proxyshop em algum lugar do seu sistema, chamaremos isso de diretório raiz .

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

3. Navegue até o diretório raiz e instale o ambiente do projeto.

    cd proxyshop
   poetry install

4. Instale as fontes incluídas na pasta fonts/ . Não os exclua após a instalação, alguns são usados ​​pela GUI.
5. Crie uma pasta chamada art no diretório raiz. É aqui que você coloca imagens artísticas dos cartões que deseja renderizar.
6. Execute o aplicativo.

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

7. Consulte o guia de uso para navegar na GUI.

? Baixe modelos manualmente

Caso queira baixar os templates manualmente, acesse este link. Esses arquivos devem ser extraídos para o diretório /templates . Os arquivos encontrados nas pastas da unidade Investigamer e SilvanMTG devem ser extraídos para /plugins/Investigamer/templates e /plugins/SilvanMTG/templates respectivamente.

? Como posso apoiar o Proxyshop?

Sinta-se à vontade para se juntar ao nosso discord e participar do canal #Proxyshop , onde estamos constantemente debatendo e testando novos recursos, lançando versões beta e compartilhando novos plug-ins e modelos. Além disso, considere apoiar nosso Patreon, que paga pela hospedagem S3 + Cloudfront de modelos Proxyshop e nos permite a liberdade de trabalhar no aplicativo, bem como em outros aplicativos como MPC Autofill, MTG Art Downloader e muito mais! Se Patreon não é sua praia, você também pode me comprar um café via Paypal. Muito obrigado aos nossos incríveis apoiadores!

❓ Perguntas frequentes

Como altero o símbolo definido para outro?

Nas configurações, altere "Símbolo Padrão" para o código definido do símbolo desejado e ative "Forçar Símbolo Padrão". Se você deseja adicionar um símbolo totalmente personalizado, este é o processo:

• Vá para src/img/symbols/ e crie uma pasta nomeada de acordo com um novo código personalizado.
• Adicione seus símbolos SVG personalizados à pasta que você criou, nomeie cada arquivo de acordo com a primeira letra de sua raridade (maiúscula).
• Defina esse símbolo como "Símbolo padrão" e habilite "Forçar símbolo padrão". Você está pronto para ir!

Como escondo completamente o símbolo definido?

Nas configurações globais ou nas configurações de um modelo específico, altere "Modo de renderização de símbolos" para Nenhum. Isso desativa completamente o símbolo de expansão.

Como ocultar uma camada em um modelo do Proxyshop para que ela não apareça nos cartões renderizados?

No modelo do Photoshop de sua escolha, altere a opacidade para 0 na camada que deseja ocultar. Você pode usar este método para ocultar qualquer coisa. Isso é mais seguro do que apenas desabilitar a visibilidade da camada porque as camadas podem ser habilitadas e desabilitadas à força pelo aplicativo, também é mais seguro do que excluir a camada porque isso pode causar erros em alguns modelos.

Onde é um bom lugar para encontrar arte MTG de alta qualidade?

Seu melhor recurso será MTG Pics, para melhorar ainda mais a qualidade da arte você pode tentar aumentar a escala com Topaz/Chainner/ESRGAN. Em nosso discord, fornecemos muitos recursos para aprender como aprimorar a arte de maneira fácil e eficaz. Para download em massa de arte, veja meu outro projeto: MTG Art Downloader

O aplicativo para ao tentar inserir texto e o Photoshop não responde!

Há um bug conhecido em que o Photoshop trava ao tentar inserir muito texto em uma caixa de texto. Ele deveria ser corrigido, mas teoricamente poderia acontecer em alguns modelos de plug-in que não tornam a caixa de texto grande o suficiente. A melhor maneira de corrigir isso é abrir o modelo no Photoshop e expandir a borda inferior das caixas de texto Regras (criatura e não criatura).

O valor obrigatório está ausente/o servidor RPC não está respondendo.

Às vezes, esse pode ser um dos erros mais raros, mas desagradáveis, que ocorrem em alguns sistemas. Às vezes, a causa raiz é desconhecida, mas geralmente pode ser corrigida. Experimente estas opções em ordem até que algo funcione:

• Certifique-se de que haja apenas UMA instalação do Photoshop em seu computador. Ter duas versões do Photoshop instaladas ao mesmo tempo pode impedir a conexão com o aplicativo. Se você tiver mais de um instalado, desinstale todas as versões do Photoshop e reinstale uma versão. Você deve desinstalar todos eles primeiro , apenas remover um provavelmente não resolverá o problema.
• Certifique-se de que seu aplicativo Photoshop foi instalado usando um instalador real. As instalações portáteis do Photoshop não funcionam com o Proxyshop, pois o Windows precisa saber onde ele está localizado.
• Feche o Photoshop e o Proxyshop, execute o Photoshop e o Proxyshop como administrador e tente renderizar algo.
• Feche ambos, segure ALT + CTRL + SHIFT ao iniciar o Photoshop, depois inicie o Proxyshop e tente novamente.
• Reinicie o computador, inicie ambos e tente novamente.
• Se você tiver um software antivírus particularmente defensivo em execução que possa estar interferindo na conexão do Proxyshop ao Photoshop, como Avast, Norton, etc., feche o software antivírus, reinicie ambos e tente novamente. Você também pode tentar desabilitar o Windows Defender.
• Se houver uma chance de sua instalação do Photoshop estar danificada, corrompida ou bagunçada de alguma forma, é recomendável desinstalar completamente o Photoshop e instalar a versão mais recente à qual você tem acesso. Geralmente, o Proxyshop funciona melhor com versões mais recentes do Photoshop. Se estiver usando uma versão autêntica do Photoshop, verifique se ela é de alta qualidade e se usa um instalador real.
• Se tudo isso não resolver o problema, entre em nosso Discord (link na parte superior) e forneça o log de erros de logs/error.txt em seu diretório Proxyshop, para que possamos ajudar a encontrar a causa :)

Custo de mana, regras ou outro texto é enorme e não está diminuindo?

• No Photoshop vá em Edit > Preferences > Units & Rulers .
• Definir réguas para pixels
• Definir tipo para pontos
• O problema deve ser corrigido.

O Photoshop está ocupado!

Este erro ocorre quando o Photoshop não responde aos comandos porque está ocupado. Para evitar esse erro, você deve garantir que o Photoshop esteja em um estado neutro ao executar o Proxyshop ou renderizar um cartão:

• Não deve haver caixas de diálogo ou menus de configurações abertos no Photoshop. Os painéis de ferramentas normais estão bem.
• Não deve haver ferramentas executando tarefas, por exemplo, destacar texto para edição com a ferramenta de texto.
• Idealmente, o Photoshop deve ser iniciado do zero, sem nenhum documento aberto.

Estou recebendo outro erro!

No diretório proxyshop, procure uma pasta chamada logs , dentro dessa pasta você deverá ver error.txt , verifique o último log de erros nesse arquivo. Se o erro não for óbvio, entre no nosso Discord e fique à vontade para pedir ajuda no canal #Proxyshop.

Créditos

• Nossos incríveis apoiadores do Patreon que literalmente mantêm este projeto em andamento.
• Chilli Axe por seu excelente projeto MTG Photoshop Automation no qual o Proxyshop se inspirou e por produzir muitos dos modelos PSD básicos que foram modificados para funcionar com o Proxyshop.
• Modelo adicional e suporte a ativos de:
  • SilvanMTG
  • Nelynes
  • Trix são para Scoot
  • FeuerAmeise
  • michayggdrasil
  • Warpdandy
  • MasculinoMPC
  • Vittorio Masia
  • iDerp
  • Tupinambá (Pedro Neves)
• Andrew Gioia por seus vários projetos de fontes que foram úteis para o Proxyshop no passado.
• John Prime, Haven King e membros do CCGHQ por fornecerem SVGs de símbolos de expansão.
• Hal e os outros colaboradores da Photoshop Python API.
• Wizards of the Coast e todos os artistas talentosos que tornam Magic the Gathering uma realidade.
• Inúmeras outras pessoas que forneceram ajuda e outros recursos à comunidade que tornaram possíveis vários recursos.
• Todos os contribuidores da base de código.