Text Placeholder API
ModLGPL-3.0-only

Text Placeholder API

Placeholder and Text manipulation library for your Minecraft mods.

28.6M
Downloads
1,188
Followers
2 months ago
Updated
📦
30
Versions

📖About Text Placeholder API

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.

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