Mace Effects

Mace Effects is a client-only Fabric mod that paints a customizable shockwave every time you swing a mace on 1.21.1. The mod drops a ring-based pulse around the player, an optional forward streak, and a boom sound for extra punch.

Key behavior

• Triggers on any mace swing (main hand by default; offhand optional) and runs purely client-side visuals.
• Default effect draws expanding rings, a forward sonic streak, and plays the warden sonic boom for feedback.
• Cooldown between swings is configurable so rapid clicks do not spam particles.

Config (generated at config/maceeffects.json)

• drawParticles, ringsEnabled, lineEnabled: toggle visuals; set drawParticles false for a sound-only shockwave.
• primaryParticle, lineParticle: particle IDs for the rings and forward streak (use simple particles like minecraft:cloud, minecraft:sonic_boom).
• mode: HORIZONTAL, UPWARD, or CROWN to shape the wave (flat, climbing arc, or crown-like lift).
• Shape tuning: rings, startRadius, radiusStep, particlesPerRing, verticalLiftPerRing, upwardCurveHeight, ringHeightOffset, wobbleStrength, particleSpeed.
• Line tuning: lineLength, lineStep, lineLift.
• Triggers: maceOnly, allowOffhand, onlyFirstPerson, swingCooldownTicks.
• Audio: playSound, soundId, soundVolume, soundPitch.

Notes and limitations

• Visual-only: does not change damage or knockback; effects are local to the client.
• Particle resolver expects simple particle types; complex parameterized particles fall back to the default cloud/sonic boom.
• Config reload requires a restart or resource reload to take effect.