Описание
### 📖 Project Introduction
**Better Clayful** is a unique Minecraft resource pack that intelligently optimises in‑game textures using the **Mean Shift colour clustering algorithm**. It transforms the originally rich and detailed pixel art into a **warm, rustic, handcrafted** clay‑style visual experience.
This is not a simple downgrade or blur, but a **digital pottery experiment** — while preserving the core recognisability of the block world, it strips away redundant details, making every texture feel as if it has been hand‑moulded and kiln‑fired, giving a gentle, unified earthy quality.
---
### ✨ Core Features
#### 🎯 Colour Merging, Warm as Clay
- Uses **Lab colour space** and **Mean Shift clustering** technology
- Intelligently merges similar colours, as if glazes naturally blend in the kiln fire
- Maintains edge sharpness, keeping texture outlines as distinct as pottery decorations
#### 🧱 Unique Clay Aesthetics
- **Rustic feel**: Textures take on a matte, flat‑coloured look reminiscent of hand‑made pottery
- **Unity**: Colours become more concentrated and harmonious, as if the whole world were shaped from the same lump of clay
- **Recognisability**: All blocks and items remain clearly identifiable — familiar yet fresh
#### 🎮 Gameplay Experience Enhancement
- Reduces visual clutter, creating an immersive and tranquil atmosphere
- Great for builders: structural outlines and mass relationships become clearer
- Great for survival players: visuals are clean, and block distinguishability is not reduced but actually improved
---
### 🔧 Technical Principles
1. **Transparent pixel protection**: Automatically detects and preserves alpha channels; transparent areas remain unaffected
2. **Lab colour space**: Colour processing that better matches human visual perception, with natural hue transitions
3. **Adaptive bandwidth estimation**: Automatically computes optimal merging parameters to suit different texture characteristics
4. **Batch processing**: Supports recursive processing of all subfolders for complete resource pack conversion
---
### 📦 Supported Versions
- ✅ Minecraft Java Edition 1.21.5+
- ✅ Any version that supports resource packs
- ✅ Compatible with vanilla and most modded textures
---
### 📥 Download & Installation
1. Download the resource pack `.zip` file
2. Open Minecraft, go to **Options** → **Resource Packs**
3. Click **Open Resource Pack Folder**
4. Place the `.zip` file into the folder
5. Select and load the pack from the resource pack screen
---
### 📜 License
This project is open‑sourced under the **MIT License**.
You are free to:
- ✅ Commercial use
- ✅ Modify and distribute
- ✅ Private use
You only need to retain the copyright notice.
---
### 🎉 Acknowledgements
- The original Minecraft texture designers
- The scikit‑learn community
- All players who tested and provided feedback
---
*"Every block is a piece of clay. In the world of Better Clayful, let the warmth of your fingertips reshape every inch of the landscape."*
---
## 🧱 陶土世界（Better Clayful）
### 📖 项目简介
**陶土世界（Better Clayful）** 是一款独特的Minecraft资源包，通过**Mean Shift色彩合并算法**对游戏纹理进行智能优化，将原本丰富细腻的像素艺术转化为**温暖、质朴、充满手作感**的陶瓦风格视觉体验。
这不是简单的降质或模糊，而是一场**数字陶艺实验**——在保留方块世界核心识别度的同时，剥离冗余细节，让每个纹理都像经过手工与烧制，呈现出陶土般温润、统一的质感。
---
### ✨ 核心特色
#### 🎯 色彩合并，如陶土般温润
- 采用**Lab色彩空间**与**Mean Shift聚类**技术
- 智能合并相近色彩，仿佛釉料在窑火中自然交融
- 保留边缘清晰度，纹理轮廓如陶器纹饰般分明
#### 🧱 独特的陶土美学
- **质朴感**：纹理呈现出类似手工陶器的哑光平涂质感
- **统一感**：色彩更集中和谐，仿佛整个世界由同一块黏土塑造
- **辨识度**：所有方块和物品依然清晰可辨，熟悉而新鲜
#### 🎮 游戏体验优化
- 减少视觉杂乱，营造沉浸式的宁静氛围
- 适合建筑玩家：更清晰地看到结构轮廓与体块关系
- 适合生存玩家：视觉清爽，方块区分度不降反升
---
### 🔧 技术原理
1. **透明像素保护**：自动识别并保留Alpha通道，透明区域不受影响
2. **Lab色彩空间**：更符合人类视觉感知的色彩处理，色调过渡自然
3. **自适应带宽估计**：自动计算最优合并参数，适应不同纹理特征
4. **批量处理**：支持递归处理所有子文件夹，完整转换资源包
---
### 📦 适用版本
- ✅ Minecraft Java Edition 1.21.5+
- ✅ 任何支持资源包的版本
- ✅ 兼容原版及大多数模组纹理
---
### 📥 下载与安装
1. 下载资源包 `.zip` 文件
2. 打开Minecraft，进入 **选项** → **资源包**
3. 点击 **打开资源包文件夹**
4. 将 `.zip` 文件放入文件夹
5. 在资源包界面选择并加载
---
### 📜 许可证
本项目采用 **MIT License** 开源协议。
您可以自由：
- ✅ 商业使用
- ✅ 修改与分发
- ✅ 私人使用
唯需保留版权声明。
---
### 💬 反馈与支持
- **Bilibili**：[https://space.bilibili.com/3493295143520788](https://space.bilibili.com/3493295143520788)
---
### 🎉 致谢
- Minecraft 原版纹理设计者
- scikit-learn 社区
- 所有测试和反馈的玩家
---
**"每一寸方块，都是一块陶瓦。在陶土世界里，让指尖的温度重塑每一寸风景。"**