Texture-Craft

Texture-Craft

用扩散模型根据文字提示生成透明的 16x16 物品纹理，可通过 Gradio Space、本地 REST 服务或 MCP 工具使用。适合游戏制作者和智能体开发者。

由 ArshPathan 在 Hugging Face 上制作。这些说明是 Mindket 根据它的 Space 页面和 README 写的，应用自己的文件和许可证在 Hugging Face 上。

简介

它是什么：这个项目用扩散模型把一句文字提示变成一张小小的透明物品纹理，大小是 16x16 像素。你可以把它当作带 MCP 工具的 Gradio Space 来运行，也可以当作本地 REST 服务，或通过 stdio 运行的本地 MCP 服务器。每个结果都以 base64 编码的 PNG 返回。

适合谁：它适合需要快速做出大量小型物品图标的独立游戏制作者、模组作者和工具开发者。想让智能体通过 MCP 工具生成纹理的开发者也适合用它。

行业 | 谁在用 | 怎么用 | 例子
游戏 | 独立开发者 | 为游戏制作物品图标 | 要求一把带棕色剑柄的红宝石剑
模组 | 模组作者 | 给资源包补充新的物品美术 | 生成一个药水瓶的几个变体
软件 | 智能体开发者 | 通过 MCP 给智能体一个纹理工具 | 在 MCP 客户端里调用 generate_texture 工具
设计 | 像素画师 | 得到可以手工细修的粗略图块 | 导出一个图块并整理

需要大尺寸、精细美术图的人可以跳过它，因为输出是 16x16 的图块。

用在哪里：它可以在多个地方使用。

• 网页浏览器，打开 Hugging Face 上这个 Space 的页面
• MCP 客户端，通过这个 Space 或本地 stdio 服务器
• Windows、macOS 或 Linux，用 Python 3.12 运行本地副本
• 任何能调用本地 REST 服务的程序

Use case | Who | What they get back
物品纹理 | 游戏制作者 | 每个提示词对应一张透明的 16x16 PNG
变体 | 美术师 | 同一个提示词的多个版本，各有自己的种子
智能体工具 | 开发者 | 在智能体工作流里生成的纹理
素材流水线 | 工作室 | 以 base64 PNG 或 data URI 形式给出的图块

如何设置：在线页面不需要安装任何东西。本地副本需要下面这些。

• Python 3.12
• Windows、macOS 或 Linux
• requirements.txt 里列出的包
• uv，用于 README 里的快速开始
• 不需要 Hugging Face 令牌，因为公开模型不需要

1. 安装 Python 3.12。
2. 安装 Hugging Face 的 hub 包，并下载这个 Space 的副本。
3. 进入新文件夹，安装 Gradio 6.31.0 和 requirements.txt 里的包。
4. 用 python app.py 启动 Space 应用。
5. 要用本地 REST 服务，先同步项目，再运行 server.py。
6. 要用本地 MCP 服务器，让你的客户端指向 local_mcp_server.py。

pip install -U huggingface_hub
hf download ArshPathan/TexuteCraft --repo-type space --local-dir TexuteCraft
cd TexuteCraft
pip install gradio==6.31.0
pip install -r requirements.txt
python app.py

uv sync
python server.py

{
  "mcpServers": {
    "texture-craft": {
      "command": "C:\\path\\to\\Texture-Craft\\.venv\\Scripts\\python.exe",
      "args": ["C:\\path\\to\\Texture-Craft\\local_mcp_server.py"]
    }
  }
}

如何使用：写一个提示词，并要求一个或多个变体。在 Space 或 MCP 客户端里，调用 generate_texture 工具。在本地副本上，用下面这条命令启动 Space 页面。

python app.py

工具 | 作用
generate_texture | 把提示词变成纹理的 MCP 工具
server.py | 运行本地 REST 服务
local_mcp_server.py | 运行基于 FastMCP 的本地 stdio MCP 服务器
app.py | 运行带内置 MCP 服务器的 Gradio Space
Health endpoint | 报告运行环境是 GPU 还是 CPU

示例：你要一把带发光符文的红宝石大剑，两个变体，种子 42，30 步，引导系数 9.0。你会得到两个透明图块，每个都有 base64 PNG 和 data URI，以及它的种子和延迟。

新手与专家：如果你刚接触这类工具，先用一个简短具体的提示词，比如带软木塞的蓝色药水瓶。先要一个变体，再换一个种子试一次，看看结果有什么变化。

如果你熟悉这个领域，生成使用的是基于 Stable Diffusion 1.5 的模型 yuuki14202028/minecraft-item-16px，并通过去掉品红色和与边缘相连的纯色背景来保留透明 PNG。透明度除了依据模型的品红色色键，也从图像边缘推断。这个 Space 只开放纹理生成，不接受调用者提供的文件系统路径。

用户提示词
TextureEngine.generate_single
Stable Diffusion 推理
16x16 透明图块
返回 base64 PNG 和 data URI

注意事项：平坦或重复的背景效果最好。复杂的背景，或者碰到图像角落的物品，可能需要手工清理。

• License: 应用代码是 MIT，模型权重使用带使用限制的 Stable Diffusion 1.5 CreativeML OpenRAIL-M 许可
• Cost to run: 未提及，公开模型也不需要 Hugging Face 令牌
• Data it reaches: 你的提示词，以及它指定的模型
• Not for: 创建资源包，或读取你提供的路径下的文件

Hugging Face 上的数据（2026年11月13日）

• 点赞：1
• 构建方式：gradio
• 许可证：mit

链接

• Space：https://huggingface.co/spaces/ArshPathan/TexuteCraft
• 文件：https://huggingface.co/spaces/ArshPathan/TexuteCraft/tree/main

试用

在浏览器里打开这个 Space，或在它的页面上把它复制到你自己的 Hugging Face 账号。这个工具包里没有会自己运行的东西。