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.
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!
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
Optional
Optional
Terms for using, modifying and redistributing this product.
27.05.2026 · Modrinth
Screenshots and images from the original Modrinth page.
The project author has not added a gallery on Modrinth.
Published versions and original Modrinth files.
27.05.2026 · 2 150 139 downloads
27.05.2026 · 495 downloads
11.04.2026 · 2 818 916 downloads
Full Changelog: https://github.com/Patbox/TextPlaceholderAPI/compare/3.0.0-beta.2+26.1...3.0.0+26.1
18.03.2026 · 2 434 611 downloads
14.02.2026 · 5 522 downloads
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
01.02.2026 · 6 403 356 downloads
25.10.2025 · 9 575 679 downloads
Full Changelog: https://github.com/Patbox/TextPlaceholderAPI/compare/2.8.0+1.21.9...2.8.1+1.21.10
28.09.2025 · 3 611 512 downloads
17.09.2025 · 611 downloads
26.08.2025 · 2 227 681 downloads
Full Changelog: https://github.com/Patbox/TextPlaceholderAPI/compare/2.7.1+1.21.6...2.7.2+1.21.8
22.06.2025 · 3 165 606 downloads
02.06.2025 · 1 884 820 downloads
02.06.2025 · 32 322 downloads
28.04.2025 · 475 709 downloads
Full Changelog: https://github.com/Patbox/TextPlaceholderAPI/compare/2.6.2+1.21.5...2.6.3+1.21.5
03.04.2025 · 22 661 downloads
Full Changelog: https://github.com/Patbox/TextPlaceholderAPI/compare/2.6.2+1.21.5...2.6.3+25w14craftmine
28.03.2025 · 335 941 downloads
23.03.2025 · 21 468 downloads
21.03.2025 · 422 downloads
Full Changelog: https://github.com/Patbox/TextPlaceholderAPI/compare/2.5.1+1.21.3...2.6.0+1.21.5
27.01.2025 · 13 189 downloads
27.01.2025 · 278 726 downloads
27.01.2025 · 9 542 downloads
27.01.2025 · 379 744 downloads
27.01.2025 · 8 635 downloads
27.01.2025 · 6 568 944 downloads
27.01.2025 · 3 649 229 downloads
21.11.2024 · 685 600 downloads
19.10.2024 · 120 922 downloads
Full Changelog: https://github.com/Patbox/TextPlaceholderAPI/compare/2.4.1+1.21...2.5.0+1.21.2
15.07.2024 · 4 273 488 downloads
23.06.2024 · 275 492 downloads
18.06.2024 · 248 882 downloads
Full Changelog: https://github.com/Patbox/TextPlaceholderAPI/compare/2.3.0+1.20.3...2.4.0-pre.1+1.20.4
02.06.2024 · 87 440 downloads
Full Changelog: https://github.com/Patbox/TextPlaceholderAPI/compare/2.4.0-pre.1+1.20.5...2.4.0-pre.2+1.21
18.04.2024 · 381 087 downloads
30.11.2023 · 2 363 downloads
19.09.2023 · 5 553 downloads
08.09.2023 · 97 849 downloads
05.09.2023 · 781 downloads
11.06.2023 · 15 864 downloads
07.05.2023 · 2 805 downloads
07.05.2023 · 699 downloads
07.05.2023 · 14 363 downloads
07.05.2023 · 3 838 downloads
07.05.2023 · 18 019 downloads