About Text Placeholder API
From ModrinthPlaceholder and Text manipulation library for your Minecraft mods.
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
Highlights
From source dataGame versions
Supports 52 Minecraft versions, the newest being 26.3.
Loaders
Runs on Fabric and Quilt.
Footprint
Rated a light load on a server.
Text Placeholder API on Nxeon
From our catalogue- One-click install
- Supported on Nxeon Minecraft servers. We download it from Modrinth, place it, and restart the server.
- Server side
- Optional on the server
- Server type needed
- Fabric, Quilt
- Server load
- light
- Smallest plan we suggest
- Minecraft — 1.5 GB (2 GB RAM). This follows our own load rating above, not a benchmark.
- Latest build
- 3.2.0+26.3, released 2026-09-09
Game versions by loader
| Loader | Game versions | Newest |
|---|---|---|
| Fabric | 26.1 to 26w14a (9 versions) | 26w14a |
From 5 recorded builds of Text Placeholder API.
Recent builds
| Build | Released | Game versions | Loaders |
|---|---|---|---|
| 3.2.0+26.3 | 2026-09-09 | 26.3 to 26.3-pre-3 (2 versions) | Fabric |
| 3.1.0-beta.1+26.2 | 2026-05-27 | 26.2 to 26.2-pre-1 (2 versions) | Fabric |
| 3.1.0-beta.1+26.2 | 2026-05-27 | 26.2-pre-1 | Fabric |
| 3.0.0+26.1 | 2026-04-11 | 26.1 to 26.1.2 (3 versions) | Fabric |
| 3.0.0-beta.2+26.1 | 2026-03-18 | 26.1 to 26w14a (5 versions) | Fabric |
Run Text Placeholder API on a Minecraft server
Pick a server or deploy a new one above; it is installed in one click.
What kind of mod it is
From the catalogLibraries & compatibility
Foundations and fixes other mods build on. Usually installed because something else needs it.
Works on a server
From source side supportModrinth lists server-side support for Text Placeholder API as optional: it can run on a server, but isn’t required there.
Compatibility
- Game
- Minecraft
- Loaders
- FabricQuilt
- Runs on
- Serveroptional on the server
- Game versions
- 26.3 and 51 earlier
Verified at the source
- ✓ModrinthOfficial listing, checked 2026-10-08Open ↗
- ✓AuthorPatbox, as published on Modrinth
- ✓LicenseLGPL-3.0-onlyFree











