? SkinLibrary
适用于 Fabric 的服务端皮肤库——玩家可在聊天栏中通过可点击列表选择皮肤。
将 .png 文件放入文件夹;玩家使用原版客户端加入服务器并输入 /skin。
无需在玩家端安装任何内容,无需托管 Web 服务,无需 API 密钥。
功能说明
| 指令 |
效果 |
/skin |
浏览库——分页显示,按作者分组,条目可点击 |
/skin <name> |
穿戴库中的指定皮肤 |
/skin random |
随机穿戴一个皮肤 |
/skin player <nick> |
穿戴任意 Minecraft 账号的皮肤 |
/skin url <address> |
从 PNG 链接穿戴皮肤 |
/skin reset |
恢复为自身账号的皮肤 |
/skin reload |
重新加载库(仅限操作员) |
FabricTailor 负责实际切换皮肤和上传至 MineSkin;SkinLibrary 在其基础上添加了精心策划的库以及聊天内浏览器功能。
特性
- ?️ 聊天内可点击列表 —— 分页显示,按作者分组,包含“◀ 上一页 / 下一页 ▶”
导航以及 ? 随机 / ↺ 原始快捷方式。
- ⌨️ Tab 补全 —— 支持皮肤名称补全,无需记忆库中所有皮肤名。
- ? 库即文件夹 —— 文件名即为皮肤名,随后执行
/skin reload 即可生效。
- ? 支持库外皮肤 ——
/skin player <nick> 和 /skin url <address>,
均可在配置文件中启用或禁用。
- ? 纹理缓存 —— 已获取一次的纹理不会再次发送至 MineSkin。
- ?️ 多语言支持 —— 内置
en_us 和 pl_pl,无需重新构建即可添加其他语言。
- ? 单 JAR 兼容 1.21+ —— 无 mixins,无需针对每个版本单独构建。
- ? 可选 HTTP 目录 (
libraryUrl) —— 如果你已运行皮肤服务可使用此功能。
环境要求
1.21 或更高版本的 Fabric 服务器,Java 21,并将以下模组放入 mods/ 目录:
Fabric API 和 FabricTailor。
仅服务端部署——玩家使用原版客户端加入,无需安装任何额外内容。
快速开始
- 将
fabric-api、fabrictailor 和 skinlibrary 放入服务器的 mods/ 文件夹。
- 启动服务器一次——它将创建
config/skinlibrary/ 目录。
- 将
.png 皮肤文件(64×64 或 64×32)放入 config/skinlibrary/skins/。
- 执行
/skin reload,皮肤即刻生效。
文件名即为皮肤名:pirate.png → /skin pirate。
配置文件
config/skinlibrary/config.json,首次启动时自动生成:
{
"language": "en_us",
"allowPlayerSkins": true,
"allowUrlSkins": true,
"cooldownSeconds": 5,
"requireOperator": false,
"pageSize": 8,
"slimByDefault": false,
"libraryUrl": "",
"commandAliases": ["skin", "skins"]
}
此处所有选项均为非必填——默认值即可正常工作。 notable 选项说明:
commandAliases —— 如果其他模组已占用 /skin 命令,可在此重命名。
slimByDefault —— 将文件皮肤默认为纤细(Alex)模型。
libraryUrl —— 可选的 HTTP 目录,如果你已运行相关服务。该地址必须返回如下格式的 JSON:
{"skins": [{"name": "...", "value": "...", "signature": "...", "author": "..."}]};
条目也可使用 url 替代 value。
更丰富的条目
如需超越“文件夹中的 PNG”的功能,请添加 config/skinlibrary/skins.json:
{
"notch": { "player": "Notch", "author": "mojang" },
"banner": { "url": "https://example.com/skin.png", "author": "alice" },
"alex": { "file": "alex.png", "slim": true, "author": "bob" }
}
条目在浏览器中按 author 分组,因此共享服务器可以清楚看到谁添加了哪些皮肤。
翻译
内置:en_us、pl_pl。在配置文件中设置 language 即可切换。
若要添加自定义语言,请在 config/skinlibrary/lang/<code>.json 放置与
en_us.json 相同键值的 JSON 文件——无需重新构建。
Minecraft 版本支持
单个 JAR 覆盖 1.21 及以上版本。该模组不包含 mixins,且避开了不同版本间可能变动的 API 部分,因此无需因小版本更新而重新构建。
唯一例外是聊天点击功能:Minecraft 1.21.5 替换了点击/悬停事件 API。
在 1.21.5 及以上版本中,列表支持点击;在更早版本中,同一列表将以不可点击形式打印输出,其余功能保持不变。
源码与许可
github.com/PiotrKajor/skinlibrary —— MIT 协议。
仓库中包含波兰语 README(README.md)。
? SkinLibrary
Server-side skin library for Fabric — players pick a skin from a clickable list in chat.
Drop .png files into a folder; players join with a vanilla client and type /skin.
Nothing to install on their side, no web service to host, no API keys.
What it does
| Command |
What happens |
/skin |
Browse the library — paged, grouped by author, entries are clickable |
/skin <name> |
Wear a skin from the library |
/skin random |
Wear a random one |
/skin player <nick> |
Wear the skin of any Minecraft account |
/skin url <address> |
Wear a skin from a PNG link |
/skin reset |
Back to your own account skin |
/skin reload |
Reload the library (operators) |
FabricTailor does the actual skin swapping and the
MineSkin upload; SkinLibrary adds the curated library and the in-chat browser on top of it.
Features
- ?️ Clickable in-chat list — paged, grouped by author, with "◀ Previous / Next ▶"
navigation and ? Random / ↺ Original shortcuts.
- ⌨️ Tab-complete for skin names — nobody has to memorise the library.
- ? The library is just a folder — the file name becomes the skin name, then
/skin reload.
- ? Skins from outside the library —
/skin player <nick> and /skin url <address>,
both switchable in the config.
- ? Texture cache — a texture fetched once is not sent to MineSkin again.
- ?️ Translations —
en_us and pl_pl built in, your own language without a rebuild.
- ? One jar for 1.21+ — no mixins, no per-version builds.
- ? Optional HTTP catalogue (
libraryUrl) — if you already run a skin service.
Requirements
A Fabric server on 1.21 or newer, Java 21, and in mods/:
Fabric API and FabricTailor.
Server-side only — players join with a vanilla client and need nothing installed.
Quick start
- Put
fabric-api, fabrictailor and skinlibrary into your server's mods/ folder.
- Start the server once — it creates
config/skinlibrary/.
- Drop
.png skins (64×64 or 64×32) into config/skinlibrary/skins/.
/skin reload, and they are live.
The file name becomes the skin name: pirate.png → /skin pirate.
Configuration
config/skinlibrary/config.json, created on first start:
{
"language": "en_us",
"allowPlayerSkins": true,
"allowUrlSkins": true,
"cooldownSeconds": 5,
"requireOperator": false,
"pageSize": 8,
"slimByDefault": false,
"libraryUrl": "",
"commandAliases": ["skin", "skins"]
}
Nothing here is required — the defaults work. Notable options:
commandAliases — rename the command if another mod already owns /skin.
slimByDefault — treat file skins as the slim (Alex) model.
libraryUrl — optional HTTP catalogue, if you already run one. It must answer with
{"skins": [{"name": "...", "value": "...", "signature": "...", "author": "..."}]};
entries may use url instead of value.
Richer entries
For anything beyond "a PNG in a folder", add config/skinlibrary/skins.json:
{
"notch": { "player": "Notch", "author": "mojang" },
"banner": { "url": "https://example.com/skin.png", "author": "alice" },
"alex": { "file": "alex.png", "slim": true, "author": "bob" }
}
Entries are grouped by author in the browser, so a shared server can see who added what.
Translations
Built in: en_us, pl_pl. Set language in the config.
To add your own, drop config/skinlibrary/lang/<code>.json with the same keys as
en_us.json — no rebuild needed.
Minecraft versions
One jar covers 1.21 and up. The mod has no mixins and stays off the parts of the API that
shift between releases, so it does not need a rebuild per point release.
The single exception is clickable chat: Minecraft 1.21.5 replaced the click/hover event API.
On 1.21.5+ the list is clickable; on older releases the same list prints without click support
and everything else works unchanged.
Source & license
github.com/PiotrKajor/skinlibrary — MIT.
A Polish README is in the repository (README.md).
评论 0
登录后参与评分
还没有评论,来抢沙发吧