Placeholders
Using SamsHead with PlaceholderAPI
SamsHead provides highly flexible placeholders to render avatars and full player busts anywhere text is supported.
Avatar Head Syntax
The format follows: %samshead_avatar_<size>[_layer][_border_RRGGBB][_<player>]%.
1. Size Presets
Choose from small, medium, normal, large, or giant.
2. Layers (Optional)
face: Only the base skin layer.head: Skin + Hat/Overlay layer (Default).
3. Framed Avatars (Borders)
You can now add a 1-pixel colored border around any avatar. This uses a specialized 10x10 glyph set to ensure the head remains clean.
- Syntax:
border_<RRGGBB> - Example:
%samshead_avatar_medium_border_ff0000%(Red border)
4. Target Player (Optional)
If omitted, the placeholder targets the player viewing it.
%samshead_avatar_medium% Displays the viewer's own head (default layer).
Player Bust Syntax
Busts render a 32×32 Minecraft-style display including the head, body, and arms.
Scoreboard/TAB Safety
Bust placeholders are NOT safe for Scoreboards, TAB rows, or Nametags. They generate long text strings that can cause client kicks due to packet length limits. Use them in Chat, Holograms, or GUIs only.
Format: %samshead_bust_<size>_<player>%
Available Bust Sizes
| Preset | Pixel Size |
|---|---|
| small | 1 |
| medium | 2 |
| normal | 2 |
| large | 3 |
| giant | 4 |
SkinsRestorer
SamsHead is fully compatible with SkinsRestorer. It will automatically detect skin changes and update the rendered avatar instantly.
Nested placeholders (dynamic names)
PlaceholderAPI does not expand a %...% inside another %...%. To feed one placeholder's output (for example a top-money leaderboard name) into an avatar, wrap the inner placeholder in curly braces:
%samshead_avatar_small_{perfranknpcs_money_alltime_1_name}%
%samshead_bust_normal_{perfranknpcs_money_alltime_2_name}%
SamsHead resolves the inner {placeholder} first, then renders that player's avatar.. perfect for leaderboards where the name changes.
Good to know
Pick a leaderboard placeholder that returns just the username (usually the ..._name variant). If it returns a prefixed/coloured name with spaces, SamsHead can't match a player from it.