
Modrinth · Minecraft mod
Text Placeholder API
Placeholder and Text manipulation library for your Minecraft mods.
Quick answer
Which Text Placeholder API release should I use?
Text Placeholder API 3.1.0-beta.1+26.2 targets 26.2-pre-1, 26.2 with Fabric. Installation on the client is optional. Installation on the dedicated server is optional. No extra mods listed for this file.
Where it goes
Is Text Placeholder API required on the client, server, or both?
Installation on the client is optional. Installation on the dedicated server is optional.
The source marks this as usable on both the client and server.
What else does Text Placeholder API 3.1.0-beta.1+26.2 need?
3.1.0-beta.1+26.2. Change the file and its required mods may change too.
This file does not list any required mods. Do not add a library just because a different file uses it.
This file does not list any required or optional mods.
Before you install it
Add Text Placeholder API without breaking your instance.
Built for Text Placeholder API 3.1.0-beta.1+26.2. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use 3.1.0-beta.1+26.2. It targets 26.2-pre-1, 26.2 with Fabric; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
This file does not list any required mods. Do not add a library just because a different file uses it.
- 03
Put it on the correct side
Installation on the client is optional. Installation on the dedicated server is optional.
- 04
Pick the file you checked
Use the “Get this file” button beside 3.1.0-beta.1+26.2. It opens that exact file at the source.
About this project
What does Text Placeholder API add?
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
Project description from Modrinth.
Pick your setup
Text Placeholder API by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
26.2-pre-1
1 loader build26.2
1 loader build26.1.2
1 loader build26.1.1
1 loader build26.1-snapshot-7
2 loader builds26.1-pre-3
1 loader build26.1
1 loader build25w14craftmine
2 loader builds1.21.11-pre1
2 loader builds1.21.11
2 loader builds1.21.10
2 loader buildsShowing the newest 12 of 50 game versions. Older files are in the list below.
Check the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
Text Placeholder API versions and loaders
3.1.0-beta.1+26.2
placeholder-api-3.1.0-beta.1+26.2.jar
27 May 2026
3.1.0-beta.1+26.2
placeholder-api-3.1.0-beta.1+26.2.jar
27 May 2026
3.0.0+26.1
placeholder-api-3.0.0+26.1.jar
11 Apr 2026
3.0.0-beta.2+26.1
placeholder-api-3.0.0-beta.2+26.1.jar
18 Mar 2026
3.0.0-beta.1+26.1
placeholder-api-3.0.0-beta.1+26.1.jar
14 Feb 2026
2.8.2+1.21.10
placeholder-api-2.8.2+1.21.10.jar
1 Feb 2026
2.8.1+1.21.10
placeholder-api-2.8.1+1.21.10.jar
25 Oct 2025
2.8.0+1.21.9
placeholder-api-2.8.0+1.21.9.jar
28 Sept 2025
2.8.0-rc.1+1.21.9
placeholder-api-2.8.0-rc.1+1.21.9.jar
17 Sept 2025
2.7.2+1.21.8
placeholder-api-2.7.2+1.21.8.jar
26 Aug 2025
2.7.1+1.21.6
placeholder-api-2.7.1+1.21.6.jar
22 Jun 2025
2.6.4+1.21.5
placeholder-api-2.6.4+1.21.5.jar
2 Jun 2025
Looking for an older file? The official Modrinth project page is in Resources.