Sam's Head | Custom Head Display System v2.0.0

• 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