All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

• The Dark Heart Event: A sinister event that triggers every 60 seconds. Players holding the lanterns will hear the new dark_whispers.ogg sound and receive a red, localized whisper from the Dark Heart in their chat.
• Extensive Localization Support: Massively expanded translation files, bringing native support to over 20+ distinct languages and regional variants (including Spanish, French, German, Russian, Chinese, Japanese, Korean, Portuguese, Italian, Turkish, Dutch, Swedish, Ukrainian, Czech, Indonesian, Vietnamese, Danish, Finnish, Norwegian, Hungarian, Greek, Bulgarian, Thai, Arabic, Romanian, Hebrew, Hindi, and Malay).

• Venom Fang Lantern: A new cursed lantern glowing with a sickly green light.
  • Poison AOE Ability (Key: V): Releases a toxic cloud inflicting Poison II on all nearby living entities within an 8-block radius for 10 seconds.
  • Spider Pacification Ability (Key: B): Calms nearby spiders, dropping their aggression and causing them to flee from the player in fear.
• Ownership System: Lanterns now automatically bind to the first player that uses them. Only the true owner can toggle the lantern or use its abilities.
• Minion Alliance: Player-owned entities (like Servants and Dark Ones) are strictly allied with their owner and each other. Friendly fire from the owner is entirely prevented.
• Creeper Repellent: The terrifying aura of lit lanterns naturally scares away any Creepers that get too close.
• Auto-Extinguish: Lit lanterns now automatically extinguish themselves after a configurable amount of in-game minutes to maintain gameplay balance.
• Config Option: Added Auto-Extinguish (Mins) setting to the in-game configuration screen (defaults to 10 minutes).

• Servant of the Dark Heart Overhaul: Entirely rebuilt the servant AI and spawning mechanics (ServantSpawnHandler):
  • Servants now dynamically spawn based on the exact quantity of dropped lanterns when an owner's inventory is full.
  • Implemented a priority queue that serves players who dropped the most lanterns first.
  • Designed 4 custom AI goals so servants will actively seek out dropped lanterns, pick them up, follow the player, and gracefully return them (with a poof particle effect) as soon as inventory space frees up.
• Comprehensively updated Wiki documentation, API Guide, Guidelines, and README to reflect the new API additions, Ownership systems, and Venom Fang features.

• Re-equip Animation Glitch: Overrode shouldCauseReequipAnimation to prevent the lantern from rapidly bobbing/re-equipping visually in first-person mode every tick while its internal NBT data updates.

• Removed the old TetherHandler and LanternStorage features (including Ender Chest manipulation and drop-prevention) to transition cleanly to the strict Ownership & Servant dynamic-spawning system.

• Community Support: Created ISSUE_TRACKER.md with contribution guidelines, reporting rules, and issue labels.
• Custom Sounds: Integrated new atmospheric sounds for Dark Ones and Servants of the Dark Heart.
  • Added minion_idle (breathing) and minion_attack (random screech) sound events.
  • Added localized subtitles for minion sounds.
• Updated README.md to include custom sound documentation and links to the issue tracker.

• Set the breathing sound as the death sound for both Dark Ones and Servants of the Dark Heart.

• Fixed a bug where lanterns would duplicate if the player died in a different dimension than their current one.
• Improved tethering logic to ensure lanterns are properly removed from the world after being returned to the player.
• Fixed an issue where custom sounds were not playing due to incorrect file naming conventions.

• Servant of the Dark Heart: A new tamable, flying, and invulnerable entity that carries tethered lanterns for the player when their inventory is full.
  • Automatically summoned when a tethered lantern is dropped (e.g., from a broken chest or manually tossed).
  • Displays the carried lantern in hand with a unique animation.
  • Automatically returns the lantern to the player's inventory when space becomes available.
  • Always displays its nametag above its head.
• Lantern Tethering Enhancements:
  • Prevented lantern storage in Ender Chests to ensure dark energy remains within the physical world.
  • Improved logic for returning tethered items to owners upon death or world events.
• Added carrying animations and inventory support for the Servant of the Dark Heart.

• Removed the experimental "Tethered Heart" GUI and related configuration settings.
• Increased default lantern storage reliability.

• New SUMMON and WRATH ability types for Dark Skies Lantern.
• Modular ability system using BaseAbility classes.
• API base classes: BaseEntity, BaseLivingEntity, BaseEntityRenderer, BaseLivingEntityRenderer, and BaseKeyMapping.
• Standardized action bar feedback for all abilities and cooldowns.

• Refactored DarkSkiesLanternItem to use the new Summon and Wrath abilities.
• Relocated and renamed existing Dark Skies Lantern logic to align with new ability types.
• Updated LanternBaseItem to include an internal ability registry for easier extension.
• Moved ability feedback (cooldowns, status) from network packets to item/ability classes for better encapsulation.

• AGPL-3.0 license file and headers.
• Comprehensive wiki documentation covering lanterns, abilities, models, recipes, and advancements.
• Project README with license details.

• Improved lighting system by implementing a custom solution.
• Refactored codebase to remove unused legacy entity, handler, and client-side classes.

• Cleaned up legacy lantern features.

• Initial release of Horrifying Lanterns.
• Spooky lantern items with unique abilities.
• Network packets for lantern toggling and abilities.
• Player animation and lighting handlers.
• Language support (en_us).