PlaceholderAPI

Overview

mineWallet integrates with PlaceholderAPI to provide wallet-related placeholders that can be used in scoreboards, tab lists, holograms, and any other plugin that supports PlaceholderAPI.

Requirements

• PlaceholderAPI 2.11.6+

PlaceholderAPI is an optional dependency — the plugin works without it, but placeholders will not be available.

Available Placeholders

Placeholder	Description	Example Output
%mineWallet_balance%	Player’s current wallet balance	150.25

Fallback Value

If the player’s data is not available (e.g. the player is offline or the profile has not loaded yet), the placeholder returns the value configured in messages.yml:

dataNotAvailablePlaceholder: "None"

Usage Examples

Scoreboard

Balance: %mineWallet_balance%$

Tab List

[%mineWallet_balance%$] {player}

Hologram

Your balance: %mineWallet_balance%$

PlaceholderAPI in Shop GUI

PlaceholderAPI placeholders can be used in UI item display names and lore across all shop GUIs (store-ui.yml, pay-confirm-ui.yml, quantity-select-ui.yml). This allows displaying dynamic data from other plugins directly in shop items.

elements:
  - slot: 2
    material: PLAYER_HEAD
    function: CHANGE_CATEGORY
    displayName: "<#FCD05C>Hello, %player_name%!"
    lore:
      - "<#AAAAAA>Your rank: %luckperms_primary_group%"

Placeholders are resolved per-player when the GUI is opened. Both regular UI elements and fill elements support this feature.