Ametrin API (1.21.7, 1.20.1) – Library for Ametrin Studios Mods

Q: Which mod loaders are supported?

The Ametrin API supports both Forge and NeoForge. Be sure to download the version that matches your loader.

The Ametrin API (1.21.7, 1.20.1) is a powerful and modular core library designed to support the suite of Minecraft mods developed by Ametrin Studios. Available for both Forge and NeoForge, this API provides streamlined helper classes, data generators, and block/recipe/loot registries that simplify the creation and maintenance of high-quality Minecraft mods.

Rather than functioning as a standalone gameplay mod, Ametrin API acts as a backend dependency for other mods. It ensures consistency, reduces redundant code, and accelerates the development process of new features and mod mechanics. If you’re using any Ametrin Studios mod, this API is a required component.

Features:

Extended Data Providers:
- ExtendedBlockStateProvider:
  Automatically generates BlockStates for blocks like lanterns, wall torches, and campfires based on predefined rules.
- ExtendedBlockTagsProvider:
  Auto-tags blocks according to defined logic to reduce manual JSON work.
- ExtendedRecipeProvider:
  Includes helper methods for common recipes and handles duplicate recipe IDs cleanly.
- ExtendedLootTableProvider:
  Streamlines loot table generation with utility functions.
Base Block Classes:
- Easily extendable classes for custom block behaviors like:
  - DoublePlant, AgeableBush, AgeableDoublePlant
  - Head, Torch, and more.
Block and Object Registries:
- BlockRegistry:
  Simplify the creation of:
  - Custom portals (e.g., Nether-style)
  - Trees and saplings
  - Fluids and fluid behaviors
- StructurePieces:
  Useful for procedural generation of complex structures.
- TerrainAnalyzer:
  Internal utility for terrain-based conditions or generation logic.
Other Utility Classes:
- ExternalEffect:
  Add custom status effects whose logic is processed outside the default effect class.
- Time and color conversion helpers
- Potion mix support
- Compostable item registration
- Flower pot and strippable log registration

Why use Ametrin API?

For modders working with or building upon Ametrin Studios’ ecosystem, this API is an essential development foundation. It’s designed to remove boilerplate code and offer smart, scalable tools that streamline everything from block registration to structure generation.

If you’re a server owner or player, you likely won’t interact with this mod directly but many content mods depend on it to function properly. Without the API, those mods won’t load or could encounter critical errors.

Whether you’re coding your own mods, contributing to an Ametrin-based pack, or just trying to run one of their gameplay mods, Ametrin API is a required dependency that ensures everything runs smoothly under the hood.

FAQs

Is Ametrin API required to play mods from Ametrin Studios?

Yes. All mods developed by Ametrin Studios require Ametrin API to function properly. It must be installed for those mods to load.

Does this mod add any content to the game?

No. Ametrin API is a backend utility mod. It does not add blocks, items, or gameplay features on its own.

Which mod loaders are supported?

The Ametrin API supports both Forge and NeoForge. Be sure to download the version that matches your loader.

What kind of tools does it provide for mod developers?

It offers extended block state, tag, recipe, and loot providers, helper classes for block and fluid registration, and various utility tools for development efficiency.

Is Ametrin API compatible with Minecraft 1.21.7?

Yes. The latest version of Ametrin API supports Minecraft 1.21.7 and 1.20.1, and also supports older versions depending on mod compatibility.