Nuggets API

A lightweight Fabric library for standardized nuggets and material fragments.

The goal of Nuggets API is simple: stop every mod from reinventing the same tiny materials in slightly different ways. This project provides a clean and lightweight foundation that other mods can build on, ensuring a unified experience for players and developers alike.

---

✨Features:

Built from the ground up to be lightweight and lag-free and uses common c: tags as well as our own nuggets-api: tags for seamless integration with your mods, this API library adds various nuggets items and material fragments to the game. It is also translated into various well used languages like French, German, Chinese and Spanish!

Items

• Nugget Template -> a template required to craft all of the new nuggets! Crafted using 4 sticks in a circle pattern

  

• Small Smithing Template -> a netherite upgrade smithing template but smaller, used when upgrading a diamond nugget to netherite. Can be found in bastion remnants or crafted with 1 regular smithing template

  

  You can also craft back a regular smithing template by using 9 small smithing templates!

Nuggets

• Wood Splinter -> a wood nugget. Can be crafted using 1 nugget template and 1 stick

  

• Stone Pebble -> a stone nugget. Can be crafted using 1 nugget template and 1 stone

  

• Coal Lump -> a coal nugget. Can be crafted using 1 nugget template and 1 coal or 1 charcoal

  

• Redstone Nugget -> a redstone nugget. Can be crafted using 1 nugget template and 1 redstone

  

• Quartz Shard -> a quartz nugget. Can be crafted using 1 nugget template and 1 quartz

  

• Amethyst Crystal -> an amethyst nugget. Can be crafted using 1 nugget template and 1 amethyst shard

  

• Lapis Lazuli Chunk -> a lapis lazuli nugget. Can be crafted using 1 nugget template and 1 lapis lazuli

  

• Emerald Chunk -> an emerald nugget. Can be crafted using 1 nugget template and 1 emerald

  

• Diamond Shard -> a diamond nugget. Can be crafted using 1 nugget template and 1 precious diamond

  

• Netherite Nugget -> a netherite nugget. Obtained by smithing a diamond nugget with the small smithing template and a netherite ingot or by crafting using 1 nugget template and 1 valuable netherite ingot

  

---

🛠 For Developers

Nuggets API is built with integration in mind. All materials are exposed through tags, making cross-compatibility straightforward. You are encouraged to use tags in your recipes rather than hard-coding item dependencies!

Common Tag Reference

Material	Item ID	Common Tag (c:)
Diamond	nuggets-api:diamond_nugget	#c:nuggets/diamond
Netherite	nuggets-api:netherite_nugget	#c:nuggets/netherite
Emerald	nuggets-api:emerald_nugget	#c:nuggets/emerald
Nugget Template	nuggets-api:nugget_template	#c:nuggets/template
Small Smithing Template	nuggets-api:small_netherite_upgrade_smithing_template	#c:smithing_templates/small_netherite_upgrade

📦 Installation

To use Nuggets API in your development environment, add the following to your build.gradle:

repositories {
    maven { url = "https://jitpack.io" } // Optional but required if you wish to bundle the API into your mod by using the include dependency below
}

dependencies { // You can change the API version after nuggets-api: to the one you want to use
    modImplementation "com.titan1um:nuggets-api:a1.0.0+1.20.1" // Required
    include "com.github.T1taniumF0rge-Industries-Inc:nuggets-api:a1.0.0+1.20.1" // Optional unless you want to bundle the API into your mod (Jar-in-Jar)
}