Halloween Plugin v3.0.0 - MAJOR UPDATE

⚠️ BREAKING CHANGES - READ BEFORE UPDATING

Plugin Folder Name Changed:

• Old: plugins/Halloween/
• New: plugins/Halloween_Softici/
• Prevents conflicts with other Halloween plugins
• Auto-detection warns if old folder exists

Config Structure Changed:

• intervals: → events:
• pumpkin_monster: → pumpkin_zombie_boss:
• pumpkin_witch: → pumpkin_skeleton_boss:
• All events now have enabled: true/false flag
• Auto-migration preserves your settings

New Features

Bat Transformation Event (NEW!)

• Bats have 33% chance to transform into witches when killed
• Transformed witches spawn with pumpkin helmet + glow effect
• 1.5x health multiplier
• Random useful potion drops: Strength, Swiftness, Regeneration, Healing, Fire Resistance
• 3-8 pumpkin drops + 5 XP levels
• Fully configurable in config.yml

Per-Event Toggle System

• Each event now has individual enabled: true/false flag
• Disable specific events without removing config sections
• Works immediately after /halloween reload
• Example: Turn off pumpkin heads but keep Slenderman

Critical Bug Fixes

• Fixed: Event enabled: false not working
  
  • Previously, setting enabled: false had no effect
    
  • All 6 event tasks updated (pumpkin, slenderman, fire, lightning, darkness, herobrine)
    
  • Now properly checks enabled flag before scheduling
    
• Fixed: Bat witch potion drops were broken
  
  • Old: Dropped uncraftable potions with no effects
    
  • New: Random useful potions (Strength/Swiftness/Regeneration/Healing/Fire Resistance)
    
  • Uses Minecraft 1.21.1 compatible potion types
    
• Fixed: XP errors in 3 locations
  
  • IllegalArgumentException: Experience must be positive
    
  • Fixed in GraveManager, PumpkinMonsterManager, PumpkinWitchManager
    
  • Now validates XP before setting
    
• Fixed: Config version overwrite during migration
  
  • Config migration no longer overwrites config_version
    
  • Preserves version marker for future updates
    
• Fixed: Deprecated sections added to fresh installs
  
  • Removed pumpkin_protector: (was not working)
    
  • Removed standalone herobrine: (use events.herobrine:)
    
  • Fresh v3.0.0 configs only contain working features
    
• Code Cleanup
  
  • Removed 200+ lines of dead migration code
    
  • Cleaner codebase for future updates
    

Migration Guide

Updating from v1.x/v2.x:

Step 1: Backup your config
Step 2: Stop server, replace JAR file

Step 3: Start server

• Plugin creates new Halloween_Softici/ folder
• Auto-generates v3.0.0 config structure
• Shows warning if old Halloween/ folder detected

Step 4: Migrate player data (optional)
Step 5: Verify and cleanup
Updated Commands

Complete Feature Overview

Scare Events:

• Random pumpkin heads with buffs
• Slenderman teleportation
• Lightning strikes
• Fire spawns
• Darkness effects
• Herobrine 4-stage encounters (night only)
• NEW: Bat transformation witches

Boss Battles:

• Pumpkin Zombie Boss (formerly Pumpkin Monster)
• Pumpkin Skeleton Boss (formerly Pumpkin Witch)
• 4-phase progression
• Minion spawning
• Epic rewards

Grave System:

• Build graves to summon undead armies
• 18-second dramatic animation
• Team-based XP distribution
• Reward chests with diamonds & ancient debris
• 3-wave combat system

Pumpkin Buffs:

• Speed, Strength, Resistance
• Night Vision
• Configurable duration & amplifiers
• Glow effect (optional)

Horror Sounds:

• 16 unique horror sounds
• /halloween sound @a <sound> command
• Tab completion support

Technical Details

• Config Version: 3.0.0
• API: Spigot 1.21.1, Paper 1.21.1+, Purpur 1.21.1+
• Java: 17+
• Permissions:
  
  • halloween.base - Player commands (default: true)
    
  • halloween.admin - Admin commands (default: OP)
    

Documentation

• GitHub: Full documentation, guides, and source code
• Config Auto-Migration: Automatically updates from v1.x/v2.x
• Migration Warnings: Console shows clear instructions
• Release Notes: Complete changelog available

Why Update to v3.0.0?

• No more plugin conflicts - Unique folder name
• New bat transformation event - More variety
• Per-event control - Enable/disable individual events
• 6 critical bugs fixed - More stable
• Cleaner config structure - Easier to manage
• Better code quality - Foundation for future features

Compatible with Minecraft 1.21.1 | Tested on Paper/Purpur | Auto-migration from v1.x/v2.x

⚠️ Important: This is a major version update with breaking changes. Please read the migration guide above before updating. Auto-migration preserves your settings, but manual testing is recommended.

Download v3.0.0 now and enjoy the enhanced Halloween experience!