🩸 VampiricBehaviour

VampiricBehaviour is a gameplay-focused mod that introduces a complete vampiric system based on night dominance, risk–reward combat, and server-controlled balance.

This mod does not add items or mobs yet.
Instead, it enhances the core player logic, turning vampirism into a deep, configurable gameplay layer suitable for singleplayer, roleplay, and multiplayer servers.

🌙 Bloodlust System

When it is nighttime or the player is under shelter, Bloodlust activates.

While Bloodlust is active:

🗡️ Increased damage
⚡ Increased movement speed
🩸 Lifesteal: recover a percentage of the damage you deal

During the day:

☀️ Damage is heavily reduced

Vampires rule the night — daylight is intentionally unforgiving.

🔥 Frenzy (Low Health Mechanic)

When your health drops below 25%, Frenzy activates automatically.

Frenzy effects:

🛡️ Gain a shield that absorbs the next incoming hit
🔋 Recover stamina on hit
⏳ Shield expires after a short duration or when broken

To prevent abuse, Frenzy can only activate again after the player recovers to a higher health threshold. (85%)

🍖 Satiety (Combat-Driven Hunger)

Vampires must hunt to survive.

🌙 At night, satiety slowly drains
⚔️ Killing any mob restores satiety

Low satiety effects: (20%)

⚠️ Below a threshold, the player starts taking damage
💥 Starvation grants a temporary damage bonus

Once satiety is recovered at (25%), all negative effects are removed.

🤸 Mobility & Fall Damage

Fall damage is reduced both day and night
❗ Only applies when performing a Roll

This rewards skillful movement and timing rather than passive bonuses.

🧠 Custom Vampire HUD

VampiricBehaviour includes a minimal, thematic HUD to clearly communicate vampiric states.

HUD elements include:

🩸 A satiety progress bar
👁️ Eye indicators:
- Eyes open → Night
- Eyes closed → Daylight phase

No numbers, no clutter — only clear visual feedback.

⚙️ Configuration & Server Control

The mod features a fully configurable system designed for servers and custom balance.

On first startup, configuration files are generated automatically, allowing administrators to adjust every major gameplay parameter without recompiling the mod.

Changes made in-game via commands require /vampiric save to be persistent across server restarts.

Configurable systems include:

Satiety drain, recovery, starvation damage & bonus
Frenzy thresholds, duration, cooldowns, shield behavior
Bloodlust damage, lifesteal, sunlight weakness
Day vs night movement speed
Day/night timing and shelter detection
Internal update intervals

All values can be modified via config files or live admin commands.

Admin Commands

All commands require admin permissions.

Config Commands:

Command	Description
`/vampiric`	Show help with all available subcommands
`/vampiric list`	List all parameters with current values
`/vampiric get <key>`	Show the value of a specific parameter
`/vampiric set <key> <value>`	Change a parameter in real-time
`/vampiric reload`	Reload all values from the config file
`/vampiric save`	Save current values to the config file

Usage Examples

Config tuning:

/vampiric set satiety.drain_per_second 0.005
/vampiric set time.night_start_hour 18
/vampiric set damage.bloodlust_multiplier 2.0
/vampiric get frenzy.duration_seconds

🦇 Vampire Registry & Player Control

VampiricBehaviour includes a Vampire Registry system that controls which players are vampires.

This allows the mod to function both as:

A global vampiric survival system
A selectable RPG class

Supported Modes

Everyone is a vampire (default)
Ideal for singleplayer or full-vampire servers.
Opt-in vampirism (class-based servers)
Only selected players gain vampiric abilities.

Non-vampire players:

Receive no vampiric effects
See no vampire HUD elements
Play completely unaffected

Admins can manage vampirism per player using dedicated commands, with all changes persisted across restarts.

Vampire Registry Commands:

Command	Description
`/vampiric vampire`	Show vampire registry help
`/vampiric vampire add <player>`	Make a player a vampire
`/vampiric vampire remove <player>`	Remove vampirism from a player
`/vampiric vampire toggle <player>`	Toggle vampirism on/off for a player
`/vampiric vampire list`

Usage Examples:

Vampire management:

/vampiric vampire add Steve
/vampiric vampire remove Alex
/vampiric vampire toggle Steve
/vampiric vampire list

Setting up a class-based server example:

/vampiric set vampire.default_enabled false
/vampiric save
/vampiric vampire add PlayerWhoChoseVampire

🔮 Planned Feature: Enhanced Dark Vision

A future update will introduce a dark vision system for vampires:

Improved visibility in low-light environments
Reinforces the fantasy of nocturnal dominance
Designed to remain immersive and balanced

This feature is planned and not yet implemented.

🎯 Mod Philosophy

High power at night, real weakness during the day
No item clutter or artificial mechanics
Fully configurable and server-friendly
Designed for fair, immersive vampire gameplay

🩸 Become stronger in the dark. Hunt to survive. Control the curse.