Placeholders¶
GreatNPC has two different placeholder systems: direct replacement in its own text/actions, and optional integration with Patbox's Placeholder API.
Built-in message placeholders¶
Configured battle messages and reward commands replace:
| Placeholder | Value |
|---|---|
%player% |
Player account name |
%trainer% |
Trainer display name |
These are not language-file argument placeholders. Language JSON uses %1$s, %2$s, and similar positional arguments.
Placeholder API integration¶
Install the compatible Fabric Placeholder API mod to register these names. They are intended for external systems that evaluate Placeholder API text with a player context.
| Placeholder | Result |
|---|---|
%greatnpc:victories% |
Sum of the player's recorded trainer victories |
%greatnpc:victories gyms/rock% |
Victories against one trainer ID |
%greatnpc:trainers% |
Number of distinct trainer IDs with at least one victory |
%greatnpc:defeated gyms/rock% |
Whether the player has defeated that trainer |
%greatnpc:cooldown gyms/rock% |
Remaining cooldown text, or the available label |
Current defeated token
The current integration returns the legacy string sim for a defeated trainer and no otherwise. It does not return a boolean or the English string yes. Treat these as current integration output values when writing external conditions.
The optional integration requires a player context. Unknown trainer IDs and missing arguments can produce invalid-placeholder results.
Battle history is shared by trainer ID, so these values also aggregate physical copies of the same trainer.