Better Player Model

模组

· 作者 Zhoporez

使用自定义 3D 玩家模型和动画扮演任何角色,在多人游戏中完全同步。

0 本站下载 0 关注 更新于 1 周前

最新 1.1.5-26.2-hotfix · 26.2 · Fabric

一键开服(送7天)

title

Better Player Model

Better Player Model 是一款强大的 Fabric 模组,专为动画自定义玩家模型设计,具备高性能渲染、本地浏览以及无缝的多玩家同步功能。

主要特性

  • 通用模型支持: 轻松加载任何 .ysm 或 Blockbench .json 模型。
  • 基岩级动画: 完整支持 MoLang,实现流畅、复杂且可脚本化的动画效果。
  • 游戏内浏览器: 直接在菜单中管理你的模型、分类和纹理。
  • 无缝同步: 作为客户端模组运行,但在服务端也安装该模组时,可实现完整的多玩家同步。

多人游戏

  • 仅客户端: 在任何服务器上,你仍然可以看到自己的模型并浏览你的资源库。
  • 完全同步: 当服务器也运行该模组或插件时,所有玩家都能看到你的自定义动画和模型!

兼容性与设置

  • 格式: 支持 .json (Blockbench) 和 .ysm (加密)。
  • 位置: 将你的模型放置在 config/better_player_model/custom 目录中。
  • 性能: 完全兼容 Sodium、Iris 以及其他优化模组。

依赖项

在哪里找到模型?

寻找高质量的玩家模型?你可以从 Yes-steve-model 社区存储库中浏览并下载数百个由社区制作的模型: 在此处下载模型

对于服务器管理员

你可以在 Versions 标签页下方找到我们官方的 Paper/Purpur 插件,无需服务端模组即可同步模型!

演示

Demonstration Demonstration

联系方式

访问我们的官方 Discord 服务器以获取模组资讯。抢先预览即将到来的更新、建议新功能、报告错误,并与开发者和社区交流。

致谢

本项目建立在以下团队和个人令人难以置信的工作基础之上:

  • OpenYSM & YSMParser (模型解析管道)
  • Fox-model-loader by Micaftic (基础架构)
  • Yes Steve Model by Elfmcys (原始概念)

网络故障排除指南:模型同步超时与断连

如果拥有较慢或不稳定互联网连接(如 Wi-Fi、移动数据或 Starlink 等卫星链路)的玩家在加入服务器或进行模型同步时持续断开连接,本指南解释了如何修复此问题。


为什么会发生这种情况?

  1. 带宽饱和(Bufferbloat): 当玩家加入时,服务器会传输缺失的自定义玩家模型。如果服务器尝试推送数据的速度超过玩家连接的下载速度,玩家路由器或操作系统的网络缓冲区将会溢出。
  2. 延迟的 Ping/保活数据包: 由于连接饱和,关键的游戏数据包(如验证玩家是否仍在线的 Minecraft KeepAlive 数据包)会被排在模型文件之后排队。如果客户端无法在 15–30 秒内响应这些数据包,服务器就会判定超时并将其踢出。
  3. 大型模型文件: 如果你的服务器托管了许多模型,或者某些模型特别大(例如每个几兆字节),初始下载大小可能会很大(数兆到数十兆字节),从而延长关键的同步窗口。

解决方案 1:在服务端配置带宽限制(推荐)

版本 1.0.6 引入了每玩家带宽限制器,以防止连接饱和。你可以限制模型分块发送的速度。

  1. 打开服务器的配置目录:config/better_player_model-server.toml。
  2. 找到 [server_scheduler] 类别并配置限制:
    [server_scheduler]
        # 跨所有活跃玩家分发模型的全局带宽限制(单位为 Mbps)
        # 默认值:100
        BandwidthLimit = 25
    
        # 单个玩家的带宽限制(单位为 Mbps)
        # 这可以防止慢速连接被淹没。
        # 默认值:5(推荐:3 到 10)
        PlayerBandwidthLimit = 5
    
    将 PlayerBandwidthLimit 设置为 5 Mbps(约 625 KB/s)可以让模型平稳下载而不会使链路饱和,为游戏和 KeepAlive 流量留出充足空间。

解决方案 2:增加网络连接超时时间

默认情况下,如果 Minecraft 在 30 秒内未收到网络响应,它会踢出玩家。你可以将此读取超时时间增加到 120 秒。

对于专用服务器:

在你的服务器启动脚本或命令行中添加以下 Java 系统属性:

-Dnet.minecraft.network.readTimeout=120

对于客户端(在 Prism Launcher 或其他启动器选项中):

  1. 打开 Minecraft 实例的启动器设置。
  2. 在 Java -> Java Arguments 下,添加:
    -Dnet.minecraft.network.readTimeout=120
    

解决方案 3:使用扩展超时的模组

或者,你可以安装以下任一服务端和客户端模组来自动处理超时问题:

  • Connectivity
  • Timeouts

内置模型与资产致谢

本模组默认内置了 “Wine Fox” (酒狐) 模型,以提供开箱即用的高质量体验。

  • 模型名称: Wine Fox (酒狐)
  • 许可证: CC BY-NC-SA 4.0
  • 原作者:
    • 完美冻结 (模型与核心)
    • 星屑海螺 (动画)
    • 哥斯拉 / 映素团队 (修改)
    • 白帆小喵, 蓝玫瑰, 墨染逝羽, Maks怜悯, 浅陌菌, 祸御神, 羊毛 (纹理、UI、音效及特定添加内容)

非常感谢这些创作者为模型做出的卓越贡献!如果您希望将此模型用于其他用途,请务必遵守原始的 CC BY-NC-SA 4.0 许可协议。

许可证

本作品基于 MIT 许可协议授权。所有原始许可协议和版权声明均予以保留。 MIT 许可证

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源