TFGF, short for TerraFirmaGreg Familiarity, makes a well-used GTCEu tool feel meaningfully different from a fresh one. Familiarity belongs to the individual tool, grows through appropriate work, survives repair, and unlocks practical benefits that come from knowing its balance and maintaining it well. In short, TFGF makes your tools truly yours and rewards sticking with one tool instead of making duplicates. It also looks to introduce further realism into tool usage rather than merely crafting. Making tools is expensive, let's make them worth it.

Why?

Vanilla enchantments often solve tool progression with unexplained magic. Well, it does fit in the design of Minecraft because there are other "supernatural" elements to the game. However, Terrafirmacraft and TerrafirmaGreg by extension are more grounded in reality. Therefore we throw enchantments out entirely, however, what about the mastery?

TFGF fits TerraFirmaGreg's grounded loop instead. There aren't any flaming blades, conjured drops, magnetic experience or supernatural reach. What TFGF provides is mastery.

Requirements

• Minecraft 1.20.1
• Forge 47.4.13 or newer compatible Forge 47 build
• TerraFirmaCraft 3.2.0+
• GTCEu Modern 1.0.0+

NOTE: TFGF is intended for TerraFirmaGreg-style packs and only recognizes supported GTCEu tool types.

Installation

1. Install the required mods and their dependencies, or alternatively, install TerraFirmaGreg-Modern.
2. Place the TFGF JAR in the instance or server mods directory.
3. Start the game once to generate config/tfgf-common.toml.

Familiarity progression and balance configuration is on the server side configuration file. Clients still need to have this mod installed for networked feedback and tooltips.

Commands

• /tfgf stats - inspect the held tool's history.
• /tfgf get - inspect familiarity and next-rank progress.
• /tfgf help - list administrative XP commands.

Administrative mutation commands require permission level 2.

Progression

• 11 ranks, from Novice to Ethereal, stored directly on each tool.
• XP from correct block breaking, direct melee attacks, and kills.
• Momentum and material memory reward steady, appropriate use.
• Per-tool statistics, evolving epithets, progress tooltips, and level-up toasts.
• Optional death loss, periodic decay, anti-cheese limits, and mastery decay protection for server owners.

Familiarity levels

Familiarity XP is stored on each individual tool and capped at the final rank.

Earning XP

Projectiles and indirect damage do not train the held weapon. XP is calculated before integer rounding, so a base value of 1 will usually remain 1 until enough multipliers accumulate.

Practice multipliers

• Mining momentum adds 4% per uninterrupted action, up to 10 stacks. It resets after 5 seconds.
• Combat combo adds 6% per recent kill, up to 5 stacks. It resets after 3 seconds.
• Correct-tool and known TFC rock/ore work can add 10% material affinity.
• Tool Memory unlocks at level 4 and grants 1 additional XP when the current material or entity type matches the tool's previous use.

Per-action caps default to 3 XP for breaking and 4 XP for attacking or killing. Repeated breaking at the same position is rate-limited, and its tracking state is pruned continuously.

Rewards

Shared: Careful Handling

Careful Handling unlocks at level 3. After vanilla or GTCEu applies wear for a qualifying mining action or direct melee hit, TFGF can refund one point of that wear. The chance scales with familiarity:

15% * (level / 10)

That is 4.5% at level 3 and 15% at level 10. It models fewer bad angles and less wasted force, filling Unbreaking's role without making the tool indestructible.

Mining tools

Familiar Handling affects only blocks for which the held tool is correct:

mining speed = original speed * (1 + 2.5% * level * miningSpeedMultiplier)

The default maximum is +25% at level 10.

Work Rhythm unlocks at level 3. Consecutive work on the same block material adds linearly up to +10% mining speed at a 16-block streak. Switching materials resets the streak. It rewards a steady workflow without breaking adjacent blocks, creating resources, moving drops, extending reach, or removing environmental penalties.

Weapon tools

• Balanced Strikes: +0.15 attack damage * level, up to +1.5.
• Practiced Cadence: +0.01 attack speed * level, up to +0.10.
• Deliberate Timing (level 4): attacks at 90% or greater cooldown gain up to 12% damage at level 10.
• Guard Break (level 5): attacks against a blocking player have up to an 8% chance at level 10 to disable the shield.

These mechanics intentionally avoid fire, potion effects, lifesteal, conjured loot, magical armor bypass, and random critical-hit bursts.

Dual-purpose tools

Dual-purpose tools participate in mining and weapon progression. Weapon attribute bonuses use dualBuffEfficiency, which defaults to 50%; mining speed, Tool Memory, and Careful Handling use their normal rules.

Long-term rules

• Death loss defaults to 10% and is applied once to each inventory and offhand tool.
• Periodic decay defaults to 5% every 60 minutes while the owner is online.
• Tools at the mastery threshold (level 9 by default) can be exempt from decay.
• Familiarity XP, usage statistics, and the epithet are preserved in tool NBT and carried through supported repairs.

License and artwork

The source is All Rights Reserved.

The TFGF logo was created by the awesome @Starplanet and is used with express permission. The logo may not be reused without EXPLICIT permission from the author.