Weber's Companion Resonance

Standing near your teammates is no longer just positioning—it creates combat resonance that can be built, consumed, and strengthened.

Weber's Companion Resonance is a multiplayer-focused passive skill mod for Minecraft 1.21.1 Fabric. When players stay near another player, they enter a Companion Aura and can use the Pufferfish's Skills skill tree to specialize in survivability, mobility, death prevention, burst damage, or increased aura range.

Current version: 1.1.0-alpha.1. This is an Alpha release. Back up your world and configuration files before updating.

Key Features

• Five parallel three-tier skill branches, for a total of 15 skill nodes
• 7 skill points by default, with a maximum of 7 points spent, encouraging meaningful specialization
• Server-authoritative charge, shield, and damage calculations
• A dedicated multi-bar client HUD that also hides when F1 is pressed
• A separate Cloth Config page for every skill
• Major values, descriptions, colors, HUD settings, and particle settings are configurable through JSON
• Independent Guardian and Fountain shields that coexist with vanilla absorption hearts

Skill Overview

Skill	Type	I	II	III
Fountain of Life	Sustained shield	Max 4, 0.15/s	Max 6, 0.22/s	Max 8, 0.30/s
Adrenaline Rush	Sustained movement speed	+6%	+12%	+18%
Guardian's Resolve	Fatal-damage protection	360s; 2 shield for 2s	180s; 6 shield for 6s	90s; 10 shield for 10s
Kindled Assault	Burst damage	24s; +30% for 0.8s	20s; +40% for 1.2s	16s; +50% for 1.5s
Widened Bond	Aura enhancement	20m	25m	30m

The default Companion Aura radius is 15 meters.

Fountain of Life

While inside a Companion Aura, Fountain of Life gradually increases its active tier and restores an independent Fountain shield. The HUD only displays the Tier II and Tier III threshold markers after those tiers have actually been unlocked.

Adrenaline Rush

Builds resonance while inside the aura and grants 6% / 12% / 18% movement speed based on the currently active tier. It uses a sustained-charge HUD model similar to Fountain of Life.

Guardian's Resolve

Charges slowly while inside the aura. When fully charged and still within the aura, the next fatal hit leaves the player at 1 health and grants a temporary Guardian shield.

After leaving the aura, charge is preserved for 10 seconds, then decays at a rate that empties a full bar in 90 seconds. All three tiers use the same decay duration.

Kindled Assault

Charges while inside the aura. When fully charged and currently within the aura, the next successful damaging hit—and all supported damage dealt during the following short burst window—receives an independent damage multiplier.

After leaving the aura, charge is preserved for 10 seconds, then decays at a rate that empties a full bar in 16 seconds. All three tiers use the same decay duration.

Optional ready-state particles are shown only while the main hand holds an item recognized as a weapon or tool. The particles can inherit player velocity, and their interval, size, position offsets, spread, color, and item-recognition keywords are configurable.

Widened Bond

Widened Bond has no separate progress bar. It directly increases the Companion Aura detection radius used by all other skills.

Shield and Damage Priority

The mod tracks Guardian shields, Fountain shields, and vanilla or third-party absorption separately, then mirrors their combined total to the standard golden absorption-heart display.

Incoming damage is consumed in this order:

1. Guardian's Resolve shield
2. Fountain of Life shield
3. Vanilla or third-party absorption
4. Player health

HUD

Up to four progress bars are displayed in the lower-right corner:

• FoL — Fountain of Life
• AR — Adrenaline Rush
• GR — Guardian's Resolve
• KA — Kindled Assault

Each abbreviation is centered above its bar. Pressing F1 hides both the bars and their labels. Every skill color can be changed independently through JSON or Cloth Config.

Installation and Dependencies

Requirements

• Minecraft 1.21.1
• Fabric Loader
• Java 21 or newer

Recommended Mods

• Fabric API
• Pufferfish's Skills — provides the skill tree interface and skill point system
• Cloth Config API + Mod Menu — provides the in-game configuration screen

The mod contains both server-side gameplay logic and a client-side HUD. For multiplayer use, installing the same version on the server and on every player's client is recommended.

Configuration

After the first launch, the configuration file is located at:

config/companion_resonance.json

Configurable settings include:

• Skill values and English descriptions
• Default skill points and maximum spent points
• Individual colors for all five skills
• Aura radius and detection interval
• Position, width, height, and spacing of the four HUD bars
• Out-of-range grace periods and full-decay durations for Guardian's Resolve and Kindled Assault
• Kindled Assault ready-particle toggle, velocity following, offsets, and weapon/tool recognition keywords

When time values are expressed in ticks, Minecraft normally uses 20 ticks = 1 second.

Highlights of 1.1.0-alpha.1

• Guardian's Resolve: after a 10-second grace period outside the aura, a full bar now takes 90 seconds to decay
• Kindled Assault: after a 10-second grace period outside the aura, a full bar now takes 16 seconds to decay
• Added config_version to support future default-value migrations
• Old configurations using the previous default value of 600 ticks for both decay settings are migrated to 1800 and 320 ticks respectively
• Updated built-in skill descriptions, the example configuration, and release documentation

Known Compatibility Limits

Kindled Assault attempts to resolve the actual player responsible for damage, including melee attacks, vanilla projectiles, and modded spells that retain caster or owner information. Fully custom summons, damage-over-time effects, or special attacks that do not preserve player ownership may not receive the damage bonus.

When Reporting an Issue

Please include:

• latest.log
• Your Companion Resonance version
• Fabric Loader, Fabric API, and Pufferfish's Skills versions
• Reproduction steps and the affected skill tier
• Whether the issue occurs in single-player, LAN multiplayer, or on a dedicated server