SkinLibrary

模组

· 作者 _Krecik

适用于 Fabric 的服务端皮肤库:将 PNG 文件放入文件夹,玩家可通过聊天中的可点击列表使用 /skin 命令选择皮肤。

0 本站下载 0 关注 更新于 3 个月前

需要前置:Fabric API、Fabric Tailor

最新 2.1.0+26.2 · 26.2 · Fabric

一键开服(送7天)

SkinLibrary — one character cycling through library skins

? 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。

仅服务端部署——玩家使用原版客户端加入,无需安装任何额外内容。

快速开始

  1. 将 fabric-api、fabrictailor 和 skinlibrary 放入服务器的 mods/ 文件夹。
  2. 启动服务器一次——它将创建 config/skinlibrary/ 目录。
  3. 将 .png 皮肤文件(64×64 或 64×32)放入 config/skinlibrary/skins/。
  4. 执行 /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)。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源