Text Placeholder API Mod (26.1-snapshot-7, 1.20.6) – Simplify Text

Text Placeholder API is a library mod that provides placeholder creation, parsing, and text manipulation tools for Minecraft mods running on Fabric and Quilt loaders. Developed by Patbox, it enables both mod developers and server administrators to use a unified placeholder system with the format %modid:type% across compatible mods.

Managing text output across multiple Minecraft mods has always been a headache. Every mod tends to handle text formatting, placeholders, and configuration strings differently — forcing server admins to learn a dozen different syntax systems just to customize chat messages, scoreboards, or tab lists. Text Placeholder API solves this by providing a single, shared library that any mod can hook into. With over 33 million downloads and active maintenance stretching from Minecraft 1.20.3 all the way to the latest 26.1 snapshots, it has become one of the most widely adopted utility libraries in the Fabric ecosystem. If you have ever installed a Fabric server mod and seen "Requires: Placeholder API" in the dependency list, this is the mod they are referring to.

Key Features of Text Placeholder API

• Universal Placeholder System — Text Placeholder API uses a clean %modid:type% format that works identically across every compatible mod. This means once you learn the syntax for one mod, you already know it for all of them. Server administrators no longer need to memorize different formatting rules for each plugin they install.
• Simplified Text Format — Instead of writing raw JSON text components by hand or relying on external generators, you can style text using a readable, human-friendly syntax directly in configs and chat. This dramatically reduces the time spent on customizing server messages, MOTDs, and tab list entries — especially for admins who are not comfortable editing JSON manually.
• Default Placeholder List — The mod ships with a built-in set of common placeholders covering player names, world info, server stats, and more. These are ready to use out of the box without any additional configuration, giving you immediate access to the most frequently needed data points in your text templates.
• Mod-Specific Placeholder Extensions — Beyond the defaults, any mod that integrates with the API can register its own placeholders. This creates a growing ecosystem where installing a new mod automatically expands the pool of available placeholders you can use in other compatible mods.
• Jar-in-Jar (JIJ) Support — Text Placeholder API is designed to be bundled directly inside other mods using the Jar-in-Jar system. Most mods that depend on it already include it, so in many cases you do not need to download it separately. However, you can always install an updated standalone version if a newer release is available.
• TextNode and NodeParser System — For developers, the API provides a robust node-based parsing architecture that handles both static and dynamic placeholder replacement within Minecraft Text Components. This goes beyond simple string replacement, preserving formatting, click events, and hover text throughout the parsing process.
• Cross-Mod Compatibility — By standardizing how placeholders work, the API eliminates conflicts between mods that manipulate text output. Two different mods can both read and write placeholders without stepping on each other, which is a common pain point in heavily modded server environments.

Screenshots

How to Install Text Placeholder API

1. Download and install Fabric Loader or Quilt Loader for your Minecraft version. Text Placeholder API supports versions from 1.20.3 through 26.1.
2. Download the correct version of Text Placeholder API for your Minecraft version from the download section below. Make sure the file version matches your game version.
3. Place the downloaded .jar file into your Minecraft mods folder. On most installations, this is located at .minecraft/mods/.
4. Launch Minecraft with your Fabric or Quilt profile. The API will load silently in the background — it is a library mod, so there is no in-game menu or visible interface.
5. Install any mods that depend on Text Placeholder API. They will automatically detect the library and begin using its placeholder system.

Requirements & Compatibility

What's New

• Updated to support Minecraft 26.1-snapshot-7, ensuring compatibility with the latest snapshot cycle.
• Continued beta development of the 3.0.0 release branch with incremental fixes between beta.1 and beta.2.
• Maintained backward compatibility across the full 1.20.3 to 26.1 version range.
• Ongoing refinements to the placeholder parsing engine based on community feedback and bug reports.

Pros and Cons

Alternatives to Text Placeholder API

• MiniPlaceholders — A lightweight placeholder library built on MiniMessage formatting, offering an alternative syntax style for Fabric and Paper server environments.
• Styled Chat — A server-side chat customization mod by the same developer (Patbox) that uses Text Placeholder API under the hood, ideal if your primary need is chat formatting.
• LuckPerms — While primarily a permissions mod, LuckPerms provides its own placeholder hooks for prefix, suffix, and group data that integrate with Text Placeholder API for comprehensive player info displays.

Download Text Placeholder API

Always download mods from official sources to stay safe.

Frequently Asked Questions

Is Text Placeholder API required for players on singleplayer?

No — most singleplayer users will never need to install this mod directly. Text Placeholder API is a library designed primarily for server-side mod compatibility. If a mod you want to use lists it as a dependency, it is likely already bundled inside that mod via the Jar-in-Jar system. You only need the standalone download if you want to run a newer version than what your mods include.

Does Text Placeholder API work with Forge or NeoForge?

No — Text Placeholder API is built exclusively for the Fabric and Quilt mod loaders. There is no Forge or NeoForge version available. If you are running a Forge-based server, you will need to look at alternative placeholder systems designed for that ecosystem.

Will Text Placeholder API slow down my server?

No, it appears to be lightweight and should not cause noticeable performance impact. The mod is a library that only activates when other mods call its API to parse placeholders. It does not run background processes or continuously scan for changes on its own, so idle resource usage is minimal.

Can I use Text Placeholder API placeholders in any mod's config?

Only in mods that explicitly support it. A mod must integrate with Text Placeholder API's parsing system to recognize and replace placeholder strings. Check the mod's documentation or description page to see if it lists Text Placeholder API as a supported dependency. Many popular Fabric server mods by Patbox and other developers already include full support.

Is the 3.0.0 beta safe to use on a production server?

It depends on your risk tolerance. The 3.0.0 beta branch targets Minecraft 26.1 snapshots, which are themselves unstable development builds. For production servers running stable releases like 1.21.x, use the corresponding stable version of Text Placeholder API instead. Reserve the beta for testing environments where you are already running snapshot versions of Minecraft.

You May Also Like

VTDownloader Mod (1.21.11, 1.20.1) – In-Game Resource Pack Downloads

1 week ago

Create Enchantment Industry (1.20.1, 1.19.2) – Automate Enchanting

1 day ago

Structure Overlapless Mod (1.21.11, 1.20.1) – Cleaner Worldgen

2 weeks ago

Leave My Bars Alone Mod (1.21.11, 1.20.1) – Keep Informational Bars

1 week ago

Camera Overhaul Mod (1.20.1) – Camera Improvements

4 weeks ago

Every Compat (Wood Good) Mod (1.21.1, 1.20.1) – The Missing Wood

23 hours ago