Wiki 9Minecraft Mantle Mod Wiki
Mantle Mod Wiki › Guide

Mantle Mod — Guide

Gameplay Mechanics

Mantle adds several subtle but impactful mechanics to the game that are often utilized by its dependent mods.

Health Overlay

One of Mantle's most recognizable features is the Colored Heart Overlay. In vanilla Minecraft, gaining extra health (via potions or equipment) results in multiple rows of hearts stacking vertically, which can obscure the screen. Mantle replaces this with a color-coded system where hearts change color to represent additional health layers: * Red Hearts: Standard 10 hearts (20 HP). * Orange/Yellow/Green/Blue Hearts: Represent subsequent layers of health. Each color indicates a full extra bar of health has been added.

Soulbound Items

Mantle introduces the mantle:soulbound item tag. Any item added to this tag via a data pack will be automatically kept in the player's inventory upon death, rather than dropping on the ground. This logic is natively supported by Tinkers' Construct and can be utilized by other mods using Mantle's event bus.

In-World Fluid Gauges

In version 1.20.1, Mantle adds a dynamic tooltip system for fluids. By adding blocks to specific tags, players can see fluid contents just by looking at them: * mantle:gauges/attached: Blocks in this tag show a tooltip of the fluid contents in the tank directly behind them. * mantle:gauges/tank: Blocks in this tag show their own internal fluid contents as a tooltip. * mantle:hides_gauge_amount: Blocks with this tag will only show the fluid name, hiding the specific millibucket (mB) amount.

Data Pack and Resource Pack Integration

Mantle significantly expands the capabilities of standard Minecraft data packs and resource packs.

Loot Injectors

Mantle's Loot Injector system allows modders to add items to existing loot tables (like dungeon chests or mob drops) without overwriting the entire table. This prevents conflicts between multiple mods trying to modify the same loot source.

Fluid Transfer System

Mantle provides a JSON-based system to define how items interact with fluids. This allows modpack makers to make any item (like a custom bottle or bucket) hold fluids without writing Java code. It supports: * Fluid Overrides: Forcing an item to behave as a fluid container. * Fluid Tooltips: Customizing how fluid amounts (mB vs. Buckets) appear in item descriptions.

JSON Things (1.18+)

Mantle supports "Thing Packs," which allow for the creation of entirely new blocks and items using only JSON files. This is highly utilized in "Low Code" modding environments to add decorative blocks or simple tools without a full development workspace.

Resource Colors

Mantle includes a resource color system that allows data packs to define specific text colors for materials and items in tooltips, ensuring visual consistency across different mods' UIs.

Technical JSON Formats

For developers and advanced users, Mantle introduces several custom JSON types used in recipes and predicates:

  • Ingredients: Enhanced version of vanilla ingredients that can list multiple matching entries and NBT data.
  • Predicates: Logic gates for JSON (e.g., mantle:has_effect, mantle:sprinting, mantle:blocking) used to determine if a condition is met on an entity or block.
  • Fluid Textures: A standardized format for defining fluid still and flowing textures, including color tinting and luminosity.
  • Station Slot Layouts: JSON files that define the arrangement of slots in the Tinker Station or Anvil, used for in-game documentation.