Text Placeholder API

Text Placeholder API

v3.1.0-beta.1+26.2
Modrinth 1 502 followers 52 310 533 downloads
by Patbox
Sign in

Placeholder and Text manipulation library for your Minecraft mods.

Product

About

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.
- Using placeholders
- Default placeholder list
- Mod placeholder list
- QuickText
- Simplified Text Format

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.

*[JIJ]: Jar-in-Jar

Environment

Requirements & compatibility

Compatibility & requirements

FabricQuilt1.17 – 1.21.1126.126.1.126.1.226.2

Local host

Optional

Hosting on services

Optional

Terms

License

Terms for using, modifying and redistributing this product.

GNU Lesser General Public License v3.0 onlyModrinth
Release

Latest release

v3.1.0-beta.1+26.2

27.05.2026 · Modrinth