ViniciusNoetzold/blockreel-textures

Texturas BlockReel

Trabaja en la carpeta BlockReel. Coloca cada conjunto en work/textures/<nombre>/ (en gitignore) o films/<nombre>/textures/. La carpeta refleja assets/minecraft/textures/ (block/…, item/…). Nunca copies texturas del juego; solo originales (el conjunto de demostración del repositorio es CC0).

1. Briefing (como máximo una pregunta corta)

Define: tema (ej. caricatura pastel, medieval sombrío, nevado), resolución (16x por defecto, 32x o 64x), qué bloques y objetos (por defecto: un conjunto inicial de ~25: piedra, roca, tierra, parte superior/lateral de césped, tablones, tronco, hojas, arena, vidrio, agua, lava, ladrillos, obsidiana, piedra luminosa, nieve, lana, menas/bloques de metal, TNT, más 1-2 objetos), y la versión de Java objetivo (necesaria para el formato del paquete; pregunta si se desconoce).

2. Investigación (web), escrita en research.md con enlaces

• Nombres oficiales de archivos de textura para la versión objetivo: los nombres son el contrato; un nombre incorrecto se ignora silenciosamente. Consulta Minecraft Wiki: Resource pack y la lista de archivos de la versión (el usuario puede abrir su propio .jar del cliente, assets/minecraft/textures/, para listar los nombres; nunca copies los archivos).
• Texturas animadas: un PNG de tira vertical más un archivo acompañante <nombre>.png.mcmeta, ej. water_still.png.mcmeta: { "animation": { "frametime": 3, "interpolate": true } }; opcional width, height (tamaño del fotograma) y frames. Cada fotograma debe tener el mismo tamaño y la imagen debe contener un número entero de fotogramas (fuente: la página de Resource pack de la Wiki).
• Convenciones de mosaico: las texturas de bloques son cuadradas; se repiten, por lo que los bordes deben encajar. Las partes superiores de los bloques de terreno son las que más se repiten.
• El formato del paquete para la versión del usuario: Minecraft Wiki: Pack format, la columna resource pack. Cita la versión, el número y el enlace en tu respuesta. Desde 25w31a (Java 1.21.9) la wiki dice que los paquetes usan min_format / max_format en lugar de pack_format. Nunca adivines el número. Las versiones listadas con un decimal (como 97.1) no son compatibles con core/pack.py (no se ha confirmado cómo escribirlas en pack.mcmeta); informa al usuario.
• Referencias de estilo para el tema (paletas, cómo otros manejan el ruido de mosaico). Solo principios.

3. Plan de paleta y estilo para TODO el conjunto

Antes de dibujar nada: un plan de paleta global (un color base por material, cada uno con una rampa de 4 tonos con un ligero cambio de tono: skin.ramp), las reglas de estilo (tonos planos con bandas vs degradados suaves, contornos o no, cuántos acentos de un solo píxel por mosaico), y la escala del ruido (qué tan grandes son las manchas en relación con el mosaico). Cada textura sigue las mismas reglas; eso es lo que hace que un conjunto sea coherente.

4. Generar o pintar

• Por código (preferido para mosaicos): partir de examples/texture-pack-demo/make_textures.py (con semilla, se puede poner en mosaico por construcción: ruido de ajuste continuo, celdas de Voronoi de ajuste continuo, tableros escalonados, biseles, tiras animadas). Cambia PLAN y los patrones.
• A mano, píxel a píxel, para texturas principales (iconos de objetos, menas).
• Las texturas laterales (grass_block_side), los bloques de vidrio y metal tienen bordes por diseño; no se colocan en mosaico.

5. Verificación (OBLIGATORIO)

python core/tilecheck.py check block/stone.png --out stone_tiles.png   # vista previa de mosaico 2x2 y 3x3 + puntuación de costura
python core/tilecheck.py palette block/stone.png -k 6                  # colores dominantes
python core/tilecheck.py set textures/ --out report/                   # conjunto completo: PROBLEMAS, notas, hoja de contacto
python core/pack.py check textures/                                    # nombres, tamaños, tiras de animación

Abre las imágenes (stone_tiles.png, report/set-sheet.png) y míralas. Los PROBLEMAS (costura visible en una textura de mosaico, tamaños mezclados, demasiados colores) deben solucionarse; las notas (brillo, saturación, superposición de paleta) son indicaciones para mirar más de cerca, no errores. Las texturas enmarcadas se informan como notas. Itera al menos una vez: arregla lo que viste, regenera, vuelve a mirar.

6. Vista previa en una escena (OBLIGATORIO)

python tools/pack_preview.py textures/ --out pack-preview.png

Un mini-mundo renderizado por el motor de la película con tus texturas: terreno grande (repetición), una galería de bloques, una cabaña, un árbol, agua, lava, vidrio y un personaje para escala. Observa: repetición en superficies grandes, partes superiores vs laterales de césped y troncos, transparencia (vidrio, hojas), contraste entre vecinos y el ambiente bajo la luz solar. Los bloques que faltan en tu conjunto se listan (los originales incorporados se usan para ellos).

7. Construir el paquete

python core/pack.py build textures/ --name "Mi Paquete" --pack-format <N> --format-version <versión de java> \
  --format-source https://minecraft.wiki/w/Pack_format --icon pack.png --out build/
# Java 1.21.9 y posteriores:  --min-format <N> --max-format <M>   en lugar de --pack-format

El comando se niega a ejecutarse sin un número de formato (no hay valor predeterminado a propósito). pack.mcmeta se encuentra en la raíz del zip, y un README.txt en el paquete registra el número, la versión y el enlace de la fuente. Cita ese enlace en tu respuesta.

8. Lista de verificación de instalación y prueba (pásala al usuario; TÚ no pudiste probarlo en el juego)

1. Copia el .zip en la carpeta resourcepacks del juego (Opciones → Paquetes de recursos → Abrir carpeta de paquetes muestra dónde).
2. Actívalo en Opciones → Paquetes de recursos. Si el juego dice que el paquete es incompatible, el número de formato no coincide con la versión del juego.
3. Verifica en un mundo creativo: césped/tierra/piedra/tablones/troncos/hojas, animación de agua y lava, transparencia del vidrio, TNT, un piso plano de 20x20 de cada bloque principal (costuras), y algunos objetos.
4. Informa cualquier cosa que muestre el patrón de cuadros púrpura/negro: significa un nombre de archivo incorrecto o un tamaño de fotograma incorrecto.

Reglas

• Nunca afirmes que el paquete funciona en el juego. Di "construido, verificado y previsualizado en el motor BlockReel".
• Nunca subas texturas del juego. No las tomes del .jar del usuario para meterlas en el repositorio.
• Las pieles son algo diferente (blockreel-skins); un paquete de recursos no puede cambiar la piel del jugador.
• Los modelos, sonidos, fuentes y sombreadores están fuera del alcance.