Fervente's Life Hearts

A dynamic life system mod for Minecraft 1.20.1 Forge that introduces a tiered life system with perma-death mechanics, life sacrifice rituals, and player resurrection.

📋 Overview

Fervente's Life Hearts transforms Minecraft's death system into a strategic survival challenge. Players can navigate through different life tiers (Heart, Soul, Pure), manage limited lives, and face permanent death. The mod features ritual systems for player revival, admin commands for server management, and a fully customizable HUD.

Perfect for:
- Hardcore survival servers
- Roleplay communities
- SMP servers with custom death mechanics
- Adventure maps with limited lives

WARNING:
The mod is still in starter releases, 100% survival compability might come on the future. now, the basic config has to be made by an Admin ( 2 Level Permission/Higher )!

✨ Features

🎯 Life Tier System
- Four Life Types:
- Heart Lives: All death counts (no immunities)
- Soul Lives: Immune to environmental deaths (falling, fire, drowning), Any other Death Causes Heart Discount.
- Pure Lives: Immune to creature deaths (mobs, players), Any other Death Causes Heart Discount.
- Canon Life: Special Life, if lost = instant death (optional starter config)

💀 Perma-Death System
- Players become "perma-dead" after losing all lives
- Perma-dead players are kicked from the server with a custom message
- Revival only possible through ritual items or admin commands
- Prevents resource hoarding by perma-dead players

🔮 Ritual System

Soul Sacrifice Ritual
- Players can sacrifice their entire life set to revive another player
- Donor becomes perma-dead but target receives donor's life type and count
- Requires Soul Totem item (must be bound to target player by command, not survival obtainable.)
- Ritual includes particle effects and can be cancelled by damage/movement

Reincarnation Ritual
- Revive perma-dead players with starter lives
- Requires Reincarnation Totem (bound to target player by command, not survival obtainable.)
- Target receives configured starter life type, count, and optional canon
- Perfect for second chances or redemption arcs

🎨 Configurable HUD
- Real-time life display with customizable position:
- Left Center (vertical)
- Right Center (vertical) - default
- Top Center (horizontal)
- Shows current life count, life type, and canon status
- `/lifehud` command for players to adjust their HUD position

🎮 Items

Life Item
- Adds one life to the player's current count (up to maximum)
- Revives perma-dead players with starter lives
- Not survival obtainable

Soul Totem
- Used for Soul Sacrifice ritual
- Another player uses it to sacrifice themselves to revive you
- Not survival obtainable

Reincarnation Totem
- Used for Reincarnation ritual
- Another player uses it to revive you
- Not survival obtainable

⚔️ Reaper System
- Admins can designate players as "Reapers"
- Reapers who kill other players destroy the victim's Canon life instantly
- Strategic PvP mechanic for roleplay servers
- Reaper status managed via `/lifes reaper` command

🎛️ Configuration

All settings configurable via Forge config files (`config/ferventes_life_hearts-common.toml`):
Note: All config can be done in-game!

Starter Settings
```toml
[starter]
# Life type new players receive on first join
starterLifeType = "HEART"
# Number of starter lives (excluding canon)
starterLifeCount = 3
# Whether new players also start with a canon life
starterHasCanon = true
```

Life Limits
```toml
[limits]
# Maximum normal lives a player can hold (excluding optional canon)
maxLives = 10
```

HUD Settings
```toml
[hud]
# Position of the life HUD
# Options: LEFT_CENTER, RIGHT_CENTER, TOP_CENTER
hudPosition = "RIGHT_CENTER"
```

Runtime Config Overrides:
Admins can override config values in-game using commands. These persist until server restart:
- `/lifes config starter `
- `/lifes config max `

🔧 Commands

All commands require OP level 2 (admin permissions):

Life Management:

/lifes add target
Add lives to a specific player
Life types: heart, soul, pure, canon

/lifes add global
Add lives to all online players

/lifes remove target
Remove lives from a specific player

/lifes remove global
Remove lives from all online players

/lifes set target
Change a player's life type (keeps current count)

/lifes check target
Display detailed life information for a player
```

Reaper System:

/lifes reaper set
Designate a player as a Reaper

/lifes reaper remove
Remove Reaper status from a player
```

Configuration:

/lifes config starter
Set runtime starter configuration with or not Canon Life.
Example: /lifes config starter soul 5 false

/lifes config max
Set runtime maximum lives

/lifes config reset
Reset all runtime overrides to file-based config
```

Player HUD:

/lifehud
Change your personal HUD position
Available to all players (no permission required)

📦 Installation

Requirements
- Minecraft: 1.20.1
- Forge: 47.3.0 or higher
- Java: 17 or higher

🎭 Use Cases & Examples

Hardcore SMP Server
```toml
# Brutal settings - 2 lives, no canon
starterLifeType = "HEART"
starterLifeCount = 3
starterHasCanon = false
maxLives = 10
```

Roleplay Server
```toml
# Generous for story arcs - 5 lives + canon
starterLifeType = "SOUL"
starterLifeCount = 5
starterHasCanon = true
maxLives = 15
```

PvP Arena
- Use `/lifes reaper set ` for special PvP roles
- Canon lives become high-value targets
- Soul Sacrifice adds dramatic tension

🔄 Data Management

Player Data Storage
- Lives are stored per-player in NBT data
- Persists across sessions and server restarts
- Automatic client-server synchronization

Life Ban System
- Tracks perma-dead players with pending revivals
- Queues resurrection for next login
- Supports offline player operations

Offline Player Support
- Commands work on offline players via username
- Data verified against server player data files
- Safe handling of invalid usernames

🎨 Localization

Currently supports:
- English (en_us) - Complete

All messages, item names, and tooltips are fully translatable. See `assets/ferventes_life_hearts/lang/en_us.json` for translation keys.

🐛 Known Issues & Compatibility

Fully Compatible With:
- Vanilla Minecraft 1.20.1
- Other mods that don't override death events
- Most server-side utility mods

Potential Conflicts:
- Mods that completely override the death system (e.g., some hardcore mods)
- Mods that modify player respawn logic extensively

🔮 Planned Features

Future updates i may include in future updates:
- Additional life tiers
- Custom ritual types
- Life trading between players
- Integration with economy plugins
- More particle effects and animations
- GUI for life management

📝 License

DO NOT MODIFY
If you plan to use the mod on your server ou minecraft content, please give the credits, or contact me in my discord.

💬 Support & Contact

- Issues & Suggestions: You can give suggestions and report issues about the mod on Curseforge & Modrinth comments or contact me in my discord!
- Discord: fervente
- CurseForge: Well, It´s right here, What u looking for bro?
- Modrinth: Click Here

🙏 Credits

Developer: Fervente
Newest Version: 0.1.0
Built with: Minecraft Forge 1.20.1

Dev Note:
I always saw that cool Minecraft Life mods on servers, and all of them have one thing in common; they are not public, so i decided to make my own!
I hope y´all enjoy it ❤️

Fervente´s Life Hearts