God's Cowboy Hat

Three cowboy hats — Black, White and Red. Put one on and, like a flashlight, you keep firing a beam of light at the enemy in front of you, each hat bringing its own signature effect and enchantments.

The hats work on any living entity that wears one — players, Touhou Little Maid maids, and mobs from other mods alike.

Download

Pick the jar that matches your game — install only one:

No dependencies required. With Curios installed the hats can also be worn in the head curio slot (optional — everything works fine without it).

The three hats

All three are crafted from leather + a matching dye + nether stars:

L L L
L D N
N N N

L = Leather ×4, D = the matching dye, N = Nether Star ×4.

The full cycle

        ┌──────────────────────────────────────────────────┐
        │                                                  │
        ▼                                                  │
  1. A valid target comes within 16 blocks                  │
        │                                                  │
        ▼                                                  │
  2. CHARGE  (Black 22s / White 18.2s / Red 29.4s)          │
     - the hat's BGM starts playing                        │
     - you gain Resistance II for the whole charge         │
     - everything except you within 5 blocks is slowed:    │
       mobs get Slowness V + overall damping,               │
       projectiles lose gravity and crawl along             │
        │                                                  │
        ▼                                                  │
  3. CHARGE ENDS                                            │
     - the slow field is removed instantly                  │
     - you gain Speed II (until the cycle ends)             │
        │                                                  │
        ▼                                                  │
  4. BEAM  (Black 8s / White 6.45s / Red 7.6s)               │
     - locks onto the nearest enemy, re-locks if a closer one appears
     - each beam tracks one enemy; every tick it deals damage
       and applies Slowness 255 (they cannot move)          │
     - Red: Strength I while firing                         │
        │                                                  │
        ▼                                                  │
  5. Enemies still nearby?  ── yes ──> back to 2 (music restarts)
                             └─ no ──> idle (music stops)

Beam damage

Every tick (20 times a second) each lit enemy takes:

fixed damage : the hat's damagePerTick (default 10)   -> a normal hurt()
% damage     : 5% of the target's CURRENT health      -> setHealth, ignores all damage reduction

The total is then multiplied by a power multiplier from the wearer's status effects (Strength +35% per level, Weakness −20% per level), so Strength and Weakness apply to the beam.

• The damage type is the mod's own hatmod:flash, credited to the wearer (kills count for them). It is in the bypasses_invulnerability tag, so i-frames and damage caps cannot stop it.
• The 5% is a forced percentage hit; below 5% of max health the percentage part stops and the fixed damage finishes the target off so it dies normally (loot, death message, kill credit).

Exclusive enchantments

Each hat has 3 exclusive enchantments (max level III) on top of all vanilla helmet enchantments (Protection, Blast Protection, Projectile Protection, Fire Protection, Respiration, Aqua Affinity, Thorns, Unbreaking, Mending, Curse of Binding, Curse of Vanishing …).

A few details

• Foresight (Black) uses the same "freeze in place" as the charging field; level III lasts the whole cycle.
• Radiance (White) → Divine Veil is plain vanilla Invisibility — the model vanishes exactly as vanilla does, armour and held items stay visible, and the status bar shows only the Divine Veil entry. On top of that it periodically shakes off mobs that had already locked onto you, Wardens included. The radius is the time-dilation field (5 blocks base, widened by Slow Field); duration 6/8/10 s.
• Dominion (Red) works on Wardens too.
• Beam (Red) fires +1 beam per level (up to 2/3/4). With enough enemies each beam takes a different one; with too few, the spare beams stack on the nearest enemy with diminishing returns (4 beams on one target ≈ 1.62×, not 4×).
• Lifesteal (Red) → Green Hearts are the mod's own shield pool (not a recoloured vanilla Absorption). They outrank golden hearts: incoming damage drains green hearts first, then golden hearts and health. They last forever but decay faster the more you have (1 s per heart at the base). The green heart bar is drawn by the client, so vanilla golden hearts are untouched.

The three hats are meant to feel different: Black = survival / dodging, White = speed / support, Red = berserker damage.

Other mechanics

• Durability: base 300; at most 1 point of wear per 3 seconds; 1 Leather repairs 20.
• Enchant armour bonus: every enchantment on the hat grants the wearer +2 armour.
• Music: each hat plays its own BGM when the cycle starts, bound to the wearer with distance falloff.
• Pacifism: while wearing a hat you cannot attack passive mobs or unprovoked neutral mobs.
• Valid targets: hostile mobs / provoked neutral mobs / anything currently targeting you / anything that recently dealt you more than 0 damage (a 10-second memory — this catches modded mobs that look passive but actually fight back). Your own allies, pets and teammates are never targeted.

Compatibility

• Curios — optional. With it installed, hats can go in the head curio slot and behave exactly as when worn on the head, including the rendered model. Without Curios the mod runs normally.
• No dependencies required.
• Designed for Forge 1.20.1 and NeoForge 1.21.1 (two separate jars).

Credits

Made by fadersketch. Licensed under MIT.