Back to marketplace
Text Placeholder API
Modrinth Mod

Text Placeholder API

Placeholder and Text manipulation library for your Minecraft mods.

Minecraft product info

Important product information

Compatibility, Minecraft versions, loaders, and external source data.

Type

Mod

Access

Free

Latest version

3.1.0-beta.1+26.2

Downloads

52 310 533

Loaders / Platforms

fabric quilt

Minecraft versions

1.17 – 1.21.11 26.1 26.1.1 26.1.2 26.2

Categories

library

Description

Detailed information

# 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](https://placeholders.pb4.eu/user/general) - [Default placeholder list](https://placeholders.pb4.eu/user/default-placeholders) - [Mod placeholder list](https://placeholders.pb4.eu/user/mod-placeholders) - [QuickText](https://placeholders.pb4.eu/user/quicktext) - [Simplified Text Format](https://placeholders.pb4.eu/user/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. - [Getting Started](https://placeholders.pb4.eu/dev/getting-started) - [Adding placeholders](https://placeholders.pb4.eu/dev/adding-placeholders) - [Parsing placeholders](https://placeholders.pb4.eu/dev/parsing-placeholders) - [TextNodes and NodeParsers](https://placeholders.pb4.eu/dev/text-nodes) - [Using Simplified Text Format (TextParserV1)](https://placeholders.pb4.eu/dev/text-format) *[JIJ]: Jar-in-Jar

Developer

Patbox

Profile and data retrieved from Modrinth

Open on Modrinth

Product gallery

Project images

Screenshots and images from the original Modrinth page.

No images yet

The project author has not added a gallery on Modrinth.

Change log

Project versions

Published versions and original Modrinth files.

3.1.0-beta.1+26.2 Current Release 27.05.2026

3.1.0-beta.1+26.2

Supported Minecraft versions
26.2-pre-1 26.2
Loaders / Platforms
fabric
Show changes
**Full Changelog**: https://github.com/Patbox/TextPlaceholderAPI/compare/3.0.0+26.1...3.1.0-beta.1+26.2
Sign in

0.24 MB

3.1.0-beta.1+26.2 Release 27.05.2026

3.1.0-beta.1+26.2

Supported Minecraft versions
26.2-pre-1
Loaders / Platforms
fabric
Show changes
**Full Changelog**: https://github.com/Patbox/TextPlaceholderAPI/compare/3.0.0+26.1...3.1.0-beta.1+26.2
Sign in

0.24 MB

3.0.0+26.1 Release 11.04.2026

3.0.0+26.1

Supported Minecraft versions
26.1 26.1.1 26.1.2
Loaders / Platforms
fabric
Show changes
## 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
Sign in

0.24 MB

3.0.0-beta.2+26.1 Release 18.03.2026

3.0.0-beta.2+26.1

Supported Minecraft versions
26.1-pre-3 26.1 26.1.1 26w14a 26.1.2
Loaders / Platforms
fabric
Show changes
**Full Changelog**: https://github.com/Patbox/TextPlaceholderAPI/compare/3.0.0-beta.1+26.1...3.0.0-beta.2+26.1
Sign in

0.24 MB

3.0.0-beta.1+26.1 Beta 14.02.2026

3.0.0-beta.1+26.1

Supported Minecraft versions
26.1-snapshot-7
Loaders / Platforms
fabric quilt
Show changes
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
Sign in

0.23 MB

2.8.2+1.21.10 Release 01.02.2026

2.8.2+1.21.10

Supported Minecraft versions
1.21.10 1.21.11
Loaders / Platforms
fabric quilt
Show changes
**Full Changelog**: https://github.com/Patbox/TextPlaceholderAPI/compare/2.8.1+1.21.10...2.8.2+1.21.10
Sign in

0.26 MB

2.8.1+1.21.10 Release 25.10.2025

2.8.1+1.21.10

Supported Minecraft versions
1.21.9 1.21.10 1.21.11-pre1 1.21.11
Loaders / Platforms
fabric quilt
Show changes
## 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
Sign in

0.26 MB

2.8.0+1.21.9 Release 28.09.2025

2.8.0+1.21.9

Supported Minecraft versions
1.21.9-rc1 1.21.9 1.21.10
Loaders / Platforms
fabric quilt
Show changes
**Full Changelog**: https://github.com/Patbox/TextPlaceholderAPI/compare/2.8.0-rc.1+1.21.9...2.8.0+1.21.9
Sign in

0.25 MB

2.8.0-rc.1+1.21.9 Release 17.09.2025

2.8.0-rc.1+1.21.9

Supported Minecraft versions
1.21.9-pre1 1.21.9-pre2 1.21.9-pre3
Loaders / Platforms
fabric quilt
Show changes
**Full Changelog**: https://github.com/Patbox/TextPlaceholderAPI/compare/2.7.2+1.21.8...2.8.0-rc.1+1.21.9
Sign in

0.25 MB

2.7.2+1.21.8 Release 26.08.2025

2.7.2+1.21.8

Supported Minecraft versions
1.21.6 1.21.7 1.21.8
Loaders / Platforms
fabric quilt
Show changes
## 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
Sign in

0.25 MB

2.7.1+1.21.6 Release 22.06.2025

2.7.1+1.21.6

Supported Minecraft versions
1.21.6 1.21.7 1.21.8
Loaders / Platforms
fabric quilt
Show changes
**Full Changelog**: https://github.com/Patbox/TextPlaceholderAPI/compare/2.7.0+1.21.6...2.7.1+1.21.6
Sign in

0.25 MB

2.6.4+1.21.5 Release 02.06.2025

2.6.4+1.21.5

Supported Minecraft versions
1.21.5
Loaders / Platforms
fabric quilt
Show changes
**Full Changelog**: https://github.com/Patbox/TextPlaceholderAPI/compare/2.6.3+1.21.5...2.6.4+1.21.5
Sign in

0.25 MB

2.7.0+1.21.6 Release 02.06.2025

2.7.0+1.21.6

Supported Minecraft versions
1.21.6-pre2 1.21.6
Loaders / Platforms
fabric quilt
Show changes
**Full Changelog**: https://github.com/Patbox/TextPlaceholderAPI/compare/2.6.3+1.21.5...2.7.0+1.21.6
Sign in

0.25 MB

2.6.3+1.21.5 Release 28.04.2025

2.6.3+1.21.5

Supported Minecraft versions
1.21.5
Loaders / Platforms
fabric quilt
Show changes
## 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 * @ItsJustMiaouss made their first contribution in https://github.com/Patbox/TextPlaceholderAPI/pull/76 **Full Changelog**: https://github.com/Patbox/TextPlaceholderAPI/compare/2.6.2+1.21.5...2.6.3+1.21.5
Sign in

0.25 MB

2.6.3+25w14craftmine Beta 03.04.2025

2.6.3+25w14craftmine

Supported Minecraft versions
25w14craftmine
Loaders / Platforms
fabric quilt
Show changes
## What's Changed * Update to 25w14craftmine. by @Mikarific in https://github.com/Patbox/TextPlaceholderAPI/pull/74 ## New Contributors * @Mikarific made their first contribution in https://github.com/Patbox/TextPlaceholderAPI/pull/74 **Full Changelog**: https://github.com/Patbox/TextPlaceholderAPI/compare/2.6.2+1.21.5...2.6.3+25w14craftmine
Sign in

0.25 MB

2.6.2+1.21.5 Release 28.03.2025

2.6.2+1.21.5

Supported Minecraft versions
1.21.5
Loaders / Platforms
fabric quilt
Show changes
**Full Changelog**: https://github.com/Patbox/TextPlaceholderAPI/compare/2.6.1+1.21.5...2.6.2+1.21.5
Sign in

0.25 MB

2.6.1+1.21.5 Release 23.03.2025

2.6.1+1.21.5

Supported Minecraft versions
1.21.5-rc1 1.21.5
Loaders / Platforms
fabric quilt
Show changes
**Full Changelog**: https://github.com/Patbox/TextPlaceholderAPI/compare/2.6.0+1.21.5...2.6.1+1.21.5
Sign in

0.24 MB

2.6.0+1.21.5 Release 21.03.2025

2.6.0+1.21.5

Supported Minecraft versions
1.21.5-rc1
Loaders / Platforms
fabric quilt
Show changes
## What's Changed * Ensure parser is deterministic by @DrexHD in https://github.com/Patbox/TextPlaceholderAPI/pull/67 * Port to 1.21.5-pre3+ by @sakura-ryoko in https://github.com/Patbox/TextPlaceholderAPI/pull/70 **Full Changelog**: https://github.com/Patbox/TextPlaceholderAPI/compare/2.5.1+1.21.3...2.6.0+1.21.5
Sign in

0.24 MB

2.1.1+1.19.4 Release 27.01.2025

2.1.1+1.19.4

Supported Minecraft versions
1.19.3 1.19.4
Loaders / Platforms
fabric quilt
Sign in

0.13 MB

2.1.4+1.20.1 Release 27.01.2025

2.1.4+1.20.1

Supported Minecraft versions
1.20.1
Loaders / Platforms
fabric quilt
Show changes
**Full Changelog**: https://github.com/Patbox/TextPlaceholderAPI/compare/2.1.3+1.20.1...2.1.4+1.20.1
Sign in

0.14 MB

2.2.1+1.20.2 Release 27.01.2025

2.2.1+1.20.2

Supported Minecraft versions
1.20.2-rc2 1.20.2
Loaders / Platforms
fabric quilt
Show changes
**Full Changelog**: https://github.com/Patbox/TextPlaceholderAPI/compare/2.2.0+1.20.2...2.2.1+1.20.2
Sign in

0.14 MB

2.4.0-pre.3+1.20.4 Release 27.01.2025

2.4.0-pre.3+1.20.4

Supported Minecraft versions
1.20.3 1.20.4
Loaders / Platforms
fabric quilt
Show changes
**Full Changelog**: https://github.com/Patbox/TextPlaceholderAPI/compare/2.4.0-pre.1+1.20.4...2.4.0-pre.3+1.20.4
Sign in

0.22 MB

2.4.0-pre.2+1.20.5 Release 27.01.2025

2.4.0-pre.2+1.20.5

Supported Minecraft versions
1.20.5-rc1
Loaders / Platforms
fabric quilt
Show changes
**Full Changelog**: https://github.com/Patbox/TextPlaceholderAPI/compare/2.4.0-pre.1+1.20.4...2.4.0-pre.2+1.20.5
Sign in

0.22 MB

2.4.2+1.21 Release 27.01.2025

2.4.2+1.21

Supported Minecraft versions
1.21 1.21.1
Loaders / Platforms
fabric quilt
Show changes
**Full Changelog**: https://github.com/Patbox/TextPlaceholderAPI/compare/2.4.1+1.21...2.4.2+1.21
Sign in

0.22 MB

2.5.2+1.21.3 Release 27.01.2025

2.5.2+1.21.3

Supported Minecraft versions
1.21.2 1.21.3 1.21.4
Loaders / Platforms
fabric quilt
Show changes
**Full Changelog**: https://github.com/Patbox/TextPlaceholderAPI/compare/2.5.1+1.21.3...2.5.2+1.21.3
Sign in

0.23 MB

2.5.1+1.21.3 Release 21.11.2024

2.5.1+1.21.3

Supported Minecraft versions
1.21.3 1.21.4
Loaders / Platforms
fabric quilt
Show changes
**Full Changelog**: https://github.com/Patbox/TextPlaceholderAPI/compare/2.5.0+1.21.2...2.5.1+1.21.3
Sign in

0.23 MB

2.5.0+1.21.2 Release 19.10.2024

2.5.0+1.21.2

Supported Minecraft versions
1.21.2-rc1 1.21.2 1.21.3
Loaders / Platforms
fabric quilt
Show changes
## What's Changed * Update to 1.21.2 by @DrexHD in https://github.com/Patbox/TextPlaceholderAPI/pull/57 **Full Changelog**: https://github.com/Patbox/TextPlaceholderAPI/compare/2.4.1+1.21...2.5.0+1.21.2
Sign in

0.22 MB

2.4.1+1.21 Release 15.07.2024

2.4.1+1.21

Supported Minecraft versions
1.21 1.21.1
Loaders / Platforms
fabric quilt
Show changes
**Full Changelog**: https://github.com/Patbox/TextPlaceholderAPI/compare/2.4.0+1.21...2.4.1+1.21
Sign in

0.22 MB

2.4.0+1.21 Release 23.06.2024

2.4.0+1.21

Supported Minecraft versions
1.21
Loaders / Platforms
fabric quilt
Sign in

0.22 MB

2.4.0-pre.1+1.20.4 Release 18.06.2024

2.4.0-pre.1+1.20.4

Supported Minecraft versions
1.20.4
Loaders / Platforms
fabric quilt
Show changes
## What's Changed * Update mod-placeholders.md by @sakura-ryoko in https://github.com/Patbox/TextPlaceholderAPI/pull/49 * AfkPlus 1.4.2 updates by @sakura-ryoko in https://github.com/Patbox/TextPlaceholderAPI/pull/52 **Full Changelog**: https://github.com/Patbox/TextPlaceholderAPI/compare/2.3.0+1.20.3...2.4.0-pre.1+1.20.4
Sign in

0.22 MB

2.4.0-pre.2+1.21 Release 02.06.2024

2.4.0-pre.2+1.21

Supported Minecraft versions
1.21-pre2 1.21
Loaders / Platforms
fabric quilt
Show changes
## What's Changed * Update to 1.21-pre2 by @sakura-ryoko in https://github.com/Patbox/TextPlaceholderAPI/pull/55 **Full Changelog**: https://github.com/Patbox/TextPlaceholderAPI/compare/2.4.0-pre.1+1.20.5...2.4.0-pre.2+1.21
Sign in

0.22 MB

2.4.0-pre.1+1.20.5 Release 18.04.2024

2.4.0-pre.1+1.20.5

Supported Minecraft versions
1.20.5-rc1 1.20.5 1.20.6
Loaders / Platforms
fabric quilt
Sign in

0.22 MB

2.3.0+1.20.3 Release 30.11.2023

2.3.0+1.20.3

Supported Minecraft versions
1.20.3-rc1 1.20.3 1.20.4
Loaders / Platforms
fabric quilt
Sign in

0.14 MB

2.2.0+1.20.2 Release 19.09.2023

2.2.0+1.20.2

Supported Minecraft versions
1.20.2-rc2 1.20.2
Loaders / Platforms
fabric quilt
Sign in

0.14 MB

2.1.3+1.20.1 Release 08.09.2023

2.1.3+1.20.1

Supported Minecraft versions
1.20.1
Loaders / Platforms
fabric quilt
Sign in

0.14 MB

2.1.2+1.20.1 Release 05.09.2023

2.1.2+1.20.1

Supported Minecraft versions
1.20.1
Loaders / Platforms
fabric
Sign in

0.14 MB

2.1.1+1.20 Release 11.06.2023

2.1.1+1.20

Supported Minecraft versions
1.20 1.20.1
Loaders / Platforms
fabric
Sign in

0.13 MB

2.1.0+1.19.4 Release 07.05.2023

2.1.0+1.19.4

Supported Minecraft versions
1.19.4
Loaders / Platforms
fabric quilt
Sign in

0.13 MB

2.0.0-rc.1+1.19.3 Beta 07.05.2023

2.0.0-rc.1+1.19.3

Supported Minecraft versions
1.19.3
Loaders / Platforms
fabric quilt
Sign in

0.11 MB

2.0.0-pre.1+1.19.2 Beta 07.05.2023

2.0.0-pre.1+1.19.2

Supported Minecraft versions
1.19.1 1.19.2
Loaders / Platforms
fabric quilt
Sign in

0.1 MB

2.0.0-beta.7+1.19 Beta 07.05.2023

2.0.0-beta.7+1.19

Supported Minecraft versions
1.19
Loaders / Platforms
fabric quilt
Sign in

0.09 MB

1.1.3+1.17.1 Release 07.05.2023

1.1.3+1.17.1

Supported Minecraft versions
1.17 1.17.1 1.18 1.18.1 1.18.2
Loaders / Platforms
fabric quilt
Sign in

0.04 MB