| | --- |
| | library_name: diffusers |
| | pipeline_tag: image-to-image |
| | base_model: black-forest-labs/FLUX.2-klein-base-9B |
| | tags: |
| | - minecraft |
| | - img2img |
| | - skin-generation |
| | - flux2 |
| | --- |
| | |
| | # BLOCKv0.5 |
| |
|
| | BLOCKv0.5 is an image-to-image model for converting a **3D Minecraft character preview** into a **2D skin texture file**. |
| |
|
| | It is based on `black-forest-labs/FLUX.2-klein-base-9B` with merged LoRA weights and was trained with **[cond, target]** token order. |
| | For best results, use the included custom pipeline: `Flux2KleinPipelineTrainOrder`. |
| |
|
| | ## What This Model Does |
| |
|
| | - Input: a character preview image (RGB, square recommended) |
| | - Optional control: text prompt for style/details |
| | - Output: a generated skin texture image (PNG) |
| |
|
| | ## Quick Start |
| |
|
| | ```python |
| | import torch |
| | from PIL import Image |
| | from pipeline_flux2_klein_train_order import Flux2KleinPipelineTrainOrder |
| | |
| | model_id = "your-username/BLOCKv0.5" # or local path |
| | |
| | pipe = Flux2KleinPipelineTrainOrder.from_pretrained( |
| | model_id, |
| | torch_dtype=torch.bfloat16, |
| | ) |
| | pipe.to("cuda") |
| | |
| | preview = Image.open("examples/ex1_preview.png").convert("RGB").resize((1024, 1024)) |
| | |
| | result = pipe( |
| | prompt="clean minecraft skin texture, readable details, game-ready layout", |
| | image=preview, |
| | num_inference_steps=30, |
| | guidance_scale=4.0, |
| | ).images[0] |
| | |
| | result.save("generated_skin.png") |
| | ``` |
| |
|
| | ## Example Results |
| |
|
| | | Preview | Generated Skin | |
| | |---|---| |
| | |  |  | |
| | |  |  | |
| | |  |  | |
| |
|
| | ## Notes |
| |
|
| | - This checkpoint is designed for img2img skin generation, not general text-to-image generation. |
| | - The included custom pipeline matches the training token order and is recommended for inference. |
| | - The model is large; use a high-memory GPU for practical inference speed. |
| |
|
| | ## Citation |
| |
|
| | If you use BLOCKv0.5 or results derived from this model, please cite: |
| |
|
| | ```bibtex |
| | @article{guo2026block, |
| | title={BLOCK: An Open-Source Bi-Stage MLLM Character-to-Skin Pipeline for Minecraft}, |
| | author={Guo, Hengquan}, |
| | journal={arXiv preprint arXiv:2603.03964}, |
| | year={2026}, |
| | url={http://arxiv.org/abs/2603.03964} |
| | } |
| | ``` |
| |
|
| | ## Dependencies |
| |
|
| | - diffusers |
| | - transformers |
| | - torch |
| | - safetensors |
| |
|
