Astral Realms Documentation Help

Placeholders

AstralVote registers two ComplexPlaceholders: the votes namespace (always available) and each configured vote service, which is itself a ComplexPlaceholder under the service namespace but only resolves where a service instance has been placed into the placeholder context (e.g. rendering VOTE_AVAILABLE). For the placeholder syntax itself (%a_b_c%, $e(...)) see Placeholders.

votes namespace

Placeholder

Description

%votes_unclaimed%

The player's cached unclaimed-vote count (VoteService#getCachedUnclaimedCount). Player-only — resolves null outside a player context.

%votes_weekly%

The player's cached weekly vote count since the most recent Monday, Europe/Paris (VoteService#getCachedWeeklyVoteCount). Player-only.

%votes_remindersEnabled%

Whether the player currently has vote reminders enabled (VotePlayerData#voteRemindersEnabled, synced by AstralSync). Player-only; resolves false if the player's synced data isn't loaded.

lore: - "<gray>Unclaimed votes: <white>%votes_unclaimed%" - "<gray>Votes this week: <white>%votes_weekly%"

service namespace

Each entry under services in config.yml implements ComplexPlaceholder directly, so wherever a service instance is registered into a placeholder context (only VOTE_AVAILABLE, today), its fields resolve as sub-keys:

Placeholder

Description

%service_id%

The service's id field.

%service_name%

The service's name field.

%service_link%

The service's link field — the voting site URL.

%service_cooldown%

The service's cooldown Duration.

See also

  • Configuration — the services map these placeholders read from.

  • Overview — how the unclaimed/weekly caches are populated.

  • Actions — the action %votes_remindersEnabled% reflects.

Last modified: 25 July 2026
ActionsDeveloper API