Mods Resource Packs Data Packs Plugins Shaders Modpacks
Get Modrinth App
Upgrade to Modrinth+
Sign in
ModsPluginsData PacksShadersResource PacksModpacks
Sign in
Settings
Text Placeholder API

Text Placeholder API

Placeholder and Text manipulation library for your Minecraft mods.

5.79M
688
Library
AboutChangelogVersions

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.

  • Getting Started
  • Adding placeholders
  • Parsing placeholders
  • TextNodes and NodeParsers
  • Using Simplified Text Format (TextParserV1)

*[JIJ]: Jar-in-Jar

90% of ad revenue goes to creators

Support creators and Modrinth ad-free with Modrinth+

Compatibility

Minecraft: Java Edition

1.21.x
1.20.x
1.19.x
1.18.x
1.17.x

Platforms

Fabric
Quilt

Supported environments

Client only
Server only
Singleplayer
Client and server (optional)

Links

Report issues View source Visit wiki Join Discord server
Donate on Ko-fi

Creators

Patbox
Patbox Owner

Details

Licensed LGPL-3.0-only
Published 2 years ago
Updated 3 weeks ago

Modrinth is open source.

new-project-page@ac78952

© Rinth, Inc.

Company

TermsPrivacyRulesCareers

Resources

SupportBlogDocsStatus

Interact

Discord X (Twitter) Mastodon Crowdin
Get Modrinth App Settings
NOT AN OFFICIAL MINECRAFT SERVICE. NOT APPROVED BY OR ASSOCIATED WITH MOJANG OR MICROSOFT.