FireFly's Simple Tweaks

FireFly's Simple Tweaks

Simple to install, deep to master.

FireFly's Simple Tweaks is a Fabric mod for Minecraft 1.21.1 that expands combat, enchanting and mob progression without replacing the vanilla feel. It adds a large custom enchantment system built around elemental interactions, a rarity ladder from common to mythic, scalable mob enhancement, and several client-side quality-of-life features.

Features

100+ Custom Enchantments

100+ enchantments across seven rarities — COMMON → UNCOMMON → RARE → EPIC → LEGENDARY → MYTHIC → MYSTERY, plus a small UNIQUE tier of one-shot meta operations (strip an enchantment, reroll the mod's enchantments on an item, cross-swap elemental conversions, or spend levels to raise the highest enchantment). Every entry is generated from a single source of truth, so names, rarity, level caps and item restrictions are always consistent.

Highlights include the whole weapon class coverage vanilla skips: a mace family (slam shockwaves, shields that cannot block it, hits that interrupt item use), an elytra line (faster gliding plus a mid-air dash), and a trident enchantment that keeps striking along the throw.

Elemental System and Reactions

The mod adds 8 elements — physical, fire, frost, lightning, water, nature, dark and light — with an aura/attachment model: each applied element carries units that decay linearly over time (weak 1.0 / strong 2.0 / ultra 4.0), repeated applications accumulate, and combining elements produces 19 reactions (amplifying ones like melt/vaporize scale the triggering hit; transformative ones like overload/shatter deal independent damage). Attachments are throttled per attacker/target, so reactions reward sequencing rather than spamming.

Enchantments hook into the same engine instead of each rolling their own maths: eight conversions, eight affinities, ward/resonance/penetration, mastery, and reaction-enabling mythic effects.

Combat Tweaks

Damage numbers report the health that was actually removed, can split into one number per element, and react to elemental reactions. A redone armour curve keeps early armour useful and gives late armour diminishing returns (80 % of vanilla protection up to 20 points, then a slower tail, capped at 75 %). Attack reach, knockback, i-frame windows and several more mechanics have targeted tweaks that stay readable in PvP.

Scalable Mob Enhancement

Every mob — not only armed ones — gets a level, shown in its name tag. Levels scale health, damage and armour along a curve, and higher-level mobs can spawn with budgeted enchantments and elemental affinities. Mob levels track the player's whole loadout, so progression keeps a challenge without a fixed wall.

A persistent /fst difficulty offset lets you tune the whole curve up or down, including mid-session.

Client-Side Quality of Life

• Damage indicator — floating numbers, per-element colours, optional physical/elemental split, reaction labels, percentage mode, fully configurable scale/duration/distance.
• Enchantment codex — browse all 113 enchantments by rarity or by applicable item.
• Configuration GUI — a rebuilt screen with editable value fields, wider ranges, page tabs and per-option range tooltips.
• Rarity-coloured enchantment names, optional hurt-cam toggle, particle suppression, auto-sprint and more.

Requirements

• Minecraft Java Edition 1.21.1
• Fabric Loader 0.16.14 or newer
• Fabric API 0.116.17+1.21.1 or newer for 1.21.1
• Fabric Language Kotlin 1.12.3+kotlin.2.0.21 (or newer for Kotlin 2.0.21)
• Java 21

Installation

1. Install Fabric Loader for Minecraft 1.21.1.
2. Place Fabric API and Fabric Language Kotlin in your mods folder.
3. Place the FireFly's Simple Tweaks .jar in your mods folder.
4. Launch the game with the Fabric profile.

For multiplayer, install the mod on both the server and the client: gameplay systems (enchantments, elements, mob levels, difficulty) are server-authoritative, while the damage indicator, codex and config GUI are client-side.

Commands

All commands live under /simple_tweaks (alias /fst):

• /fst stconfig — open the configuration screen
• /fst ei (enchantinfo) — open the enchantment codex
• /fst difficulty check / modify <±> — inspect or tune the mob difficulty curve
• /fst enchant ... — operator tooling for applying and inspecting enchantments

Configuration

Everything is adjustable in-game through /fst stconfig, and stored in config/simple_tweaks.json. Changes apply immediately; out-of-range values are clamped to the documented bounds.

Compatibility

This build is for Fabric on Minecraft 1.21.1. Other mod loaders and Minecraft versions are not supported by this build. The mod is designed to coexist with datapack-defined enchantments and reads the live registry, so externally added enchantments appear in the codex automatically.

Feedback and Issues

• Source code: https://github.com/FireFlyUnlegit/FireFly-Simple-Tweaks
• Report issues: https://github.com/FireFlyUnlegit/FireFly-Simple-Tweaks/issues

License

This project is licensed under the MIT License.