PartyAnimals

<div align="center"> <img src="https://raw.githubusercontent.com/MaboroshiKobo/branding/refs/heads/main/projects/partyanimals/partyanimals.avif" width="180" alt="PartyAnimals Logo" /> <h1>PartyAnimals</h1> <p>A modular player engagement plugin for Paper servers designed to reward your community through voting and interactive pinatas.</p>

<p> <img alt="paper" height="56" src="https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/cozy/supported/paper_vector.svg"> <img alt="purpur" height="56" src="https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/cozy/supported/purpur_vector.svg"> <img alt="spigot" height="56" src="https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/cozy/unsupported/spigot_vector.svg"> </p>

<p> <a href="https://github.com/MaboroshiKobo/PartyAnimals"><img alt="github" height="56" src="https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/cozy/available/github_vector.svg"></a> <a href="https://hangar.papermc.io/Maboroshi/PartyAnimals"><img alt="hangar" height="56" src="https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/cozy/available/hangar_vector.svg"></a> <a href="https://modrinth.com/plugin/partyanimals"><img alt="modrinth" height="56" src="https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/cozy/available/modrinth_vector.svg"></a> </p>

<p> <a href="https://docs.maboroshi.org/"><img alt="generic" height="56" src="https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/cozy/documentation/generic_vector.svg"></a> <a href="https://discord.maboroshi.org"><img alt="discord-singular" height="56" src="https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/cozy/social/discord-singular_vector.svg"></a> </p> </div>

Features

PartyAnimals strives to increase player retention with a focus on these core functions:

* It spawns interactive PlaceholderAPI entities that players can hit to receive configurable rewards. Supports standard vanilla mobs or custom models via PlaceholderAPI or PlaceholderAPI! * You can configure their behaviors, allowing pinatas to roam, flee from players, or defend themselves with PlaceholderAPI like *Shockwave* (knockback), *Blink* (teleportation), *Morph* (shapeshifting), and more. * It features a complete voting module that integrates with PlaceholderAPI to track votes, handle offline queuing, and manage community goals. * It includes extensive customization for rewards, messages, and interaction rules, with optional PlaceholderAPI support.

Prerequisites

To use this plugin, your server must be running Paper on `1.21` or higher, and Java 21 or higher.

Dependencies

These dependencies are optional but highly recommended to unlock full functionality:

* NuVotifier (Required for voting features) * PlaceholderAPI * ModelEngine / BetterModel (For custom entity models)

Documentation & Support

For a complete guide on features, commands, and configuration, please visit our wiki. If you have questions or need to report a bug, join our Discord server.

Statistics

This plugin utilizes bStats to collect anonymous usage metrics.