
Text Placeholder API
Placeholder and Text manipulation library for your Minecraft mods.
About this Mod
About Placeholder API
It's a small, JIJ-able API that allows creation and parsing placeholders within strings and Minecraft Text Components.
Placeholder API uses a simple format of %modid:type% or %modid:type data% (%modid:type/data% prior to 1.19).
It also includes simple, general usage text format indented for simplifying user input in configs/chats/etc.
For users
It allows users to configure multiple mods in similar way without losing compatibility between mods.
Placeholders allow changing what and where any information is present within compatible mods.
Additionally, Simplified Text Format allows to style them in readable way without the requirement of writing JSON manually or using
generators.
Mods generally using this api should just include it directly, but you can downloaded updated version from here if needed!
For developers
Usage of Placeholder API is a simple way to achieve good mod compatibility without having to implement
multiple mod specific apis. Additionally, the placeholder parsing system can be used for replacing
own static (or dynamic placeholders) in Text created by player or read from config. This with combination
of Simplified Text Format allows creating great user/admin experience.
- Getting Started
- Adding placeholders
- Parsing placeholders
- TextNodes and NodeParsers
- Using Simplified Text Format (TextParserV1)
*[JIJ]: Jar-in-Jar
Available Versions
How to Install Text Placeholder API on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set fabric Loader
In the panel under "Egg", select the fabric loader and matching Minecraft version (26.2).
Install Mod
Open the mod browser in the dashboard and search for "Text Placeholder API". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
26.2, 26.2-pre-1, 26.1.2 (+47 more)
Server-side
~ OptionalRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Text Placeholder API server crashes on startup – what to do?
Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (26.2). You can switch loaders with one click in the panel.
Is Text Placeholder API compatible with fabric and quilt?
Text Placeholder API officially supports fabric, quilt for Minecraft 26.2, 26.2-pre-1, 26.1.2. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with Text Placeholder API – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Text Placeholder API consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install Text Placeholder API with just one click on your server.