Skip to content

PlaceholderAPI Placeholders

EmakiStorage registers a PlaceholderAPI extension when PlaceholderAPI is present. The identifier is emakistorage. The placeholders work in scoreboards, menus, chat formats, boss bars, action bars and any other plugin text template that supports PlaceholderAPI.

If PlaceholderAPI is not installed, EmakiStorage itself still runs normally; it simply does not register the %emakistorage_*% external placeholders.

Placeholder List

PlaceholderDescription
%emakistorage_used_slots%Slots currently holding an entry.
%emakistorage_total_slots%Effective total slots.
%emakistorage_free_slots%Remaining free slots.
%emakistorage_purchased_slots%Purchased slots.
%emakistorage_granted_slots%Granted slots.
%emakistorage_pages%Total pages.
%emakistorage_stack_limit%The currently effective player-level per-slot ceiling.
%emakistorage_sort_mode%The current sort mode id.
%emakistorage_total_amount%Summed amount across every entry, saturating at Long.MAX_VALUE.
%emakistorage_count_<token>%Stored amount for the given ItemSource token, 0 when absent.

Resolution Thread and Unloaded Data

Every placeholder reads the in-memory storage of an online player and never loads from disk: a placeholder resolves on whatever thread PAPI calls it from, so blocking IO is not an option. An unloaded storage reports 0, and an unrecognised placeholder returns an empty string.

  • Capacity: the four-source capacity model behind total_slots, purchased_slots and friends.
  • Event API: the Bukkit events to use when you need to intercept rather than only read.
  • API and Integration: reading capacity and stored amounts from code.