Lama Party - Vote-Based Boss Event Plugin

What is Lama Party? Lama Party is a unique vote-based boss event plugin that rewards your players for voting! When players vote for your server, they contribute to spawning an epic Boss Llama. Players must work together to defeat the boss, and the top damagers receive amazing rewards! ✨ Why Choose Lama Party? • Encourages Voting: Players are motivated to vote to trigger the event • Community Engagement: Players work together to defeat the boss • Highly Rewarding: Top damagers get customizable rewards (items, money, permissions, tags) • Dynamic Boss AI: Boss gets faster and smarter as it takes damage • Pet System: Boss spawns helper llamas when damaged • Multi-Language: 7 built-in languages with easy customization • MySQL Integration: Persistent statistics and leaderboards • PlaceholderAPI Support: Use placeholders in scoreboards and tab lists • Easy Configuration: Simple YAML files with smart updates How It Works 1. Players Vote → Each vote increments the counter 2. Threshold Reached → When votes reach the required amount (default: 10), the event starts 3. Boss Spawns → A powerful Boss Llama spawns at the configured location 4. Battle Begins → Players attack the boss together 5. Boss Reacts → Boss runs away from attackers, spits, and gets faster as it takes damage 6. Pets Spawn → Boss spawns helper llamas every 100 damage taken 7. Boss Defeated → Top 10 damagers receive rewards 8. Statistics Saved → All damage and kills are saved to MySQL 9. Counter Resets → Vote counter resets for the next event Key Features ️ Voting System • Multi-Plugin Support: Works with Votifier, NuVotifier, VotingPlugin, SuperbVote, and GAListener • Configurable Threshold: Set how many votes are needed (default: 10) • Vote Reminders: Automatic reminders every X votes with chat, title, and sounds • Persistent Counter: Vote count saves across server restarts • Admin Controls: Manually start/stop events with commands Boss Mechanics • Stationary Start: Boss stays still until first damage (AI disabled) • Dynamic AI: AI activates on first hit, boss starts moving • Escape Behavior: Boss runs away from attackers when hit • Speed System: Boss speed increases with damage (0.3 → 0.8) • Spit Attack: Boss targets and spits at attackers • Pet Spawning: Spawns 3 helper llamas every 100 damage • Teleportation: Boss can teleport randomly every 50 damage • Area Restriction: Boss cannot leave the defined area • Custom Health: Fully configurable (default: 1000 HP) • Boss Bar: Real-time health display for all players Reward System • Top Damagers: Rewards for top 10 players (configurable) • Boss Rewards: Execute any command (give items, money, permissions, tags) • Pet Rewards: Separate rewards for killing helper llamas • LuckPerms Integration: Give permissions, prefixes, suffixes, and groups • Custom Messages: Personalized reward messages with placeholders • Multiple Tiers: Different rewards for 1st, 2nd, 3rd place, etc. Statistics & Leaderboards • MySQL Database: Persistent data storage • Track Everything: Total damage, boss kills, pet kills • Leaderboard Command: /lamatop with pagination • Player Stats: View your own statistics • PlaceholderAPI: Use stats in scoreboards and tab lists Visual & Audio Effects • Area Music: Atmospheric music plays in the event area • Particle Effects: Colorful aura around the boss • Fireworks: Explosive effects when boss takes damage • Damage Sounds: Random sounds when boss is hit • Boss Bar: Rainbow-colored health bar • Dance Effect: Boss jumps continuously Multi-Language Support • 7 Built-in Languages: English, Turkish, Spanish, French, German, Russian, Portuguese • Easy Translation: Copy and translate language files • Full Customization: All messages support color codes • Automatic Loading: Language files auto-generate on first run Commands /lamaparty help - Show all commands /lamaparty setspawn - Set boss spawn point (required) /lamaparty setarea - Start area selection with particles /lamaparty areaconfirm - Confirm area selection /lamaparty areacancel - Cancel area selection /lamaparty areashow - Show current area with particles /lamaparty arearemove - Remove configured area /lamaparty reload - Reload configuration /lamaparty stats - View current vote statistics /lamaparty start - Manually start event (admin) /lamaparty stop - Stop active event (admin) /lamaparty reset - Reset vote counter (admin) /lamatop [page] - View kill leaderboard Permissions lamaparty.setspawn - Set spawn point (OP) lamaparty.setarea - Set event area (OP) lamaparty.areashow - Show event area (OP) lamaparty.arearemove - Remove event area (OP) lamaparty.reload - Reload plugin (OP) lamaparty.start - Start event manually (OP) lamaparty.stop - Stop active event (OP) lamaparty.reset - Reset vote counter (OP) Installation & Setup Step 1: Requirements • Server: Spigot or Paper 1.20 - 1.21.11 • Java: Version 17 or higher • Voting Plugin: Votifier, NuVotifier, VotingPlugin, SuperbVote, or GAListener • MySQL (optional but recommended for statistics) Step 2: Install Plugin 1. Download LamaParty.jar 2. Place it in your server's plugins folder 3. Start your server 4. Plugin will generate default files in plugins/LamaParty/ Step 3: Configure MySQL (Recommended) Edit plugins/LamaParty/config.yml: database: host: "localhost" port: 3306 database: "lamaparty" username: "root" password: "your_password" Step 4: Set Language & Vote Threshold settings: language: en votes-required: 10 Step 5: Set Spawn Point 1. Go to where you want the boss to spawn 2. Run command: /lamaparty setspawn 3. You'll see: "Lama spawn point set!" Step 6: Set Event Area 1. Run command: /lamaparty setarea 2. Click a block for the first corner 3. Click another block for the second corner 4. Run command: /lamaparty areaconfirm 5. Area is now set! (Boss will stay within this area) Step 7: Test the Event • Run /lamaparty start to manually start an event • Or have players vote to trigger it automatically Step 8: Configure Rewards (Optional) Edit plugins/LamaParty/rewards/rewards.yml to customize rewards for top damagers. Supports any command including items, money, permissions, and tags. ⚙️ Configuration Easy Configuration All settings are in simple YAML files with comments explaining each option: • config.yml: Main settings (votes, boss health, speed, effects, etc.) • rewards/rewards.yml: Boss kill rewards for top damagers • rewards/pet-rewards.yml: Pet kill rewards • languages/messages_XX.yml: All messages in your language Smart Config Updates When you update the plugin: ✅ Your settings are automatically preserved ✅ New options are added with default values ✅ No need to delete config files ✅ Seamless upgrade experience What You Can Configure • Vote threshold and reminders • Boss health, speed, and behavior • Pet spawning system • Reward commands and messages • Area music settings • Visual effects (particles, fireworks, sounds) • Boss bar appearance • Language selection • MySQL database connection • And much more! ️ PlaceholderAPI Support Available Placeholders Vote System: • %lamaparty_votes_current% - Current vote count • %lamaparty_votes_required% - Required votes • %lamaparty_votes_remaining% - Votes remaining • %lamaparty_votes_status% - Format: current/required (e.g., "5/10") Party Status: • %lamaparty_party_active% - "Yes" or "No" • %lamaparty_party_active_bool% - "true" or "false" Player Statistics: • %lamaparty_player_boss_kills% - Player's boss kills • %lamaparty_player_total_damage% - Player's total damage Usage in Scoreboard: lines: - "&6&lLama Party" - "&eVotes: &f%lamaparty_votes_status%" - "&eParty Active: &f%lamaparty_party_active%" - "" - "&eYour Boss Kills: &f%lamaparty_player_boss_kills%" - "&eTotal Damage: &f%lamaparty_player_total_damage%" Troubleshooting Boss Not Spawning Solutions: 1. Check spawn point is set: /lamaparty setspawn 2. Check area is set: /lamaparty setarea then /lamaparty areaconfirm 3. Verify spawn point is within the area 4. Check console for errors Votes Not Counting Solutions: 1. Check voting plugin is installed (Votifier, NuVotifier, VotingPlugin, etc.) 2. Check console for "VOTE DETECTED!" message 3. Enable debug mode in config: advanced.debug: true 4. Test with /fakevote (if using VotingPlugin) Database Connection Failed Solutions: 1. Verify MySQL server is running 2. Check database credentials in config.yml 3. Ensure database exists (plugin auto-creates tables, not database) 4. Plugin will work without database (no statistics) Music Not Playing Solutions: 1. Ensure area is configured: /lamaparty setarea 2. Check area-music.enabled: true in config 3. Verify sound name is valid (e.g., "MUSIC_DISC_CAT") 4. Test with different sound Boss Escapes Area Solutions: 1. Check area is properly set: /lamaparty areashow 2. Verify spawn point is inside the area 3. Make area larger if needed 4. Boss is teleported back if it leaves Supported Languages Built-in translations: English (en) - Default Turkish (tr) - Türkçe Spanish (es) - Español French (fr) - Français German (de) - Deutsch Russian (ru) - Русский Portuguese (pt) - Português Add Your Language: 1. Copy plugins/LamaParty/languages/messages_en.yml 2. Rename to messages_