Infused gemstones and crafted jewellery for TF-Minecraft.
GemInfusion gives gemstones rolled bonuses and turns them into a resource for equipment customisation and goldsmithing. Players infuse gems at a station, discover their rarity and strength, then use them in compatible sockets or as the centrepiece of crafted jewellery.
- Gem infusion — process batches of gemstones using an infusion token, with station feedback as the infusion runs.
- Rarity and stat rolls — gems range from common to legendary and provide bonuses such as health, armour, damage, or damage reduction according to their type.
- Character influence — Intelligence affects an infused gem's rolled stat, while Dexterity separately influences the bonus carried into jewellery.
- Socketed equipment — connects gems with MMOItems sockets and preserves rarity information through socketing and removal.
- Goldsmithing projects — craft rings, necklaces, medals, and other pieces from metal materials and an infused gem at a smithing station. Each finished piece records the metal materials actually used, so recycling can return those rather than the listed recipe. Projects set to
gem: 0, such as the Golden Key, need only gold and give the item without a stat or quality. - Craftsmanship matters — recipe accuracy, tool work, project tier, and finishing quality shape how much of the gem's bonus reaches the finished piece.
The same gemstone links discovery and craft: its infusion determines the starting bonus, and the goldsmith's work shapes the jewellery made from it. Legendary infusions can also be announced to other players.
Technical documentation is maintained in TF-Minecraft/Docs.
With Java 21 and the pinned plugin dependencies installed, run mvn clean verify.
Tests use JUnit, Mockito, and MockBukkit; JaCoCo reports are written to
target/site/jacoco/index.html and uploaded by CI. Tests run locally without a live
Minecraft server. Verification requires 100% line, branch, and instruction
coverage of production code, with no coverage exclusions.
Copyright (c) 2026 TF-Minecraft contributors.
TF-Minecraft-authored material in this repository is licensed under the Artistic License 2.0. Third-party dependencies and bundled material retain their own licenses.