Skip to content

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.