How maboroshikobo/partyanimals works
PartyAnimals is a Paper/Purpur server plugin for configurable pinata events and community voting. A server operator configures pinata templates; players or operators spawn them, the manager activates entity behavior and presentation, and hits trigger cooldowns, reflexes, effects, actions and rewards. Voting adds milestones and reminders through NuVotifier. The graph includes the documented model and PlaceholderAPI integrations. Evidence is limited to README statements, SOURCE INDEX references and supplied excerpts; unsampled subsystem links are omitted or marked unverified.
Main entry points: PinataManager.java Pinata Lifecycle · PartyAnimals.java Plugin Lifecycle · PinataListener.java Hit and Death Events · command Commands
Components 24
Plugin Runtime
- Plugin Lifecycle
src/main/java/org/maboroshi/partyanimals/PartyAnimals.java - Commands
src/main/java/org/maboroshi/partyanimals/command
Pinata Events
- Pinata Creation
src/main/java/org/maboroshi/partyanimals/manager/PinataFactory.java - Pinata Lifecycle
src/main/java/org/maboroshi/partyanimals/manager/PinataManager.java - Hit and Death Events
src/main/java/org/maboroshi/partyanimals/listener/PinataListener.java - Entity Behaviors
src/main/java/org/maboroshi/partyanimals/handler/BehaviorHandler.java - Hit Reflexes
src/main/java/org/maboroshi/partyanimals/handler/ReflexHandler.java - Effects
src/main/java/org/maboroshi/partyanimals/handler/EffectHandler.java - Reward Actions
src/main/java/org/maboroshi/partyanimals/handler/ActionHandler.java - Boss Bars
src/main/java/org/maboroshi/partyanimals/manager/BossBarManager.java
Voting
- Vote Data Store
src/main/java/org/maboroshi/partyanimals/manager/DatabaseManager.java - Vote Commands
src/main/java/org/maboroshi/partyanimals/command/VoteCommand.java - Vote Goals
src/main/java/org/maboroshi/partyanimals/manager/VoteManager.java - Vote Listener
src/main/java/org/maboroshi/partyanimals/listener/VoteListener.java - Vote Reminders
src/main/java/org/maboroshi/partyanimals/task/VoteReminder.java
Configuration and Integrations
- Settings and Templates
src/main/java/org/maboroshi/partyanimals/config/ConfigManager.java - Message Formatting
src/main/java/org/maboroshi/partyanimals/util/MessageUtils.java - ModelEngine Adapter
src/main/java/org/maboroshi/partyanimals/hook/ModelEngineHook.java - BetterModel Adapter
src/main/java/org/maboroshi/partyanimals/hook/BetterModelHook.java - PlaceholderAPI Adapter
src/main/java/org/maboroshi/partyanimals/hook/PlaceholderAPIHook.java
Other components
- Server Operator
- Players
- Paper Server
- NuVotifier
Connections 31
- Server Operator → Commands: runs commands
src/main/java/org/maboroshi/partyanimals/command/PinataCommand.java - Players → Commands: runs commands
- Plugin Lifecycle → Settings and Templates: loads settings
src/main/java/org/maboroshi/partyanimals/PartyAnimals.java - Plugin Lifecycle → Vote Data Store: connects store
src/main/java/org/maboroshi/partyanimals/PartyAnimals.java - Plugin Lifecycle → Commands: registers commands
src/main/java/org/maboroshi/partyanimals/PartyAnimals.java - Commands → Pinata Lifecycle: requests pinatas
src/main/java/org/maboroshi/partyanimals/command/PinataCommand.java - Commands → Settings and Templates: reads settings
src/main/java/org/maboroshi/partyanimals/command/PinataCommand.java - Pinata Lifecycle → Pinata Creation: creates entities
src/main/java/org/maboroshi/partyanimals/manager/PinataManager.java - Pinata Lifecycle → Entity Behaviors: applies behavior
src/main/java/org/maboroshi/partyanimals/manager/PinataManager.java - Pinata Lifecycle → Boss Bars: tracks pinatas
src/main/java/org/maboroshi/partyanimals/manager/PinataManager.java - Pinata Lifecycle → Settings and Templates: reads templates
src/main/java/org/maboroshi/partyanimals/manager/PinataManager.java - Hit and Death Events → Pinata Lifecycle: checks pinata
src/main/java/org/maboroshi/partyanimals/listener/PinataListener.java - Hit and Death Events → Hit Reflexes: triggers reflexes
src/main/java/org/maboroshi/partyanimals/listener/PinataListener.java - Hit and Death Events → Effects: plays effects
src/main/java/org/maboroshi/partyanimals/listener/PinataListener.java - Hit and Death Events → Reward Actions: runs actions
src/main/java/org/maboroshi/partyanimals/listener/PinataListener.java - Hit and Death Events → Boss Bars: updates bars
src/main/java/org/maboroshi/partyanimals/listener/PinataListener.java - Hit Reflexes → Effects: plays effects
src/main/java/org/maboroshi/partyanimals/handler/ReflexHandler.java - Hit Reflexes → Reward Actions: runs actions
src/main/java/org/maboroshi/partyanimals/handler/ReflexHandler.java - Reward Actions → Paper Server: dispatches commands
src/main/java/org/maboroshi/partyanimals/handler/ActionHandler.java - Plugin Lifecycle → Vote Goals: initializes goals
src/main/java/org/maboroshi/partyanimals/PartyAnimals.java - Vote Commands → Vote Goals: manages goals
- Vote Listener → Vote Goals: records votes
src/main/java/org/maboroshi/partyanimals/manager/VoteManager.java - Vote Goals → Vote Data Store: stores vote data
- Vote Reminders → Players: sends reminders
- NuVotifier → Vote Listener: delivers votes
- Plugin Lifecycle → ModelEngine Adapter: sets up optional hook
src/main/java/org/maboroshi/partyanimals/PartyAnimals.java - Plugin Lifecycle → BetterModel Adapter: sets up optional hook
src/main/java/org/maboroshi/partyanimals/PartyAnimals.java - Plugin Lifecycle → PlaceholderAPI Adapter: sets up optional hook
src/main/java/org/maboroshi/partyanimals/PartyAnimals.java - Pinata Lifecycle → ModelEngine Adapter: uses model adapter
src/main/java/org/maboroshi/partyanimals/manager/PinataManager.java - Pinata Lifecycle → BetterModel Adapter: uses model adapter
src/main/java/org/maboroshi/partyanimals/manager/PinataManager.java - Players → Hit and Death Events: hits pinatas