AstrBot Minecraft 皮肤插件 (MCSkinRenderer)

用于获取 Minecraft 玩家皮肤的 3D 渲染图（支持动作）、2D 头像或皮肤文件。

🔧 安装

方法一：使用插件市场 (推荐)

搜索 MC皮肤渲染插件 并安装

方法二：Git Clone

进入 AstrBot 的 data/plugins/ 目录，然后执行：

git clone https://github.com/SatellIta/astrbot_plugin_minecraft_skin_render

安装依赖

进入 plugins/astrbot_plugin_minecraft_skin_render/ 目录，然后执行

pip install -r requirements.txt

如果不想手动安装依赖，插件的依赖会在机器人下次重启时自动安装。

🚀 使用说明

指令1：获取皮肤渲染

/skin [rendertype] <username>

参数

• [rendertype]: 可选。渲染类型，默认为 default
• <username>: 必需。玩家名称或者UUID

示例

• /skin Notch - 默认全身渲染
• /skin walking Notch - 行走动作的全身渲染

指令2：随机皮肤预览

/randomskin

功能：从 NameMC 的随机皮肤入口抓取一个随机皮肤，解析出该皮肤关联的第一个玩家名称，然后使用该名称来获取玩家 UUID 并生成默认的皮肤渲染预览。

指令3：生成壁纸

/wallpaper [wallpaper_id] <玩家名1> [玩家名2] [玩家名3]

参数

• [wallpaper_id]: 可选。壁纸ID，默认为 herobrine_hill
• <玩家名...>: 必需。至少1个玩家名称，不同壁纸支持不同数量的玩家

可用壁纸及玩家上限

• herobrine_hill - 最多1个玩家
• malevolent - 最多1个玩家
• off_to_the_stars - 最多1个玩家
• quick_hide - 最多3个玩家
• wheat - 最多1个玩家

示例

• /wallpaper herobrine_hill Notch - 生成 Herobrine Hill 壁纸
• /wallpaper quick_hide Notch jeb_ Dream - 生成 Quick Hide 壁纸（3个玩家）
• /wallpaper Notch - 使用默认壁纸生成

指令4：自定义模型渲染

/customskin <username> [camera_preset] [focal_preset]

参数

• <username>: 必需。玩家名称或者UUID。
• [camera_preset]: 可选。相机位置的预设名称或自定义JSON。
• [focal_preset]: 可选。焦点位置的预设名称或自定义JSON。

流程

1. 发送指令，例如 /customskin Notch。
2. 机器人会提示你发送一个 .obj 模型文件。
3. 在15秒内上传你的模型文件。
4. 机器人将使用你的模型和指定玩家的皮肤进行渲染。

文件上传说明

为了让渲染API能够访问你上传的模型文件，此指令需要一个公开的文件URL。

• 默认行为: 插件会默认将你的 .obj 文件上传到公共临时文件服务 (tmpfiles.org)，并设置一个短暂的过期时间。这对于没有公网IP的用户非常方便。
• 推荐配置: 为了获得最佳的稳定性和隐私保护，强烈建议为你的 AstrBot 配置一个公网可访问的回调地址 (配置文件-系统-对外可达的回调接口地址 或者直接修改配置文件 callback_api_base)。配置完成后，你可以在本插件的设置中禁用文件中转服务 ("use_transfer_sh": false)。这样，插件将使用机器人自带的文件服务，而不会将你的文件上传到第三方网站。

示例

• /customskin Notch - 使用默认相机和焦点。
• /customskin Notch front - 使用名为 front 的相机预设。
• /customskin Notch front top - 同时使用相机和焦点的预设。
• /customskin Notch '{"x":0,"y":20,"z":-50}' - 使用自定义的JSON作为相机位置。

帮助命令

• /skinhelp - 查看所有可用的渲染类型和壁纸列表。
• /customskinhelp - 查看所有可用的相机和焦点预设及其详细数据。