---
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 |
|---|---|
| ![ex1 preview](examples/ex1_preview.png) | ![ex1 skin](examples/ex1_skin.png) |
| ![ex2 preview](examples/ex2_preview.png) | ![ex2 skin](examples/ex2_skin.png) |
| ![ex3 preview](examples/ex3_preview.png) | ![ex3 skin](examples/ex3_skin.png) |

## 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