- Java Version: 21+
- Server Software: Paper / Purpur
- Server Version: 1.21 or above
- Optional Dependencies: PlaceholderAPI, ItemsAdder, Nexo, SkinsRestorer
General Features
- Text-Based Player Heads: Display player heads directly through text placeholders
- Pixel Avatar Rendering: Heads are rendered as clean 8×8 avatars using a resource pack font
- Colored Avatar Frames: Add custom outer borders around player heads using any hex color
- Bust Avatar Rendering: Display larger Minecraft-style player busts with head, body and arms
- PlaceholderAPI Support: Use avatars anywhere that supports PlaceholderAPI
- Player Support: Show the current player's avatar or render a specific player by name
Avatar Sizes & Styles
- Multiple Presets: Includes small, medium, normal, large and giant sizes
- Head Avatars: Use compact 8×8 player heads for holograms, menus, TAB and scoreboards
- Framed Avatars: Create clean player heads with a colored outer frame
- Bust Avatars: Use larger upper-body player renders for profiles, previews and decorative displays
- Named Avatars: Display another player's avatar using placeholders
- Rendering: Avatars are rendered as text strings, perfect for holograms, menus, scoreboards and more
Avatar Frames
- Custom Border Colors: Add a frame using any RGB/hex color you want
- Outer Frame Render: Frames are rendered around the avatar instead of covering the skin
- Easy Placeholders: Use framed avatars directly through PlaceholderAPI
Bust Avatar System
- Upper-Body Renders: Create Minecraft-style bust avatars using the player's skin
- Skin Layers: Supports head, body, arms and overlay layers for a more complete avatar look
- Multiple Bust Sizes: Choose between small, medium, normal, large and giant bust renders
- Important Note: Full bust placeholders are not recommended for scoreboards, TAB prefixes, nametags or team prefixes because they produce long text output
Skin System
- Automatic Skin Fetching: Player skins are fetched and converted into avatars automatically
- Join Preload: Skins can be cached when players join, making avatars load faster
- Persistent Cache: Uses a local SQLite database to store generated head and bust avatar data
- Smart Refresh: Cached skins can expire and refresh automatically based on your configuration
SkinsRestorer Integration
- Cracked Server Support: Works with SkinsRestorer to support offline/cracked player skins
- Live Skin Updates: When a player changes their skin, avatars can update automatically
- SkinApplyEvent Hook: Listens directly to SkinsRestorer skin changes for a smoother refresh system
Resource Pack System
- Custom Font Rendering: Avatars are displayed using a lightweight resource pack font
- Auto Integration: Automatically detects ItemsAdder or Nexo when installed
- Built-In Hosting: If no resource pack system is detected, SamsHead can use its own built-in pack server
- Automatic Pack Generation: Generates the required font files for Vanilla, ItemsAdder or Nexo setups
