PinnaPets

PinnaPets is a collectable companion-pet system built directly on the PinnaPrison API. Players hatch, level, master and fuse pets that follow them through the mines, boost their income, and fire their own PinnaPrison enchant-style actions on mine, level-up and mastery events. Ships with 9 fully configured pets and requires zero code to add your own.

Pets that actually do things

• Every pet follows its owner with packet-based visuals, glowing, scaling and optional ModelEngine models
• Per-pet boosts to any PinnaPrison currency (tokens, gems, money), all-enchant proc chance, or specific enchant chances — scaling with level and mastery
• Structured action triggers per pet: on-activate, on-deactivate, on-mine, on-proc, on-level-up and on-mastery, each with its own chance gate
• Config-driven action engine with the same YAML format as PinnaPrison custom enchants — give-eco, take-eco, set-eco, break-blocks (sphere/cuboid/disc/ring shapes), proc-enchant, boosters, abilities, messages, titles, sounds, particles, set-variable, delay, loop, weighted rolls, chance and requirement gates, math expressions and {level}/{mastery} placeholders
• Honours Pinna /settings mutes — pet proc chat, sounds and particles respect player toggles

Progression that keeps players mining

• Levels & masteries — pets gain XP from every Pinna block mined, hitting a mastery milestone every N levels with configurable payouts, boosters and abilities
• Fusion — combine two pets into the next tier with per-recipe chance, level modes (AVERAGE, MIN, MAX, SUM, KEEP_FIRST) and fail handling. A full cub → wolf → fox → panda → golem → blaze → wither → dragon line ships by default, plus hybrid recipes
• Pet eggs — hand out eggs as crate or quest rewards; right-click to claim
• Kennel upgrades — server-wide purchasable upgrades: extra pet slots, storage space, global currency and enchant-boost bonds, and pet XP gain, all priced in any PinnaPrison currency
• Rarity system — common to mythic, driving egg lore, menu sorting and display names

Fully configurable, no code

• One YAML file per pet under pets/ — entity, scale, glow, boosts, XP curve, upgrade costs and all action triggers
• Separate config.yml (starter pet, slots, follow behaviour, XP, egg items), upgrades.yml, fusion.yml and messages.yml — every player-facing string is configurable
• Add a new pet by copying a file and editing it — no plugin reload of Java needed, just /pets reload

Commands & permissions

• /pets — opens the collection menu (activate, upgrade, fuse, storage)
• /pets hide | show — toggle pet visibility
• /pets give <player> <pet> [level] and /pets egg — admin handouts (pinnapets.give)
• /pets slots|storage <player> <amount> — edit player caps (pinnapets.slots)
• /pets remove <player> <pet> and /pets reload (pinnapets.admin)
• pinnapets.use defaults to all players; admin nodes default to op

Integration

• PinnaPrison (required) — currencies, boosters, enchant procs, break-blocks mining payouts, action-bar and mute systems all run through the Pinna API
• PlaceholderAPI — %pinnapets_% placeholders for active pet, level, mastery and boosts (optional)

Ideal for PinnaPrison prison servers that want a pet collection layer on top of their existing pickaxe progression — pets are another long-term money sink and status symbol that ties directly into tokens, gems and enchant grinding.