HyWeaponVariants

On-hit effects

• On-hit effects (Stun, Burn, Poison, Freeze, Bleed, Thorns, Life Steal) now apply when your weapon hits and the chance roll succeeds. Effects are visible on the target (icons/duration).
• New effects: Bleed (BleedChance variant) and Life Steal (Life Steal variant) can proc on hit when configured.
• Thorns: Thorns variant can apply a Thorns effect; optionally applies to you (the attacker) as a buff instead of the target.
• Effect duration: Default durations per effect are configurable. The Effect Duration variant increases how long your applied debuffs last (Stun, Burn, Poison, Freeze, Thorns, Bleed). A global rule lets any weapon with Effect Duration scale all debuff durations.

Tooltips

• "On hit" line appears right after the variant rating and shows your actual proc chances (e.g. "On hit: 12% Freeze, 15% Poison"). Chance stats like "+17% Freeze Chance" are no longer shown separately to avoid clutter.
• You can turn off the on-hit tooltip line in config (dynamicTooltipsShowOnHitEffects).

Salvager / Processing Bench

• Variant weapons (e.g. Silversteel with variants) can be placed in the Salvager. Item IDs are normalized while the Salvager is open so the recipe accepts them. Variant data is restored if you take the item back.

Romnas Quality Crafting (optional)

• Optional compatibility with Romnas Quality Crafting: when both mods are installed, HyWeaponVariants treats quality item IDs (e.g. Weapon_Sword__RARE) as their base item for variants and the Salvager. You can use variant weapons that also have RQC quality tiers without ID conflicts; the Salvager and variant cache use the base ID. Compat is on by default and can be turned off in config (romnasQualityCraftingCompat). No extra dependency—if RQC is not installed, nothing changes.

Frost Sword & non-player damage

• When damage is applied by something other than your character (e.g. a DoT, deployable, or ability), the mod can still apply on-hit effects using the last player who hit that target (e.g. your Frost Sword freeze can still apply). This can be disabled in config (useLastAttackerFallback).

Cooldown & balance

• Per-effect cooldown: You can set a cooldown (in seconds) so the same effect won’t re-apply to the same target too often (onHitEffectCooldownSeconds). Set to 0 to keep the old behavior (no cooldown).

Config & control

• Config reload: Use /hwv reload (or your configured command) to reload the config from disk. On reload, the mod checks that every on-hit effect ID in config exists and logs a warning if one is missing.
• Performance mode: In config, set performanceMode: true to increase poller intervals, disable last-attacker fallback, and hide the on-hit line in tooltips. Useful for lower-end servers or clients.
• Poller options: You can run the main poller only when a player has a container open (pollerOnlyWhenContainerOpen) and set the Salvager poller interval (salvagerPollerIntervalMs) separately.

Performance & optimization

• Effect lookup cache: Resolving effect assets (Stun, Burn, etc.) is cached so combat doesn’t pay the cost every hit.
• Tooltip cache: Parsed tooltip data is cached so hovering over the same or similar items is cheaper.
• Early exit for non-variant weapons: If the held item has no variant, the mod skips all damage/effect logic for that hit.
• Container scans: You can cap how many slots are scanned per container (containerScanMaxItemsPerRun) and skip deep scans on containers that had no weapons last time (containerSkipScanWhenNoWeaponsCached), which helps with very large inventories.
• Last-attacker and cooldown maps are pruned when they get large so they don’t grow without bound over long sessions.

Summary for players

• Your variant weapons can Stun, Burn, Poison, Freeze, Bleed, and more on hit, with chances shown clearly in the tooltip.
• Thorns can buff you when you hit; Effect Duration makes your debuffs last longer.
• Salvager works with variant weapons; Frost Sword-style effects can still apply when damage comes from DoTs or other sources.
• Romnas Quality Crafting is supported optionally: quality items (e.g. Rare/Epic) are resolved to their base ID for variants and Salvager when both mods are installed.
• You can tune cooldowns, performance mode, and poller behavior in the config, and reload config without restarting.