Trinkets Updated

A data-driven accessory mod for Minecraft for Fabric and NeoForge modloaders, based on Trinkets by Emi

About

Trinkets adds a slot group and slot system to Minecraft. Slot groups are collections of slots for a certain body part or more vague area. By default, there are 6 slot groups (head, chest, legs, feet, offhand, hand) that can have slots added to them, but more groups can be added if desired. Trinkets' UI is intuitive to use, accessible, and attempts to do away with clutter. Its system means that you'll never have a slot that's not used for anything, as mods request the slots they want.

Features

Model Attachment API

Flexible and designed with compatibility in mind API allowing you to easily render custom trinkets as attached to any body part of any entity based on vanilla model system. This includes compatibility with mods and resource packs such as Entity Model Features and Fresh Animations.

Fully optional Cosmetic Slot support and trinket equipment hiding

Trinkets Updated adds optional support for cosmetic slots and trinket hiding directly into the mod. While by default these features are disabled (as they could feel unfair in multiplayer setting), players in singleplayer, server owners on servers and modpacks makers for all can easily enable it by changing the config file, allowing them to set the desired experience just as they want to.

Configurable styling

While by default Trinkets Updated should look exactly like good old original Trinkets, it exposed multiple styling options, from changing how the slots are positioned, whatever they are hidden or show extra indicators such as slot being compatible with currently held item or show that slot contains more other slots within. Additionally, you can toggle both slot and item tooltips, which can help you to keep the style you wanted. S

Data Driven at it's core

Custom trinkets can be defined with json files via tags or custom components on the items. Additionally, you can easily define the rendering of such trinkets purely with a resource pack. Slots and slot groups are also data driven, making it easy to create and modify them, from their size to mobs which support them. Mods need to declare to use slots before they are accessible to the player, preventing creation of unused ones. You can get some example official datapacks on Modrinth!

Vanilla component and feature support

Trinkets implement a basic support for vanilla features such as glider component, which allows you to enable items using them to be easily turned into a trinket with a simple data pack and a resource pack. Additionally, things such as enchantments should also work fully correctly, giving you bit of that needed flexibility.

Multiplatform without extra dependencies needed

Only dependency needed by Trinkets Updated is local mod loader apis (Fabric API on Fabric, nothing extra on NeoForge). This allows to keep the library slim, easy to port and have minimal effects on other unrelated areas. Trinkets API's themselves were also made to be used in the same way on both Fabric and NeoForge, eliminating requirement of handling integration code separately on both platforms.

Download

You can get this mod from Modrinth, CurseForge or GitHub Releases

Developers

To add Trinkets to your project you need to add these repos to your repositories in your build.gradle

repositories {
	maven {
		name = "Nucleoid"
		url = 'https://maven.nucleoid.xyz/releases'
	}
}

And then to add Trinkets you add it as a dependency in your build.gradle

dependencies {
	implementation "eu.pb4:trinkets:${trinkets_version}"
}

Trinkets works as a universal jar, which means the same jar file can be used for Fabric, NeoForge and common. For optional / conditional compatibility, you can check for trinkets_updated mod id on both platform.

For versions, see https://maven.nucleoid.xyz/#/releases/eu/pb4/trinkets

For basic tutorials and comprehensive documentation, visit this repository's wiki! You can also see the test mod here: https://github.com/Patbox/trinkets/tree/main/src/testmod