BlockReel textures
Trabalhe na pasta BlockReel. Coloque cada conjunto em work/textures/<nome>/ (ignorado pelo git) ou films/<nome>/textures/. A pasta espelha assets/minecraft/textures/ (block/…, item/…). Nunca copie texturas do jogo; apenas originais (o conjunto de demonstração do repositório é CC0).
1. Briefing (no máximo uma pergunta curta)
Defina: tema (ex.: pastel cartoon, medieval sombrio, nevado), resolução (16x padrão, 32x ou 64x), quais blocos e itens (padrão: um conjunto inicial de ~25: pedra, pedregulho, terra, topo/lado da grama, tábuas, tronco, folhas, areia, vidro, água, lava, tijolos, obsidiana, glowstone, neve, lã, minérios/blocos de metal, TNT, mais 1-2 itens), e a versão Java alvo (necessária para o formato do pack; pergunte se desconhecida).
2. Pesquisa (web), escrita em research.md com links
- Nomes oficiais dos arquivos de textura para a versão alvo: os nomes são o contrato; um nome errado é silenciosamente ignorado. Consulte Minecraft Wiki: Resource pack e a lista de arquivos da versão (o usuário pode abrir seu próprio
.jardo cliente,assets/minecraft/textures/, para listar nomes; nunca copie os arquivos). - Texturas animadas: uma imagem PNG em tira vertical mais um arquivo adjacente
<nome>.png.mcmeta, ex.:water_still.png.mcmeta:{ "animation": { "frametime": 3, "interpolate": true } }; opcionalmentewidth,height(tamanho do quadro) eframes. Cada quadro deve ter o mesmo tamanho e a imagem deve ter um número inteiro de quadros (fonte: a página Resource pack da Wiki). - Convenções de emenda: texturas de bloco são quadradas; elas se repetem, então as bordas devem se encaixar. Os topos dos blocos de terreno se repetem mais.
- O formato do pack para a versão do usuário: Minecraft Wiki: Pack format, a coluna resource pack. Cite a versão, o número e o link na sua resposta. Desde 25w31a (Java 1.21.9) a wiki diz que os packs usam
min_format/max_formatem vez depack_format. Nunca adivinhe o número. Versões listadas com decimal (como97.1) não são suportadas porcore/pack.py(como escrevê-las empack.mcmetanão foi confirmado); informe o usuário. - Referências de estilo para o tema (paletas, como outros lidam com ruído de emenda). Apenas princípios.
3. Plano de paleta e estilo para TODO o conjunto
Antes de desenhar qualquer coisa: um plano de paleta global (uma cor base por material, cada uma com uma rampa de 4 tons com um leve deslocamento de matiz: skin.ramp), as regras de estilo (tons planos com faixas vs. gradientes suaves, contornos ou não, quantos acentos de pixel único por tile), e a escala de ruído (quão grandes são as manchas em relação ao tile). Toda textura segue as mesmas regras; é isso que torna um conjunto coerente.
4. Gerar ou pintar
- Por código (preferido para tiles): comece a partir de
examples/texture-pack-demo/make_textures.py(semeado, tileable por construção: ruído com wrap-around, células Voronoi com wrap, tábuas escalonadas, chanfros, tiras animadas). AlterePLANe os padrões. - À mão, pixel a pixel, para texturas heroicas (ícones de itens, minérios).
- Texturas laterais (
grass_block_side), vidro e blocos de metal têm bordas por design; elas não se emendam.
5. Verificação (OBRIGATÓRIA)
python core/tilecheck.py check block/stone.png --out stone_tiles.png # Pré-visualização de emenda 2x2 e 3x3 + pontuação de costura
python core/tilecheck.py palette block/stone.png -k 6 # Cores dominantes
python core/tilecheck.py set textures/ --out report/ # Conjunto inteiro: PROBLEMAS, notas, folha de contato
python core/pack.py check textures/ # Nomes, tamanhos, tiras de animação
Abra as imagens (stone_tiles.png, report/set-sheet.png) e olhe. PROBLEMAS (costura visível em uma textura de emenda, tamanhos misturados, muitas cores) devem ser corrigidos; notas (brilho, saturação, sobreposição de paleta) são prompts para olhar mais de perto, não erros. Texturas emolduradas são relatadas como notas. Itere pelo menos uma vez: corrija o que viu, regenere, olhe novamente.
6. Pré-visualização em uma cena (OBRIGATÓRIA)
python tools/pack_preview.py textures/ --out pack-preview.png
Um mini-mundo renderizado pelo motor de filme com suas texturas: terreno grande (repetição), uma galeria de blocos, uma cabana, uma árvore, água, lava, vidro e um personagem para escala. Observe: repetição em superfícies grandes, topos vs. laterais de grama e troncos, transparência (vidro, folhas), contraste entre vizinhos e a atmosfera sob luz solar. Blocos ausentes do seu conjunto são listados (os originais embutidos são usados para eles).
7. Construir o pack
python core/pack.py build textures/ --name "Meu Pack" --pack-format <N> --format-version <versão java> \
--format-source https://minecraft.wiki/w/Pack_format --icon pack.png --out build/
# Java 1.21.9 e mais recentes: --min-format <N> --max-format <M> em vez de --pack-format
O comando se recusa a executar sem um número de formato (não há padrão propositalmente). pack.mcmeta fica na raiz do ZIP, e um README.txt no pack registra o número, a versão e o link da fonte. Cite esse link na sua resposta.
8. Lista de verificação para instalação e teste (forneça ao usuário; VOCÊ não pôde testar no jogo)
- Copie o
.zippara a pastaresourcepacksdo jogo (Opções → Resource Packs → Abrir Pasta do Pack mostra onde). - Ative-o em Opções → Resource Packs. Se o jogo disser que o pack é incompatível, o número do formato não corresponde à versão do jogo.
- Verifique em um mundo criativo: grama/terra/pedra/tábuas/troncos/folhas, animação de água e lava, transparência do vidro, TNT, um piso plano 20x20 de cada bloco principal (costuras) e alguns itens.
- Relate qualquer coisa que mostre o verificador roxo/preto: isso significa um nome de arquivo errado ou um tamanho de quadro inválido.
Regras
- Nunca afirme que o pack funciona no jogo. Diga "construído, verificado e pré-visualizado no motor BlockReel".
- Nunca commite texturas do jogo. Não as pegue do
.jardo usuário para o repositório. - Skins são uma coisa diferente (
blockreel-skins); um resource pack não pode alterar a skin do jogador. - Modelos, sons, fontes e shaders estão fora do escopo.