ModsFinder

Text Placeholder API

by Patbox

Text Placeholder API lets Fabric mods share placeholders such as %modid:type% and a simple text format for chat and config styling.

FabricQuiltClient or server, optionalGNU Lesser General Public License v3.0 onlyOpen source1.17 – 26.3

What it does

Placeholders are short tags that a mod replaces with live values, for example a player name or a server statistic. This library defines one format, %modid:type% or %modid:type data%, so placeholders from different mods work the same way wherever a compatible mod accepts text. Server owners can configure several mods with the same syntax.

It also includes a simplified text format, a readable way to add colors and styles without writing JSON text components. The library is small and can be bundled inside other mods. 31 catalog mods require it, including Mod Menu, CustomNameTags and HoloDisplays. It is open source under the GNU Lesser General Public License v3.0 only.

Key features

  1. Shared placeholder format

    One %modid:type% syntax works across every mod that supports the library.

  2. Mod placeholders

    Mods register their own placeholders, which then become usable in other compatible mods.

  3. Simplified text styling

    Colored and styled text is written in readable tags instead of raw JSON.

  4. Small and bundleable

    The API is light enough for mods to include it directly inside their own files.

Compatibility

Latest build for each game version and loader.

26.x5 of 5 versions with builds
26.33.2.0+26.3Not available
26.23.1.0-beta.1+26.2Not available
26.1.23.0.0+26.1Not available
26.1.13.0.0+26.1Not available
26.13.0.0+26.1Not available
1.21.x12 of 12 versions with builds
1.21.112.8.2+1.21.102.8.2+1.21.10
1.21.102.8.2+1.21.102.8.2+1.21.10
1.21.92.8.1+1.21.102.8.1+1.21.10
1.21.82.7.2+1.21.82.7.2+1.21.8
1.21.72.7.2+1.21.82.7.2+1.21.8
1.21.62.7.2+1.21.82.7.2+1.21.8
1.21.52.6.4+1.21.52.6.4+1.21.5
1.21.42.5.2+1.21.32.5.2+1.21.3
1.21.32.5.2+1.21.32.5.2+1.21.3
1.21.22.5.2+1.21.32.5.2+1.21.3
1.21.12.4.2+1.212.4.2+1.21
1.212.4.2+1.212.4.2+1.21
1.20.x7 of 7 versions with builds
1.19.x5 of 5 versions with builds
1.18.x3 of 3 versions with builds
1.17.x2 of 2 versions with builds
ReleaseBetaAlphaNot available

This mod also publishes snapshot builds. Snapshots are not shown in the matrix.

Required by 31 mods

Mod Menu1.14.4 – 26.3MonkeyLib5381.19.2 – 26.3CustomNameTags1.20 – 26.3AutoSprint1.21.1 – 1.21.11HoloDisplays1.20.5 – 26.3Topper1.8 – 26.3

Questions

Which loaders does it support?

Fabric and Quilt. The Fabric file 3.2.0+26.3 targets 26.3; the Quilt file stops at 1.21.11.

Did the placeholder syntax change?

Before 1.19 arguments used %modid:type/data%. Newer versions use a space: %modid:type data%.

In the catalog

Text Placeholder API is one of 3,514 Library mods on ModsFinder, and one of 2,348 Library mods for Fabric. 8,071 mods support Minecraft 26.3.

Library mods3,514Fabric modsMods for 26.38,071

More from Patbox

All projects
Universal Graves1.17 – 26.3Entity View Distance1.17.1 – 26.3Polymer1.18 – 26.3Universal Shops1.19.2 – 26.3Styled Chat1.17 – 26.3Simple Resource Loader1.21 – 26.3

Similar mods

Fabric API1.14 – 26.3Cloth Config API1.14 – 26.3YetAnotherConfigLib (YACL)1.19 – 26.3Architectury API1.16.5 – 26.3Just Enough Items (JEI)1.8 – 26.3Geckolib1.12.2 – 26.3

What the author says

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…
Patbox, on the Modrinth page

Official listing

Owner
Patbox
Published
2023-05-07
Updated on Modrinth
2026-09-09
Facts verified
2026-10-15

Tags

LibraryManagement
Open on ModrinthCompare