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.

• 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).