C&N Effects

EffectsHUD adds a framework for applying status effects (buffs and debuffs) to entities and a customizable HUD to track them. Open the HUD with L, the settings menu with Ctrl + L, and the debug effect picker with Shift + L.

HUD Customization

Bundled Effects

Used By

• Simple Alchemy
• CAN Consequences

Player Hotkeys

• L - toggle the HUD
• Ctrl + L - open HUD settings
• Shift + L - debug GUI: pick effect, target player, tier and duration (creative only)

Debug Command

/ef <effectName> <durationMinutes> <tier> <nickname>
# requires creative mode

For Modders

Apply an effect from code

// 1. Construct the effect
MiningSlowEffect ef = new MiningSlowEffect();

// 2. Set duration (also: SetExpiryInTicks, ...)
ef.SetExpiryInRealMinutes(3);

// 3. Optionally set tier
ef.Tier = 2;

// 4. Apply to an entity
effectshud.src.effectshud.ApplyEffectOnEntity(entity, ef);
// or use AddEffect on the EBEffectsAffected behavior directly

Query effects on an entity

entity.EntityHasEffect(effectId);                  // bool
entity.TryGetEntityEffect(effectId, out Effect e); // bool, returns instance

Register a custom effect

In StartServerSide:

RegisterEntityEffect("myEffectTypeId", typeof(MyEffectClass));

In StartClientSide:

// (typeId, isPositive, drawInHUD)
RegisterClientEffectData("myEffectTypeId", true, true);   // positive, rendered in HUD with tier overlay
RegisterClientEffectData("myEffectTypeId", true, false);  // positive, not drawn (logic-only)

Config

TICK_EVERY_SECONDS — tick length in real seconds (currently fixed at 1; reserved for future use). All HUD‑related options are live‑edited via the in‑game settings menu (Ctrl + L) and persist across sessions.

Requirements

• VSImGui (required dependency)

Credits

• Icons from game-icons.net
• Inspired by and uses parts of goxmeor's BuffStuff