Horrifying Lanterns is a Minecraft mod for version 1.20.1 (Forge) that introduces cursed and powerful lanterns to your world. These aren't just light sources; they are mystical artifacts that grant the wielder terrifying abilities at the cost of being tethered to their dark energies.
- Dynamic Lighting: Lanterns emit light while held in your main hand or off-hand.
- Unique Abilities: Each lantern comes with two distinct active abilities (Sanguine Moon: Burst and Leech | Dark Skies: Summon and Wrath).
- Custom Sounds: New atmospheric sounds for minions, including idle breathing and attack screeches.
- Tethering System: Lanterns are bound to their owner. If dropped, lost in a broken chest, or the owner dies, the lantern will attempt to return to the owner's inventory.
- Servant of the Dark Heart: If your inventory is full, a loyal, invulnerable spectral servant will appear to carry your tethered lanterns for you, following you until you have space to take them back.
- Custom Animations: Players and Servants holding a lantern will have a unique "zombie-like" arm pose.
- Atmospheric Effects: Colored particles and sounds enhance the horror experience.
- Addon API: A built-in API with base classes for items, abilities, entities, and renderers allows other modders to easily create their own custom lanterns.
A cursed lantern that feeds on the life essence of those around it. It glows with a deep red light.
- Sanguine Burst (Key: V): Triggers a burst of red energy, granting the player Invisibility for 30 seconds and summoning a swarm of 8 Bats that swirl around the wielder.
- Life Leech (Key: B): Drains health from all nearby living entities (excluding players) within a 5-block radius. Each hit heals the player and permanently increases the player's max health (up to a limit of 50 total health).
- Crafting: Blackstone, Ink Sac, Redstone Block, Glass, and Blaze Powder.
A lantern that harnesses the power of the dark abyss and the storm. It glows with a dark blue light.
- Summon (Key: V): Summons 4 Dark Ones (loyal shadow entities) that hunt down the entity you are currently looking at. If no target is found, they simply guard you. You can only have one set of Dark Ones active at a time.
- Wrath (Key: B): Strikes the target location (up to 32 blocks away) with a bolt of Abyssal Lightning, dealing magic damage to anything caught in the strike.
- Crafting: Blackstone, Ink Sac, Amethyst Block, Glass, and Blaze Powder.
The mod is highly configurable via the in-game config screen (found in the Mod List) or the horrifyinglanterns-common.toml file.
- Light Level: Adjust the brightness of the lantern's light (0-15).
- Abilities: Each lantern has two unique abilities with dedicated cooldowns.
- Feedback: All ability status and cooldown messages are displayed clearly on the action bar.
- Lighting System: A custom block-based system provides real light at the player's feet.
- Atmospheric Tinting: Colored particles provide an immersive glow on the ground and entities.
- Sanguine Discovery: Obtain a Sanguine Moon Lantern.
- Abyssal Discovery: Obtain a Dark Skies Lantern.
- Master of Horrifying Lanterns: Obtain both lanterns to unlock a special challenge advancement with a custom horror-themed background.
🛠️ For Developers: Addon API
Horrifying Lanterns provides a public API for addon creators. You can create your own custom lanterns by extending me.axlerogue.horrifyinglanterns.api.LanternBaseItem.
Features provided by the API:
- Automatic dynamic lighting when held.
- Automatic custom arm holding animation.
- Easy color customization via
lightColor.
- Built-in toggle mechanism (standard keybind 'L').
- Full access to key mappings, abilities, entities, and handlers.
Check out the API_GUIDE.md in the mod files for a full tutorial and code examples. Check out the ISSUE_TRACKER.md for information on how to report bugs or suggest new features.
