Puffsprout

Puffsprout 是一款适用于 Minecraft NeoForge 的伙伴宠物模组。它添加了一种圆润、漂浮且长着叶耳的伙伴,具有高度的适应性、可升级性,并能对玩家的行为做出实时反应。与标准的静态宠物不同,Puffsprout 会根据你当前的实时行为动态切换状态。它可以与你并肩作战,骑在你的肩膀上扫描危险,拾取掉落的物品,并在你休息时与其他宠物一起玩耍。
核心行为状态
在每个游戏刻(tick)中,服务器都会检查你的当前活动,并立即将你的 Puffsprout 切换为以下四种状态之一:
| 行为状态 |
触发条件 |
动作与机制 |
| 中立 |
默认 / 闲置 |
在附近漂浮,执行自定义的闲置变体动画(警觉、受惊、困倦、展示),并瞥视附近的玩家或生物。 |
| 战斗 |
主人正在攻击或被攻击 |
发射高速弹球式冲刺攻击,并向敌对目标发射风之充能。 |
| 潜行 |
主人正在蹲下 |
骑在主人的肩膀上,扫描周围环境以寻找隐藏的敌人,并用发光轮廓高亮显示它们(类似于发光效果)。 |
| 拾取 |
附近有掉落的物品 |
飞过去收集掉落的物品并将其直接扔回给你。内部上限防止了自动化农场的滥用。 |

行为模式
你可以通过打开其图形用户界面(空手右键点击)并选择以下三种模式之一来管理宠物的通用行为:
- 跟随 (FOLLOW):默认模式。宠物会跟随你,并根据你的行为在战斗、潜行、拾取和中立状态之间主动切换。
- 坐下 (SIT):宠物保持静止并抑制所有跟随和活动目标。如果在此模式下受到攻击,它会立即切回跟随模式以自卫。
- 玩耍 (PLAY):将宠物锚定在其当前位置的 30 格游玩半径内。它将忽略战斗和跟随目标,以便与其他宠物或玩具互动。
[!NOTE] 躲避投射物:Puffsprout 拥有高优先级的躲避行为,无论处于何种活动模式都会运行。它们会自动躲避来自你以外的箭矢、三叉戟和其他投射物。

互动游玩模式
当保持在 玩耍 (PLAY) 模式时,Puffsprout 会根据周围环境执行三种不同的子行为:
- 球类游戏:投掷 玩耍球 玩具会启动一个回合制游戏。附近处于玩耍模式的宠物会聚集在一起,轮流追逐并将球轻推给彼此。
- 感染抓人游戏:如果有两只或更多宠物处于玩耍模式且没有球,它们将开始玩抓人游戏。一只宠物被随机选中成为感染者,并追逐其他宠物。一旦所有宠物都被抓住,经过短暂延迟后开始新一轮游戏。
- 漫游:如果没有玩具或其他宠物,宠物会在其锚点周围轻轻环绕,并带有自定义的弹跳和跳跃动画。

RPG 进度系统
Puffsprout 会通过自身的行动(例如命中攻击、击杀生物、标记隐藏目标以及拾取物品)获得经验值。获得经验值可以让它们升级并获得技能点,你可以通过这些技能点在宠物的 GUI 中分配到三个属性中:
- 战斗 (攻击伤害):增加近战命中伤害。
- 拾取 (拾取半径):扩大宠物扫描和检索掉落物品的范围。
- 潜行 (扫描半径):扩大宠物高亮显示隐藏敌人的距离。
可叠加特性
在等级 10、20 和 30 时,你可以选择一个永久特性。如果多次选择,这些特性可以叠加:
- 好斗 (Feisty):减少宠物风之充能攻击的冷却时间。
- 拾取者 (Fetcher):增加基础物品搜索范围。
- 鬼祟 (Sneaky):增加基础潜行扫描范围。
可解锁能力
分配技能点可以解锁强大的主动能力,你可以将其装备到 GUI 中,并使用 哨子 物品远程触发:
- 防护屏障 (战斗):为主人提供吸收护盾。
- 风爆 (战斗):发出冲击波,击退附近的所有实体。
- 诱饵 (潜行):清除附近针对你的敌人的仇恨锁定。
- 隐身 (潜行):为主人提供短暂的隐身效果。

可制作的装备与方块
该模组引入了几种自定义物品和方块来管理你的伙伴:
空气压缩机
用于复活 漏气的 Puffsprout。如果你的宠物在战斗中被击败,它会变成物品形式——漏气的 Puffsprout,保留其等级、属性和特性。将其放置在空气压缩机中可以在短暂延迟后复活它。但会受到经验和羁绊值的惩罚。
日志
由书和羽毛合成。右键点击你的宠物以链接日志,然后在空中右键点击以打开自定义羊皮纸 GUI。它会显示宠物的统计数据——包括喂食次数、击杀数、拾取物品数和扔球数——以及你与宠物关系进展的时间线(陌生人、相识、朋友和羁绊)。

口哨
由山羊角和线合成。允许你在远处触发宠物已装备的主动能力。Shift+右键点击会打开一个能力选择界面,以便在未锁定的能力之间切换。
玩球
由粘液球和羊毛合成。这是一种可投掷的玩具,具有自定义的弹跳物理效果(撞击音效和粒子),当宠物处于 PLAY 模式时会追逐并轻推它。
个性化与外观
- 头带:用任意羊毛块右键点击你的宠物即可为其佩戴彩色头带。使用剪刀可以移除头带。
- 命名:对宠物使用原版命名牌来为其命名,名称将显示在其 GUI 和悬浮名字标签中。
- 动画:基于 GeckoLib 集成开发,包含平滑的飞行方向身体旋转、着陆时的网格对齐以防止滑动,以及独特的待机变体动画。
进度树
专门的进度选项卡用于追踪宠物的里程碑进展:
- Puffsprout:将一只 Puffsprout 带入你的世界。
- Puffsprout is here!:驯服你的第一只 Puffsprout。
- Growing Strong:首次提升宠物的等级。
- True Identity:选择你的第一个永久特质层级。
- Peak Puff:将宠物训练至最高等级。
- Chronicler:链接日志以记录宠物的历史。
- Call of the Wild:使用口哨触发一项能力。
- Reinflated:在空气压缩机中复活一只泄气的宠物。
- True Companion:将宠物的等级和羁绊值均提升至最大,并至少复活它一次。
默认情况下,首次加入游戏时会向玩家赠送一只泄气的 Puffsprout,但你也可以在箱子中找到它。
反馈与错误报告
我们非常重视反馈意见。如果你遇到任何错误、性能问题,或对未来功能和改进有建议,请提交报告。
技术规格
- Minecraft 版本:26.2
- NeoForge 版本:26.2.0.25-beta 或兼容版本
- Java 版本:25
- 依赖项:GeckoLib 5.5.3
Puffsprout

Puffsprout is a companion pet mod for Minecraft NeoForge. It adds a round, floating, leaf-eared companion that is highly adaptive, levelable, and reactive to your actions. Unlike standard static pets, Puffsprouts dynamically transition between behaviors depending on what you are doing in real time. They can fight alongside you, ride on your shoulder to scan for danger, fetch dropped items, and play games with other pets when you are resting.
Core Behavior States
Every game tick, the server checks your current activity to instantly transition your Puffsprout into one of four states:
| Behavior State |
Trigger Condition |
Actions and Mechanics |
| Neutral |
Default / Idle |
Floats nearby, performing custom idle variant animations (alert, startle, sleepy, flourish) and glancing at nearby players or creatures. |
| Combat |
Owner is attacking or attacked |
Launches high-velocity pinball-like dash attacks and fires wind charges at hostile targets. |
| Stealth |
Owner is crouching |
Rides on your shoulder and scans the surroundings for hidden hostiles, highlighting them with glowing outlines (similar to the glowing effect). |
| Fetching |
Dropped items are nearby |
Flies to collect dropped items and throws them back directly to you. An internal cap prevents automated farm exploitation. |

Behavior Modes
You can manage your pet's general behavior by opening its GUI (right-click with an empty hand) and selecting one of three modes:
- FOLLOW: Default mode. The pet follows you and actively switches between Combat, Stealth, Fetching, and Neutral states based on your actions.
- SIT: The pet freezes in place and suppresses all follow and activity goals. If attacked in this mode, it immediately snaps back to FOLLOW mode to defend itself.
- PLAY: Anchors the pet to its current position within a 30-block play radius. It will ignore combat and follow goals to interact with other pets or toys.
[!NOTE] Dodge Projectiles: Puffsprouts have a high-priority dodge behavior that runs regardless of the active mode. They will automatically dodge incoming arrows, tridents, and other projectiles not fired by you.

Interactive Play Mode
When left in PLAY mode, Puffsprouts execute three distinct sub-behaviors based on their surroundings:
- Ball Play: Throwing a Play Ball toy initiates a turn-based game. Nearby play-mode pets will gather in a rotation to chase and nudge the ball toward each other.
- Infection Tag: If two or more pets are in Play mode without a ball, they will start a game of tag. One pet is randomly chosen to be infected and chases the others. Once all pets are caught, a new round begins after a short delay.
- Wander: If no toys or other pets are present, the pet orbits gently around its anchor with custom bouncing and hopping animations.

RPG progression
Puffsprouts earn experience from their own actions (e.g., landing hits, killing mobs, pinging hidden targets, and fetching items). Earning XP allows them to level up and gain skill points, which you can distribute into three stats via the pet's GUI:
- Combat (Attack Damage): Increases melee hit damage.
- Fetch (Fetch Radius): Expands the range in which the pet scans for and retrieves dropped items.
- Stealth (Scan Radius): Expands the distance at which the pet highlights hidden enemies.
Stackable Traits
At levels 10, 20, and 30, you can choose a permanent trait. These traits stack if selected multiple times:
- Feisty: Reduces the cooldown of the pet's Wind Charge attack.
- Fetcher: Increases the base item search range.
- Sneaky: Increases the base stealth scanning range.
Unlockable Abilities
Distributing skill points unlocks powerful active abilities that you can equip via the GUI and trigger remotely using the Whistle item:
- Protective Barrier (Combat): Grants the owner an Absorption shield.
- Wind Burst (Combat): Emits a burst that knocks back all nearby entities.
- Decoy (Stealth): Clears the targeting aggro of nearby hostiles targeting you.
- Invisibility (Stealth): Grants the owner brief invisibility.

Craftable Equipment and Blocks
The mod introduces several custom items and blocks to manage your companion:
Air Compressor
Used to revive a Deflated Puffsprout. If your pet is defeated in combat, it turns into an item form as a Deflated Puffsprout, preserving its level, stats, and traits. Placing it in the Air Compressor revives it after a short delay. But a penalty to XP and Bond will be dealt.
Journal
Crafted with a Book and a Feather. Right-click your pet to link the Journal, then right-click in the air to open a custom parchment GUI. It displays your pet's statistics—including times fed, kills, items fetched, and balls thrown—along with a chronological timeline of your bond progression (Stranger, Acquaintance, Friend, and Bonded).

Whistle
Crafted with a Goat Horn and String. Allows you to trigger your pet's equipped active ability from a distance. Shift-right-click opens an ability-selection screen to swap between unlocked abilities.
Play Ball
Crafted with a Slime Ball and Wool. A throwable toy with custom bounce physics (impact sounds and particles) that pets chase and nudge when in PLAY mode.
Personalization and Cosmetics
- Headbands: Right-click your pet with any wool block to apply a colored headband. Use shears to remove it.
- Naming: Apply a vanilla Name Tag to name your pet, which will be displayed in its GUI and hover nameplate.
- Animations: Built with GeckoLib integration, featuring smooth flight-direction body rotation, grid snapping on landings to prevent sliding, and unique idle variations.
Advancement Tree
A dedicated advancement tab tracks your pet's progression milestones:
- Puffsprout: Bring a Puffsprout into your world.
- Puffsprout is here!: Tame your first Puffsprout.
- Growing Strong: Level your pet up for the first time.
- True Identity: Select your first permanent trait tier.
- Peak Puff: Train your pet to its maximum level.
- Chronicler: Link a journal to record your pet's history.
- Call of the Wild: Use the whistle to trigger an ability.
- Reinflated: Revive a deflated pet in the Air Compressor.
- True Companion: Maximize your pet's level and bond, and revive it at least once.
Deflated Puffsprout is given to the player on first join by default, but you can also find it in chests.
Feedback and Bug Reporting
Feedback is highly valued. If you encounter any bugs, performance issues, or have suggestions for future features and improvements, please report them.
Technical Specifications
- Minecraft Version: 26.2
- NeoForge Version: 26.2.0.25-beta or compatible
- Java Version: 25
- Dependencies: GeckoLib 5.5.3
评论 0
登录后参与评分
还没有评论,来抢沙发吧