DG FARM — IMAGENS E ADESIVOS — VERSÃO 0.5.0 — FS25 PC / JOGO SOLO

IDIOMAS
A interface acompanha automaticamente o idioma configurado no jogo.
Esta versão inclui inglês e português brasileiro. Quando não houver uma
tradução para o idioma selecionado, o FS25 utiliza o inglês como padrão.
Este é o manual em português. O manual em inglês é README_EN.txt.

INSTALAÇÃO E PRIMEIRO TESTE
1. Substitua o ZIP anterior por FS25_DGFarmDecalStudio.zip na pasta:
   Documentos\My Games\FarmingSimulator2025\mods
   Mantenha o nome. Não deixe duas versões do mod instaladas.
2. Reinicie o FS25 e ative o mod na partida.
3. A pé, mire em um veículo, carreta ou implemento a até 15 metros e use
   Ctrl+F8. Também é possível abrir o editor de dentro de um veículo parado.
4. O painel mostra e mantém travado o alvo escolhido. F9 adiciona imagem.
5. F11 percorre as imagens disponíveis no catálogo.
6. F6 escolhe o ajuste. A pé, a roda do mouse altera seu valor.
7. Dentro do veículo, use Ctrl + roda para editar sem conflitar com o zoom.
   Use Shift junto com a roda para o ajuste fino.
8. Ctrl+F8 fecha. Salve o jogo normalmente e recarregue para conferir.

CONTROLES
Ctrl+F8: abrir/fechar editor
Com o painel aberto, os demais atalhos não precisam de Ctrl:
F9: adicionar imagem (até 20 por veículo)
F10: remover imagem selecionada
F7: selecionar próxima imagem já aplicada no veículo
F11: trocar arte da imagem selecionada
F6: percorrer ajustes
A pé: roda para cima/baixo altera; Shift + roda faz ajuste fino
No veículo: Ctrl + roda altera; Ctrl + Shift + roda faz ajuste fino
PageUp/PageDown: alternativa pelo teclado

SELEÇÃO DO ALVO NA VERSÃO 0.4.0
Estando a pé, olhe diretamente para a lataria ou estrutura física do veículo,
carreta ou implemento e pressione Ctrl+F8. O alcance máximo é de 15 metros.
O nome do alvo aparece no painel e permanece travado enquanto o editor estiver
aberto, permitindo caminhar ao redor dele sem trocar de alvo acidentalmente.
Ao adicionar uma imagem a pé, ela nasce próxima ao ponto que estava sob a mira.
Feche e abra o editor novamente para selecionar outro objeto.
Se entrar em um veículo durante a edição a pé, o editor será fechado por segurança.
Dentro de um veículo, a seleção normal do jogo continua sendo respeitada.

AJUSTES
Lateral X, altura Y, frente/trás Z, inclinação X, rotação Y, rotação Z,
tamanho, componente físico e proporção largura/altura.
O ajuste de tamanho define a largura em metros.
Proporção 1 = quadrada (1:1); 2 = retangular (2:1); 4 = comprida (4:1);
0,5 = vertical (1:2). Altura = largura / proporção.
F11 usa a proporção configurada da nova arte; pode ajustar depois.

POSIÇÃO INICIAL
As novas imagens têm largura de 60 cm e nascem na lateral, mais à frente.
O mod usa o ponto de entrada na cabine quando ele está disponível;
caso contrário, estima a posição pela dimensão do veículo. O ponto
pode variar por modelo: use X, Y e Z para acertar a porta desejada.
A posição inicial não muda imagens que você já colocou e salvou.
As imagens são planas: deixe alguns milímetros de distância da carroceria.
Para a lateral oposta, ajuste X para negativo e rotação Y para -90 graus.
“Componente” escolhe partes físicas de veículos articulados; não identifica
portas animadas nem se adapta sozinho às curvas da carroceria.

ADICIONAR SUAS IMAGENS DEPOIS — SEM ALTERAR O LUA
Abra o ZIP do mod e coloque suas imagens na pasta imagens, ao lado do
catalogo.xml. Você pode extrair, editar e compactar novamente: modDesc.xml
precisa ficar na raiz do ZIP. Remova a pasta extraída da pasta mods depois.

OPÇÃO SIMPLES
Nomeie os arquivos imagem01.png, imagem02.png ... imagem20.png.
O mod procura esses nomes ao carregar a partida. Também procura as
mesmas numerações em .dds e .jpg. A proporção inicial é 2:1; escolha
“Proporção” com F6 para adaptar à sua imagem.

OPÇÃO COM NOME LIVRE E PROPORÇÃO CONFIGURADA
Edite imagens/catalogo.xml e adicione dentro de <imagens>:
<imagem arquivo="minha_logo.png" nome="Logo da fazenda" largura="512" altura="512"/>
<imagem arquivo="minha_placa.png" nome="Minha plaquinha" largura="1024" altura="256"/>
Não coloque as linhas dentro dos comentários <!-- -->.
Copie os arquivos para imagens. Use nomes sem acentos e sem caracteres
especiais. Arquivos ausentes são ignorados. Reinicie o jogo após adicionar.
A lista do catálogo aparece primeiro; arquivos numerados entram depois.
O pacote inclui logos fictícios de fazendas, identificação Raízen, placas de
segurança, Diesel S10, sinalização, bandeira do Brasil e faixa refletiva.
As placas reproduzem o estilo visual padronizado para uso dentro do jogo;
não substituem sinalização certificada nem devem ser usadas como referência real.
As imagens salvas são identificadas pelo nome do arquivo, para não trocar
acidentalmente de desenho ao mudar a ordem do catálogo.
Se remover uma imagem usada, o mod mostra uma arte de teste no seu lugar;
recolocar o arquivo com o mesmo nome permite restaurar a arte original.

PROPORÇÕES RECOMENDADAS — LARGURA × ALTURA EM PIXELS
1:1  — 512 × 512 — logo quadrada
2:1  — 1024 × 512 — logo ou placa retangular
4:1  — 1024 × 256 — plaquinha comprida
1:2  — 512 × 1024 — imagem vertical
PNG com transparência para recortes; JPG para fundo sólido.
DDS também pode ser usado. PNG/JPG personalizados usam o carregador
de textura do jogo; a compatibilidade visual precisa ser confirmada
no teste. Se uma imagem falhar, confira o log e tente uma textura DDS
exportada para FS25. Não há conversor de imagem embutido.

GRAVAÇÃO E COMPATIBILIDADE
As versões 0.1 e 0.2 continuam compatíveis: proporção antiga = 2:1.
A versão 0.3.1 grava as imagens junto de cada veículo no vehicles.xml
do save e mantém dgFarmDecals.xml como cópia de compatibilidade.
A leitura acontece antes de o jogo descartar os dados de carregamento
do veículo. Sair sem salvar descarta alterações recentes.
Adesivos de versões anteriores são importados do antigo danielDecals.xml, quando ele existir.
Se a versão anterior não gravou os adesivos, será preciso aplicá-los novamente.
Nenhum arquivo dos mods de veículos é reescrito.
A atualização não inclui placas com espessura, suporte ou física.
Não há suporte a console nem multiplayer. Atalhos fixos podem coincidir
com outros mods.

VERIFICAÇÃO
Lua, XML e ZIP foram verificados fora do jogo. A lógica foi exercitada
com funções simuladas. A versão inicial foi testada pelo usuário no FS25;
essas novas funções ainda precisam de confirmação no jogo. Não há FS25
ou GIANTS Editor instalado no ambiente de desenvolvimento.
Se não funcionar, envie uma captura, o modelo do veículo e:
Documentos\My Games\FarmingSimulator2025\log.txt
As mensagens do mod começam com [DGFarmDecalStudio].

CRIADOR: DG Farm

PAINEL DE INSTRUÇÕES
NOVIDADE 0.5.0 — NOVA IDENTIDADE VISUAL
O editor ganhou um painel totalmente redesenhado com a identidade da DG Farm:
logo oficial, fundo grafite, destaques no verde da marca e informações separadas
em cartões de posição, rotação e escala. O ajuste selecionado recebe destaque,
e todos os atalhos ficam organizados na faixa inferior. Com o painel aberto,
F6, F7, F9, F10 e F11 funcionam sem Ctrl. A pé, a roda também funciona sem Ctrl;
dentro do veículo, Ctrl + roda preserva o controle de zoom. As funções e os
arquivos salvos pela versão 0.4.0 foram mantidos compatíveis.

NOVIDADE 0.4.0 — EDIÇÃO A PÉ
Agora é possível selecionar carretas, implementos, tratores e caminhões mirando
neles a pé. Isso permite editar objetos em que o jogador não consegue entrar.
O alvo selecionado aparece no painel e fica travado durante a edição. A edição
tradicional de dentro do veículo foi mantida. A seleção usa a câmera do jogador
e a estrutura física registrada pelo FS25; alguns mods com colisões incomuns
podem exigir mirar em outra parte do objeto.

CORREÇÃO 0.3.2 — ADESIVOS SOBREPOSTOS
A restauração automática não recria imagens de veículos já editados
e respeita uma lista vazia após a remoção dos adesivos.
Depois de substituir o ZIP, reinicie o jogo para descartar as cópias
visuais que a versão anterior deixou na sessão.
Teste: aplique duas imagens, salve, ande, remova as duas e confira
que não restou nenhuma. Salve e recarregue para conferir novamente.
