Description

Gallery

Changelog

Versions

About Placeholder API

Name: Text Placeholder API
Author: Patbox

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.

*[JIJ]: Jar-in-Jar

All Versions

+ Add Version

Game Version

Mod Loader

Release Channel

Name	Game version	Platforms	Published	Downloads	Actions
R 3.2.0+26.3	26.3.x	Fabric	20h ago	1	Download Open in new tab Copy link Report
R 3.1.0-beta.1+26.2	26.2.x	Fabric	20h ago	1	Download Open in new tab Copy link Report
R 3.1.0-beta.1+26.2	26.2-pre-1	Fabric	20h ago	1	Download Open in new tab Copy link Report
R 3.0.0+26.1	26.1.x	Fabric	20h ago	1	Download Open in new tab Copy link Report
R 3.0.0-beta.2+26.1	26.1.x 26w14a	Fabric	20h ago	1	Download Open in new tab Copy link Report
B 3.0.0-beta.1+26.1	26.1-snapshot-7	Fabric Quilt	20h ago	1	Download Open in new tab Copy link Report
R 2.8.2+1.21.10	1.21.x	Fabric Quilt	20h ago	1	Download Open in new tab Copy link Report
R 2.8.1+1.21.10	1.21.x	Fabric Quilt	20h ago	1	Download Open in new tab Copy link Report
R 2.8.0+1.21.9	1.21.x	Fabric Quilt	20h ago	1	Download Open in new tab Copy link Report
R 2.8.0-rc.1+1.21.9	1.21.x	Fabric Quilt	20h ago	1	Download Open in new tab Copy link Report
R 2.7.2+1.21.8	1.21.x	Fabric Quilt	20h ago	1	Download Open in new tab Copy link Report
R 2.7.1+1.21.6	1.21.x	Fabric Quilt	20h ago	1	Download Open in new tab Copy link Report
R 2.6.4+1.21.5	1.21.5	Fabric Quilt	20h ago	1	Download Open in new tab Copy link Report
R 2.7.0+1.21.6	1.21.x	Fabric Quilt	20h ago	1	Download Open in new tab Copy link Report
R 2.6.3+1.21.5	1.21.5	Fabric Quilt	20h ago	1	Download Open in new tab Copy link Report
B 2.6.3+25w14craftmine	25w14craftmine	Fabric Quilt	20h ago	1	Download Open in new tab Copy link Report
R 2.6.2+1.21.5	1.21.5	Fabric Quilt	20h ago	1	Download Open in new tab Copy link Report
R 2.6.1+1.21.5	1.21.x	Fabric Quilt	20h ago	1	Download Open in new tab Copy link Report
R 2.6.0+1.21.5	1.21.5-rc1	Fabric Quilt	20h ago	1	Download Open in new tab Copy link Report
R 2.1.1+1.19.4	1.19.x	Fabric Quilt	20h ago	1	Download Open in new tab Copy link Report
R 2.1.4+1.20.1	1.20.1	Fabric Quilt	20h ago	1	Download Open in new tab Copy link Report
R 2.2.1+1.20.2	1.20.x	Fabric Quilt	20h ago	1	Download Open in new tab Copy link Report
R 2.4.0-pre.3+1.20.4	1.20.x	Fabric Quilt	20h ago	1	Download Open in new tab Copy link Report
R 2.4.0-pre.2+1.20.5	1.20.5-rc1	Fabric Quilt	20h ago	1	Download Open in new tab Copy link Report
R 2.4.2+1.21	1.21.x	Fabric Quilt	20h ago	1	Download Open in new tab Copy link Report
R 2.5.2+1.21.3	1.21.x	Fabric Quilt	20h ago	1	Download Open in new tab Copy link Report
R 2.5.1+1.21.3	1.21.x	Fabric Quilt	20h ago	1	Download Open in new tab Copy link Report
R 2.5.0+1.21.2	1.21.x	Fabric Quilt	20h ago	1	Download Open in new tab Copy link Report
R 2.4.1+1.21	1.21.x	Fabric Quilt	20h ago	1	Download Open in new tab Copy link Report
R 2.4.0+1.21	1.21	Fabric Quilt	20h ago	1	Download Open in new tab Copy link Report
R 2.4.0-pre.1+1.20.4	1.20.4	Fabric Quilt	20h ago	1	Download Open in new tab Copy link Report
R 2.4.0-pre.2+1.21	1.21.x	Fabric Quilt	20h ago	1	Download Open in new tab Copy link Report
R 2.4.0-pre.1+1.20.5	1.20.x	Fabric Quilt	20h ago	1	Download Open in new tab Copy link Report
R 2.3.0+1.20.3	1.20.x	Fabric Quilt	20h ago	1	Download Open in new tab Copy link Report
R 2.2.0+1.20.2	1.20.x	Fabric Quilt	20h ago	1	Download Open in new tab Copy link Report
R 2.1.3+1.20.1	1.20.1	Fabric Quilt	20h ago	1	Download Open in new tab Copy link Report
R 2.1.2+1.20.1	1.20.1	Fabric	20h ago	1	Download Open in new tab Copy link Report
R 2.1.1+1.20	1.20.x	Fabric	20h ago	1	Download Open in new tab Copy link Report
R 2.1.0+1.19.4	1.19.4	Fabric Quilt	20h ago	1	Download Open in new tab Copy link Report
B 2.0.0-rc.1+1.19.3	1.19.3	Fabric Quilt	20h ago	1	Download Open in new tab Copy link Report
B 2.0.0-pre.1+1.19.2	1.19.x	Fabric Quilt	20h ago	1	Download Open in new tab Copy link Report
B 2.0.0-beta.7+1.19	1.19	Fabric Quilt	20h ago	1	Download Open in new tab Copy link Report
R 1.1.3+1.17.1	1.18.x 1.17.x	Fabric Quilt	20h ago	1	Download Open in new tab Copy link Report

[3.2.0+26.3] 3.2.0+26.3 by Patbox on Oct 07, 2026

Download

Full Changelog**: https://github.com/Patbox/TextPlaceholderAPI/compare/3.1.0-beta.1+26.2...3.2.0+26.3

[3.1.0-beta.1+26.2] 3.1.0-beta.1+26.2 by Patbox on Oct 07, 2026

Download

Full Changelog**: https://github.com/Patbox/TextPlaceholderAPI/compare/3.0.0+26.1...3.1.0-beta.1+26.2

[3.1.0-beta.1+26.2] 3.1.0-beta.1+26.2 by Patbox on Oct 07, 2026

Download

Full Changelog**: https://github.com/Patbox/TextPlaceholderAPI/compare/3.0.0+26.1...3.1.0-beta.1+26.2

[3.0.0+26.1] 3.0.0+26.1 by Patbox on Oct 07, 2026

Download

## What's Changed

Bump Gradle, Fix build.yml, etc by @sakura-ryoko in https://github.com/Patbox/TextPlaceholderAPI/pull/93
Create zh_cn.json by @NumberSir in https://github.com/Patbox/TextPlaceholderAPI/pull/63
🌐 add Argentine Spanish localization by @Texaliuz in https://github.com/Patbox/TextPlaceholderAPI/pull/77
Added language support for Turkish with tr_tr.json by @Runteryaa in https://github.com/Patbox/TextPlaceholderAPI/pull/84
Create uk_ua.json by @StarmanMine142 in https://github.com/Patbox/TextPlaceholderAPI/pull/94

## New Contributors

@NumberSir made their first contribution in https://github.com/Patbox/TextPlaceholderAPI/pull/63
@Texaliuz made their first contribution in https://github.com/Patbox/TextPlaceholderAPI/pull/77
@Runteryaa made their first contribution in https://github.com/Patbox/TextPlaceholderAPI/pull/84
@StarmanMine142 made their first contribution in https://github.com/Patbox/TextPlaceholderAPI/pull/94

Full Changelog**: https://github.com/Patbox/TextPlaceholderAPI/compare/3.0.0-beta.2+26.1...3.0.0+26.1

[3.0.0-beta.2+26.1] 3.0.0-beta.2+26.1 by Patbox on Oct 07, 2026

Download

Full Changelog**: https://github.com/Patbox/TextPlaceholderAPI/compare/3.0.0-beta.1+26.1...3.0.0-beta.2+26.1

[3.0.0-beta.1+26.1] 3.0.0-beta.1+26.1 by Patbox on Oct 07, 2026

Download

First release for new cycle! Includes bunch of refactors and renames and intruduces support for common and client placeholders!

For migration, most notable changes:
What previously was PlaceholderContext was moved to ServerPlaceholderContext, and alike (ParserBuilder changed placeholders() -> serverPlaceholders()) for those who want previous features.
Renamed getText and alike to getComponent. TextNodes are still TextNodes through.

Full Changelog**: https://github.com/Patbox/TextPlaceholderAPI/compare/2.8.1+1.21.10...3.0.0-beta.1+26.1

[2.8.2+1.21.10] 2.8.2+1.21.10 by Patbox on Oct 07, 2026

Download

Full Changelog**: https://github.com/Patbox/TextPlaceholderAPI/compare/2.8.1+1.21.10...2.8.2+1.21.10

[2.8.1+1.21.10] 2.8.1+1.21.10 by Patbox on Oct 07, 2026

Download

## What's Changed

Add player head texture argument by @DrexHD in https://github.com/Patbox/TextPlaceholderAPI/pull/87

Full Changelog**: https://github.com/Patbox/TextPlaceholderAPI/compare/2.8.0+1.21.9...2.8.1+1.21.10

[2.8.0+1.21.9] 2.8.0+1.21.9 by Patbox on Oct 07, 2026

Download

Full Changelog**: https://github.com/Patbox/TextPlaceholderAPI/compare/2.8.0-rc.1+1.21.9...2.8.0+1.21.9

[2.8.0-rc.1+1.21.9] 2.8.0-rc.1+1.21.9 by Patbox on Oct 07, 2026

Download

Full Changelog**: https://github.com/Patbox/TextPlaceholderAPI/compare/2.7.2+1.21.8...2.8.0-rc.1+1.21.9

[2.7.2+1.21.8] 2.7.2+1.21.8 by Patbox on Oct 07, 2026

Download

## What's Changed

Fix parsing during server start by @arvitus in https://github.com/Patbox/TextPlaceholderAPI/pull/83

## New Contributors

@arvitus made their first contribution in https://github.com/Patbox/TextPlaceholderAPI/pull/83

Full Changelog**: https://github.com/Patbox/TextPlaceholderAPI/compare/2.7.1+1.21.6...2.7.2+1.21.8

[2.7.1+1.21.6] 2.7.1+1.21.6 by Patbox on Oct 07, 2026

Download

Full Changelog**: https://github.com/Patbox/TextPlaceholderAPI/compare/2.7.0+1.21.6...2.7.1+1.21.6

[2.6.4+1.21.5] 2.6.4+1.21.5 by Patbox on Oct 07, 2026

Download

Full Changelog**: https://github.com/Patbox/TextPlaceholderAPI/compare/2.6.3+1.21.5...2.6.4+1.21.5

[2.7.0+1.21.6] 2.7.0+1.21.6 by Patbox on Oct 07, 2026

Download

Full Changelog**: https://github.com/Patbox/TextPlaceholderAPI/compare/2.6.3+1.21.5...2.7.0+1.21.6

[2.6.3+1.21.5] 2.6.3+1.21.5 by Patbox on Oct 07, 2026

Download

## What's Changed

Fix objective_name_top & objective_score_top not sorted correctly (issue #75) by @ItsJustMiaouss in https://github.com/Patbox/TextPlaceholderAPI/pull/76

## New Contributors