Placeholders

ServiceIO provides PlaceholderAPI integration, allowing you to use ServiceIO data in other plugins that support placeholders.

Placeholder Format

All ServiceIO placeholders follow the format:

%serviceio_<placeholder>%

Available Placeholders

Player Information

• %serviceio_prefix% - Player's prefix from the permission service
• %serviceio_suffix% - Player's suffix from the permission service
• %serviceio_displayname% - Player's display name

Economy

• %serviceio_balance% - Player's current balance (raw number)
• %serviceio_balance_<world>% - Player's balance in a specific world (raw number)
• %serviceio_balance_formatted% - Player's current balance (formatted with currency)
• %serviceio_balance_formatted_<world>% - Player's balance in a specific world (formatted with currency)

Banking

• %serviceio_bank% - Name of the player's current bank
• %serviceio_bank_balance% - Player's current bank balance (raw number)
• %serviceio_bank_balance_formatted% - Player's current bank balance (formatted with currency)
• %serviceio_bank_<world>% - Name of the player's bank in a specific world
• %serviceio_bank_<world>_balance% - Bank balance in a specific world (raw number)
• %serviceio_bank_<world>_balance_formatted% - Bank balance in a specific world (formatted with currency)
• %serviceio_banks% - List of all available banks (comma-separated)
• %serviceio_banks_<world>% - List of banks available in a specific world (comma-separated)

Permission Groups

• %serviceio_group% - Player's primary permission group
• %serviceio_groups% - All of player's permission groups (comma-separated)

VaultUnlocked Compatibility

ServiceIO also provides VaultUnlocked placeholders using the %vaultunlocked_<placeholder>% format for compatibility reasons:

• %vaultunlocked_balance% - Player's balance
• %vaultunlocked_balance_<world>% - Balance in a specific world
• %vaultunlocked_balanceformatted% - Formatted balance
• %vaultunlocked_balance_currency_<currency>% - Balance in a specific currency
• %vaultunlocked_accounts% - List of accounts the player is a member of
• %vaultunlocked_accounts_count% - Number of accounts the player belongs to

Usage Examples

In Chat Formats

# Example chat format using ServiceIO placeholders
format: "%serviceio_prefix%%player_name%%serviceio_suffix%: %message%"

In Scoreboards

# Example scoreboard using economy data
title: "Server Info"
lines:
  - "Balance: %serviceio_balance_formatted%"
  - "Bank: %serviceio_bank_balance_formatted%"
  - "Rank: %serviceio_group%"

World-Specific Economy

# Show balance for specific world
balance-message: "Your balance in %world%: %serviceio_balance_formatted_world%"

# Bank balance in a specific world  
bank-info: "Your bank in the nether: %serviceio_bank_nether_balance_formatted%"

Multi-Bank Setup

# List all available banks
bank-list: "Available banks: %serviceio_banks%"

# Show player's current bank
current-bank: "Your current bank: %serviceio_bank%"

Troubleshooting

If a placeholder shows the literal placeholder text instead of the expected value, check your configuration and ensure the appropriate service providers are properly installed and configured.