BetterPets-Paper

插件

· 作者 yourShika

? 一款由社区制作的插件移植版,灵感源自 Minecraft 服务器的原版 Better Pets 数据包。

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

最新 1.17.4 · 26.2 · Paper / Spigot

一键开服(送7天)

? Better Pets Paper

⚠️ 免责声明: 本项目——包括其代码和项目美术资源——均在 AI 的帮助下创建。该插件本身由真人测试,并会积极修复漏洞和问题。

这是对原始 Better Pets 数据包的完整 Paper 插件重写版。


✨ 简介

Better Pets Paper 是对 Better Pets 数据包的完整 Paper 插件重写版。

它不需要使用数据包、命令函数、矿车菜单或手动安装资源包。所有功能均由插件直接处理。如果安装了 BetterModel 插件并启用了(实验性)模块,可选的动画 3D 模型将通过该插件进行处理。


? v1.9.3 新增内容

  • ? 飞行操作更便捷。 在飞行时右键点击你的宠物不再会让你下马——改为潜行即可下马。此外,开始飞行现在需要再次右键确认,以免意外起飞。
  • ?️ 新命令: /pets visible 和 /pets invisible(别名:show / hide)可以在不打开菜单的情况下,在聊天栏中显示或隐藏你当前的宠物。

? v1.9.2 新增内容

  • ?️ 不再限制飞行高度。 宠物坐骑原本只能达到世界的建筑高度上限(约 Y 319)。现在你可以飞到远高于此的高度进入开阔的天空——仅受限于一个慷慨且可配置的安全上限(flight-max-height,默认值为 1024)。

? v1.9.1 新增内容

  • ? 修复: 飞行的宠物不再会将你卡进方块里。坐骑的碰撞检测现在采样你的整个身体(而不仅仅是中心点),并且在飞行期间,即使短暂接触方块也不会受到窒息伤害。
  • ? 宠物不再妨碍你。 宠物的碰撞箱现在不可被攻击,并且对于没有右键交互功能的宠物来说非常小——这样它们就不会阻碍你的挖掘、攻击或建造行为。那些确实具有右键交互功能的宠物(羊驼以及可飞行的龙/凤凰)保留可点击的碰撞箱;如果任何宠物妨碍到你,可以使用 /pets 中的可见性切换功能将其隐藏。

? v1.9.0 新增内容

⬆️ Minecraft / Paper 26.2

  • 该插件现针对 Paper 26.2(api-version: '26.2'),基于 paper-api 26.2.build.62-beta 构建,并使用 Adventure 5.2.0。
  • 无游戏玩法变更——整个代码库以 26.2 为目标编译,无需任何源代码更改;仅更新了构建和目标 API。
  • build.ps1 现在会自动下载 Paper API 和匹配的 Adventure 5.x jar 包,并调整类路径顺序,使较新的 Adventure 版本优先于旧的服务端库。

⚠️ 注意: Paper 26.2 目前处于实验性/测试分支(26.1.2 是稳定版)。由于 api-version 现在是 26.2,此版本需要 26.2 服务端——如果你仍在使用 26.1.2,请停留在 v1.8.1。


? v1.8.1 新增内容

  • ? 修复: 老虎机的展示宠物不再在你每次打开 /pets slots 时重新随机。它在实际旋转之前保持不变,并且按玩家记忆。

? v1.8.0 新增内容

? 老虎机,扩展版

  • 滚轮上的奖励大幅增加: 金粒、煤、铁、铜、红石、青金石、金锭、经验瓶、绿宝石、钻石、下界合金碎片与锭——每种都有其各自的概率(下界合金保持稀有)。
  • 真实的老虎机手感: 三个滚轮现在依次停止,顺序为左 → 中 → 右。
  • 每次旋转都会展示一只推荐宠物在滚轮上方——停在宠物符号上即可赢得那只宠物,并伴有聊天消息和可选的全服大奖广播。宠物中奖概率略有提升(但仍属稀有)。
  • 旋转现在仅需花费 1 个代币。
  • 管理员奖励编辑器: /pets slots 内的 Configure Loot 按钮会打开一个 GUI,用于实时调整每项奖励的概率(左/右键 ±1,Shift ±10,显示百分比)。所有设置也位于 config.yml 的 tokens: 部分下。

?️ 代币命令

  • /pets tokens pass <player> <amount> — 将你自己的部分代币发送给其他玩家(任何人都可以使用)。
  • /pets tokens give|remove <player|all> <amount> — 管理员发放或收回代币(控制台也可使用)。

? v1.7.0 新增内容

?️ 宠物代币 & ? 老虎机

  • 重复的宠物不再是累赘。 使用 /pets scrap(手中的物品)或 /pets scrap all(库存中的所有宠物物品)将任何宠物物品转换为宠物代币。使用 /pets tokens 查看你的余额。
  • 按稀有度计算的代币数量:普通 1 · 稀有 2 · 史诗 3 · 传说 4 · 神话 5(均可配置)。
  • /pets slots 打开一个动画老虎机:每旋转一次消耗代币,可获得金粒 → 铁 → 金 → 钻石 → 下界合金,或者——极其罕见地——获得另一只宠物(约 0.5%,抽到的宠物由生成权重决定)。经过调优,使其成为处理重复宠物的有趣途径,而非刷取手段。
  • 所有设置可在 config.yml 的 tokens: 下进行配置;设置 tokens.enabled: false 可关闭整个功能。

? v1.6.0 新增内容

? 本地化 — 英语 / 德语 / 波兰语

  • 所有面向玩家的文本现在都存储在 plugins/BetterPets/lang/<code>.yml 中(内置:en, de, pl)。在 config.yml 中使用 language: 选择一种语言,或使用 /pets language <en|de|pl> 实时切换。
  • 升级安全: 每次启动时,新的消息键会被合并到你的语言文件中,因此自定义文本会在更新后得以保留。config.yml 中的遗留 messages: 块会自动迁移。
  • 消息支持 MiniMessage 格式(<gradient:#a:#b>, <bold>, 颜色)。替换值会被转义,因此玩家选择的宠物名称永远无法注入格式代码。

? 外观优化

  • 渐变色 GUI 标题以及渐变的 [BetterPets] 广播前缀。
  • 更美观的 升级、凤凰复活、增益器和转换提示信息。
  • config.yml 已重新组织为带编号且带有文档说明的章节。

? 生活便利性提升

  • 转换为物品现在会请求二次点击确认,并在物品上保留宠物的等级 和 当前等级的经验值,防止误触导致数据丢失。
  • /pets mute —— 仅对己方隐藏发现/增益器广播(文本 和 声音);重连后依然保持该状态。
  • 在 刷新概率 菜单(或 经验倍率)中鼠标中键点击宠物,可在聊天栏中输入精确数值。
  • 首次打开菜单时提供一次性的 /pets help 提示。

?️ 修复与性能优化

  • 当伤害完全被吸收之心抵消时,凤凰复活不再触发(从而避免浪费冷却时间)。
  • 经验球的经验值不再被重复计算给当前激活的宠物。
  • 自动更新器现已改为配置驱动且需手动开启(update.repo / update.enabled)——不再有占位符仓库。
  • 交互式保存已进行合并处理,经验倍率已缓存,企鹅容器扫描间隔可配置,且 debug-logging 默认关闭。

? 权限

  • 经验倍率控制功能和 /pets drop(宠物来源)菜单现在需要 betterpets.admin 权限(此前为 betterpets.chances)。

?‍? 底层改进

  • 每个宠物的数据和行为已移入单一的 PetAbilities 注册表,菜单持有者和更新器已从主类中分离出来——添加新宠物的工作量大幅减少。
  • 新增了一个小型无依赖测试套件(test.ps1)。

? v1.5.3 新增内容

  • ? 修复:暗影龙不再导致服务器崩溃。 其命中时的范围爆炸会对附近的生物造成与玩家相同的伤害,这会重新触发伤害事件并再次引发爆炸——这是一个无限循环,会在控制台中刷屏显示 StackOverflowError。现在爆炸效果增加了防递归保护,确保每次命中只触发一次。

? v1.5.2 新增内容

  • ? 修复:企鹅容器的发光效果不再阻挡箱子。 之前的发光效果使用了一个不可见的潜影盒,其碰撞箱拦截了你的点击(导致无法打开容器),甚至可能被攻击。现在改用 BlockDisplay(方块显示实体),它没有碰撞箱——点击直接穿透到达容器,且无法被攻击或杀死。保留了仅限所有者穿墙可见的发光效果,颜色改为青色。

? v1.5.1 新增内容

  • ⚔️ 暗影龙的 AOE 现改为命中触发。 爆炸效果仅在你发动攻击且冷却就绪时触发;触发后,Boss 血条开始倒计时,下一次命中将再次触发爆炸(而非按计时器脉冲)。充能完成后,血条显示 "暗影龙 AOE 就绪 — 攻击!"。
  • ? 哥布林偷窃通知。 当你的哥布林从村民那里抢回绿宝石时,你现在会收到一条清晰的仅玩家可见的聊天消息(加上动作栏闪烁),让你能注意到这次免费交易。
  • ? 企鹅寻宝感知现改为发光效果。 不再使用粒子标记,附近玩家从未打开过的容器现在会穿墙发光,且仅对你可见——包括箱子、陷阱箱、木桶和箱子矿车。它也适用于那些预生成战利品的世界(容器看起来“已打开”但没人碰过):只有当玩家真正打开容器后,发光才会消失。探测范围随等级增长(最高 24 格)。

? v1.5.0 新增内容

? 稀有度重构

  • 史诗级现为粉色,旧的非凡级更名为神话级(深紫色)。所有你已拥有的宠物都会自动更新——稀有度从宠物列表实时读取,不针对每个宠物单独存储。
  • 哥布林晋升至神话级。 所有六只原非凡级宠物(Herobrine、Phoenix、Reaper、Ender Dragon、Shadow Dragon、Ancient Elf)以及哥布林现在均为神话级。(extraordinary 仍作为配置/遗留别名有效。)

✨ 粒子效果

  • 每个史诗级及以上的宠物在可见时均拥有与其匹配的ambient粒子光环——仙子精灵火花、死灵法师灵魂、哥布林翡翠闪光、凤凰余烬、监守者幽匿等。龙和独角兽保留其现有的尾迹/闪光效果。

? 能力重做

  • 暗影龙 —— 其光环变为冷却型 AOE 爆发:短暂出现一圈阴影粒子,附近的敌对生物受到伤害,并显示一个Boss 血条,内容为 "AOE 伤害冷却中"。随着等级提升,冷却时间缩短(约 12 秒 → 4 秒)。
  • 末影龙 —— 现在在所有维度都造成额外伤害,而不仅仅是末地。
  • 鼹鼠 —— 现在在使用斧头、镐子或铲子破坏任何方块时都能节省耐久度(此前仅限泥土/沙子/砾石)。
  • 哥布林 —— 移除了击杀掉落金币的特性;改为有一个随等级缩放的小概率机制,使村民交易的绿宝石成本全额退还(即免费购买)。低价交易保持不变。
  • 企鹅 —— 新增寻宝感知:客户端仅在附近未搜刮的结构宝箱/木桶上显示仅你可见的标记,半径随等级增长。
  • 鸡 —— 保留缓慢降落效果,现在会随时间下蛋,等级越高下得越多、越密集。
  • 仙子 —— 随着等级提升,授予更高倍率的更多同时生效的随机增益效果。
  • 河豚 —— 相同的亡灵凋零光环,现在随等级变得更宽、更强。
  • 考拉 —— 相同的树木休息回血效果,再生 I → III 随等级提升。
  • 蜜蜂 —— 修复: 站在普通花朵(罂粟、蒲公英……)旁边现在正确授予再生效果。

⚡ 性能优化

  • 企鹅的箱子扫描仅通过廉价的容器过滤器检查加载的区块;环境粒子效果和扫描已进行节流处理;暗影龙 Boss 血条复用现有的刻钟循环。

? v1.3.2 新增内容

  • ? 修复:预生成宝箱广播。 当战利品在宝箱打开前(例如在世界/区块生成时)已进行随机分配,宠物虽被放置但发现消息从未触发。现在宠物在 loot 阶段即被标记,并在玩家打开容器(或拾取物品)时触发广播,将功劳归于开启者。

v1.3.1 新增内容

  • /pets xpboost give <x2-x5> <time> [player]: 提供宠物经验加成道具,支持灵活的时间设置如 30m、1h、1h30m 或 1d(权限:betterpets.give)。
  • 自定义宠物名称在物品转换后保留: 将重命名的宠物转换回物品时,现在会存储并恢复其名称。
  • 更安全的物品: Better Pets 的道具和经验加成无法通过铁砧重命名。
  • 加成器广播与音效: 经验加成掉落和激活时会公告哪个加成出现或被使用。
  • 更清晰的描述/帮助: 加成器和宠物物品的描述以及 /pets help 现已匹配新版菜单风格。

? v1.3.0 新增内容

  • ⚡ 宠物经验加成器! 敌对生物有极低概率掉落宠物经验加成器(x2-x5),持续时间为 15/30/45/60 分钟。右键激活;它仅加速宠物升级(绝不会影响玩家自身的经验),不可叠加,且计时器仅在您在线时倒计时。加成器作为物品可堆叠,但第二个不会增加额外效果。掉落几率可在 /pets drop 和 config.yml 中配置。主菜单显示您的加成状态(管理员旁边会显示经验倍率)。
  • ✏️ 重命名宠物: /pets set name <name> 重命名您召唤的宠物(保留所有等级/经验/能力),/pets restore name 恢复默认名称。自定义名称会显示在全息图上——适用于头部宠物和 BetterModel 宠物。
  • ? 图鉴: 现在显示每种宠物的稀有度和默认掉落权重,以及更清晰的等级里程碑奖励。
  • ? 更安全的数据: 损坏的 pets.yml 会被隔离(永远不会静默删除),单个损坏的宠物不再导致整个玩家数据的丢失,并且有每日备份(storage.backup,保留 keep-days 天)。
  • ?️ 存储设置 + SQLite 无缝衔接: 新的 storage 配置(type: yaml 为默认值,加上备份选项)。sqlite 是后续版本文档化的可选功能;选择它现在会安全地保持在 YAML 上。
  • ? 配置: 每个选项现在都有注释,启动时会自动修复缺失的选项(保留您的数值)。
  • ? BetterModel: 模型验证警告(标记 BetterModel 未加载的同步 .bbmodel 文件,或缺少动画的模型)以及更清晰的头部回退原因。

? v1.2.7 新增内容

  • ? 全位置可靠的宝箱广播: 发现通知现在针对所有容器触发,包括自定义/数据包结构(例如要塞)中的宝箱,这些地方的先前开启者查找可能会遗漏。开启者通过 loot 事件的实体解析,然后是记录的交互,最后是容器附近的最近玩家。

? v1.2.6 新增内容

  • ?️ 宝库与试炼刷怪笼来源: 宠物现在也可以从宝库和试炼刷怪笼中掉落——无论是原版还是数据包的——直接添加到它们的投掷战利品中。
  • ? 不祥加成: 当宝库/试炼刷怪笼处于不祥状态(任何不祥药水瓶 / 灾厄标志等级 1-5)时,会在基础几率之上添加可配置的 ominous-bonus-percent,因此更高难度的游玩会更频繁地奖励宠物。
  • ? 广播:Player found a … Pet in a Vault! / … in a Trial Spawner!。
  • ⚙️ 两个新来源均可在 /pets drop 和 config.yml 中完全配置,与其他所有来源一样。
  • ? 修复: 刷子现在替换可疑沙/砾石内的物品,这样宠物便自然地刷出方块,而不是在上方弹出。
  • ? 修复: 试炼刷怪笼宠物现在会广播——由于投掷没有触发玩家,发现消息在宠物被拾取时触发。

? v1.2.5 新增内容

  • ? 新的宠物来源! 宠物现在还可以从钓鱼、流浪商人和刷子可疑沙/砾石中获得——除了现有的宝箱战利品。
  • ? /pets drop GUI: 切换每个来源的开/关并调整其几率,就像调整宝箱生成几率一样。(权限:betterpets.chances。)
  • ? 钓鱼: 有较小几率(低于宝箱)钓出宠物,并广播 Player fished out a … Pet!。
  • ? 流浪商人: 生成的商人的可以携带一个一次性交易来购买宠物;价格随稀有度缩放,使用绿宝石加其他贵重物品(金锭、钻石、下界合金)。购买时会广播 Player bought a … Pet from a Wandering Trader!。
  • ? 刷子: 有较小几率从可疑沙/砾石中刷出宠物,并广播 Player brushed out a … Pet!。
  • ⚙️ 每个来源都有自己的可配置几率和开/关切换,就像宝箱一样。
  • ? 修复: 双箱不再能发放两个宠物——两半现在共享一次随机分配。

? v1.2.4 新增内容

  • ? 宠物再次注视你: 修复了反复出现的错误,即宠物面向玩家的视线方向而不是看着玩家(这是 1.2.2 版本的回归)。已在代码中记录以防止再次翻转。
  • ⬇️ /pets update: 直接从 GitHub 下载最新发布的 jar 到服务器的更新文件夹;它将在下次服务器重启时自动应用。仅限管理员。
  • ? 双箱发现广播: 修复了打开双箱(和其他容器)时缺失的发现通知——开启者现在与双箱的两半进行匹配,因此广播不再丢失。

? v1.2.3

  • ⛏️ 无法被修复术抵消的经验值: 宠物经验值现在计入每个经验球的完整数值(挖掘、怪物、熔炉、钓鱼、交易……)——在修复术将其中一部分引导至工具修复之前——因此矿石经验始终有效。
  • ⚡ 更轻量的保存机制: 存储文件不再在每次获得经验时写入;经验值通过定期自动保存以及在退出/禁用时持久化。
  • ? /pets version: 显示插件版本、已启用的模块,并异步检查 GitHub Releases 是否有新版本。
  • ?️ 基于动画的移动: 模型根据其自身动画(walking 与 flying)判断为站立在地面或飞行状态,也可通过模型名称后缀强制指定(ant_grounded / ant_flying)。model-movement-mode 配置选项已被移除。
  • ? 性能优化: 地面模型按区块列缓存其地面高度,而非每tick进行射线投射。

? 目标环境

要求 版本 / 信息
Minecraft / Paper 26.1.2
Java 21(使用 BetterModel 3.x 时推荐使用 Java 25)
可选依赖项 LuckPerms 用于权限分配
可选依赖项 BetterModel 3.x 用于带动画的 .bbmodel 宠物

? 功能特性

  • ? /pets 库存 GUI,用于管理已拥有的宠物
  • ? 宠物图鉴,包含按等级里程碑划分的页面
  • ? 按宠物设置的宝箱生成几率 GUI
  • ? 按稀有度分类的发现广播 GUI,附带基于稀有度的音效
  • ✨ 宠物经验倍率 GUI
  • ? 玩家宠物持久化存储,支持备份
  • ? 仅所有者可访问的羊驼存储,使用 Paper 物品字节序列化
  • ? 动态羊驼存储容量,基于等级变化
  • ? 龙坐骑飞行功能从 50 级解锁
  • ?️ 宝箱战利品集成,支持原版和自定义结构容器
  • ? 通过 BetterModel 实现可选的 3D 宠物渲染,头部回退方案简洁美观

? 命令

命令 描述
/pets 打开主宠物菜单
/pets version 显示版本、活动模块、更新情况
/pets update 下载最新版本(管理员)
/pets help 显示命令帮助
/pets info 打开宠物图鉴
/pets chances 打开生成几率设置
/pets notify 打开发现广播设置
/pets drop 选择宠物来源(宝箱/钓鱼/...)
/pets modules 打开可选模块设置
/pets reload 重载配置、模块、模型、宠物
/pets give <pet|all> [level] [player] 给予测试宠物物品
/pets xpboost give <x2-x5> <time> [player] 给予宠物经验加速物品

? 权限

权限 描述
betterpets.command.pets 允许打开主宠物菜单
betterpets.info 允许打开宠物图鉴
betterpets.chances 允许编辑生成几率、广播和经验倍率
betterpets.give 允许给予测试宠物物品
betterpets.admin 授予所有管理员操作权限,包括 /pets modules 和 /pets reload

⚙️ 重要配置

max-pets-per-player: 45
chest-pet-chance-percent: 2.5
pet-xp-multiplier: 1.0
dragon-flight-speed: 1.5
dragon-flight-lift: 0.55
debug-loot-rolls: false

# 外部模块(BetterModel)为实验性功能,默认禁用。
experimental-modules: false

# 模型渲染(仅在启用 BetterModel 模块时使用)
model-ground-offset: 0.05
model-nametag-height: 2.6
model-facing-yaw-offset-degrees: 0.0

discovery-broadcasts:
  common: true
  rare: true
  epic: true
  legendary: true
  mythical: true

model-overrides: {}

? 可选模块

⚠️ 实验性功能。 外部模块(如 BetterModel)为实验性功能,默认禁用。当 config.yml 中设置为 experimental-modules: false 时,/pets modules 命令将被屏蔽,且不会激活任何外部模块,即使它们在 modules.yml 中已启用。请设置 experimental-modules: true 以加入实验性模块计划。

模块状态存储在:

plugins/BetterPets/modules.yml

在启用 experimental-modules 后,可通过 /pets modules 切换模块。只有在其所需插件已安装并启用的情况下,模块才能被启用。如果某个模块在 modules.yml 中被启用但所需插件缺失,Better Pets 会保留该标志,并在依赖项可用之前跳过激活。


? BetterModel 模块

bettermodel 模块需要 BetterModel 插件。启用后,宠物将以带动画的 3D .bbmodel 模型渲染,而不是漂浮的宠物头颅。

模型文件夹:

plugins/BetterPets/models/

文件命名规则(去掉 .bbmodel 后的名称将不区分大小写地与宠物 ID/名称匹配):

ant.bbmodel
bat.bbmodel
blue_dragon.bbmodel

在 config.yml 中按宠物覆盖模型名称:

model-overrides:
  Ant: tiny_ant
  Blue Dragon: blue_dragon_variant

?️ 动画与移动

Better Pets 会读取每个 .bbmodel 内部声明的动画,并自动驱动它们:

动画 播放时机
idle 主人静止站立时
walking 主人移动且模型处于**接地(grounded)**状态
flying 主人移动且模型处于**飞行(flying)**状态
idle2 … idle9 可选的随机待机变体,在静止站立时播放

模型是处于接地还是飞行状态由系统自动判定:带有 flying 标签的动画表示飞行;不带 flying 标签的 walking 动画表示在地面行走。你也可以通过模型名称强制指定:以 _grounded 结尾的模型始终行走,以 _flying 结尾的模型始终飞行(例如 ant_grounded.bbmodel)。

? 重载模型

当模块启用或执行 /pets reload 命令时,Better Pets 会扫描 plugins/BetterPets/models/ 目录,将发生变化的 .bbmodel 文件复制到 BetterModel 的 models/ 文件夹中,并触发 BetterModel 的重载。它首先尝试使用 BetterModel API 进行重载,若失败则回退到控制台命令:

bettermodel reload

如果缺少 BetterModel、该插件被禁用,或者没有加载匹配的模型,Better Pets 将回退使用宠物头部渲染。

? 资源包说明

BetterModel 会根据 .bbmodel 文件和内嵌纹理自动生成其专属的资源包。原版客户端仍需确保服务器端开启了 BetterModel 的 自动发送 / 主机托管 资源包选项。


? 羊驼储物

羊驼储物空间仅所有者可见,数据保存在以下文件中:

plugins/BetterPets/pets.yml

物品使用 ItemStack.serializeItemsAsBytes 进行存储,保留了现代物品数据,如自定义附魔、PersistentDataContainer 值、插件元数据以及 Paper 的物品数据。

羊驼等级 储物容量
Level 1 9 格
Level 30 18 格
Level 50 27 格
Level 70 36 格
Level 100 54 格

在储物清空之前,装有物品的羊驼无法被切换离开、消失或转化为物品。


?️ 构建

使用 Maven:

mvn clean package

本地备用构建脚本:

.\build.ps1

输出的 jar 包位于:

target/better-pets-26.1.2-plugin.jar

? 安装

  1. 构建 jar 包(或从最新发行版下载)。
  2. 将 better-pets-26.1.2-plugin.jar 放入 Paper 服务器的 plugins 文件夹。
  3. 仅当你想要动画 3D 模型时才需要安装 BetterModel。
  4. 启动一次服务器以生成配置文件和存储文件。
  5. 使用 LuckPerms 或 paper-plugin.yml 中的默认设置来分配权限。
  6. (可选)将 .bbmodel 文件放入 plugins/BetterPets/models/,设置 experimental-modules: true,在 /pets modules 中启用该模块,然后运行 /pets reload。

?️ 箱子战利品说明

宠物掉落发生在 Minecraft 为未打开的已生成容器(箱子、双层箱子、 barrels 和其他方块容器,包括来自数据包的结构)生成容器战利品时。

  • 已打开过的现有容器不会重新投掷。
  • 每个生成的容器最多只能获得一个 Better Pets 物品。
  • 启用 debug-loot-rolls: true 可在控制台中查看战利品投掷尝试。

? 宠物来源

宠物可以从四个来源掉落,每个来源都可以在 /pets drop(或 config.yml 下的 pet-sources 部分)中进行开关和调整:

来源 方式 默认概率
箱子 生成的容器战利品(箱子、双层箱子、木桶、自定义结构) chest-pet-chance-percent (2.5%)
钓鱼 钓出宠物(替换掉落的捕获物) 1.0%
流浪商人 生成的商人身带一次性宠物交易,价格根据稀有度定价 每个商人 25%
挖掘 从可疑的沙/砾石中刷出宠物 1.5%

每次发现都会显示广播消息(例如 Player fished out a Rare Pet: Axolotl!),受与 /pets notify 相同的按稀有度开关限制。


?️ 历史版本

  • v1.2.4 — 宠物再次看向玩家(朝向修复)、/pets update、双层箱子发现广播。
  • v1.2.3 — 经验修补保护、更轻量的保存机制、/pets version、基于动画驱动的模型移动、地面高度缓存。
  • v1.2.2 — 可选的模块系统(实验性)+ BetterModel 模块;宠物隐藏时粒子效果停止。
  • v1.2.1 — 蝙蝠 / 红色鹦鹉 / 监守者的所有者专属发光透视(穿墙可见)。
  • v1.2.0 — 多人游戏修复:个人 Herobrine 天气、舞伴不再拾取他人的物品、安全的加入清理、双层箱子 + 木桶支持。
  • v1.1.0 — 新增三种宠物(鼹鼠、舞伴、诅咒毛绒玩具)、重做凤凰复活机制、稀有度广播音效、EXP: MAXED。

? 致谢

本项目是一个 Paper 插件重写版,灵感来源于原始的 Better Pets 数据包。

? Modrinth 上的 Better Pets

原始项目的所有权利,包括名称、概念、资产及相关内容,均归其各自的权利持有人所有。


⚠️ 免责声明

除非另有明确说明,否则本项目不是官方更新、不是官方续作,也不直接隶属于原始的 Better Pets 项目。它不声称拥有原始项目的任何权利。如果原作者或权利持有人希望移除、更改特定内容或要求不同的署名,请联系仓库所有者。


? 许可证

本 Paper 插件重写版的源代码 依据 MIT License 发布 —— 请参阅 LICENSE。

这仅涵盖插件自身的代码。原始的 Better Pets 名称、概念和资产仍归其各自的权利持有人所有(见上方的 Credits 和 Disclaimer)。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源