PlaceholderAPI Placeholders

The placeholders EmakiStorage registers with PlaceholderAPI, together with how they resolve, are listed below and ready to paste into scoreboards, menus and other text templates

Prerequisite: PlaceholderAPI is present. When it is, EmakiStorage registers the extension with identifier emakistorage. The placeholders work in scoreboards, menus, chat formats, boss bars, action bars and any other plugin text template that supports PlaceholderAPI

Without PlaceholderAPI, EmakiStorage itself still runs normally; it simply does not register the %emakistorage_*% external placeholders

Placeholder List

Placeholder	Description
%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

Thread constraint: 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. Error handling: an unloaded storage reports 0, and an unrecognised placeholder returns an empty string

Matching rules: placeholder names are case-insensitive, lower-cased before evaluation, so %emakistorage_USED_SLOTS% is equivalent to the all-lowercase form. The count_ prefix is matched before any other name and the rest is parsed as a CoreLib ItemSource token (also lower-cased first); an unparseable token returns 0. Every result is returned as a decimal string, with no thousands separators

Error handling: when the player argument is absent (for example evaluated from the console or without a player context) the extension returns an empty string rather than 0

Related Pages

• 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