- 版权类型
- 转载
- 插件中文名称
- 基岩版皮肤恢复器 [GeyserMC/Floodgate]
- 插件英文名称
- Bedrock Skin Restorer [GeyserMC/Floodgate]
- 支持的核心(服务端)
- Spigot
- Paper
- Folia
- 适配版本(Java)
- 最新版本
- 26.x
- 1.21
[MD]
## 注意事项
这不是Geyser的扩展插件,不要把\*.jar文件放到Geyser目录里!
本插件主要针对Paper服务端开发,但Paper生态下的Bukkit/Spigot/Purpur服务端也能正常运行
暂未在Folia服务端上做测试,_may_出现不兼容问题
## 插件功能
本插件功能很简单,就是在你的服务器上显示基岩版玩家的皮肤,毕竟目前Floodgate在这块的表现不太稳定
## 实现原理
通过GeyserMC的[全局API](https://geysermc.org/wiki/api/global)获取原始皮肤文件,在玩家触发可通过配置修改的特定操作时,用修正后的皮肤覆盖玩家默认皮肤
## 使用优势
轻量型插件(兼容Paper生态,支持多MC版本),开箱即用;自带配置项,但所有会影响核心玩法的选项默认都是关闭的
### 竞品对比(及劣势)
BedrockSkinUtility:它_can_显示4D模型和饰品,但前提是你得装客户端模组才能看到,直接劝退普通用户
GeyserSkinManager:它_might_能在非常老的MC版本上运行,但现在完全用不了
SkinsRestorer、Floodgate和GeyserExtras:我个人从来没让这三个插件正常运行过,真的!
## 兼容性
DiscordSRV是目前唯一已知的不兼容插件,不过它不会影响本插件正常运行,只是更新后的皮肤可能不会同步到Discord和服务器之间的桥接频道里,对玩家来说基本没影响
## 配置文件(config.yml)
```yaml
# ---------------------------------------------------------------------------------------------------------------------------
# 基岩版皮肤恢复器
# ---------------------------------------------------------------------------------------------------------------------------
fetch-retries: 2 # ^ 插件首次尝试获取Floodgate玩家的皮肤失败后,重试的次数
# 数值越高,皮肤获取成功的概率越大(比如遇到随机报错时),但也会增加API请求带来的性能负担
fetch-on-join: true # ^ 玩家加入服务器时是否尝试获取其Floodgate账号的皮肤
fetch-on-character-refresh: false # ^ 玩家复活、切换维度、换服/换子服时,是否获取/重新获取其Floodgate账号的皮肤
# ---------------------------------------------------------------------------------------------------------------------------
manual-fetch: false # ^ 是否允许Floodgate玩家手动获取皮肤
# 若设为*false*,只有OP(服主)能执行下方的命令
manual-fetch-command: "/bedrockskin" # ^ 玩家可调用、用于尝试获取自身皮肤的命令,支持自定义
manual-fetch-command-java: "[基岩版皮肤恢复器] 你不是Floodgate用户!" # ^ Java版玩家尝试执行该命令时弹出的报错
manual-fetch-command-noperm: "[基岩版皮肤恢复器] 你没有权限执行此操作" # ^ 玩家没有手动获取权限时弹出的报错
manual-fetch-command-error: "[基岩版皮肤恢复器] 从GeyserMC API获取皮肤失败,请稍后再试" # ^ 获取失败时的通用报错
# ---------------------------------------------------------------------------------------------------------------------------
config-version: 1 # ^ 除非你非常清楚自己在做什么,否则不要修改这个数值!!
# 简单说明:该数值用于告诉插件以什么规则解析当前配置文件
```
[/MD]