SamsCreations
SamsCreations

Getting Started

Learn how to install and configure SamsHead! :)

1 min readUpdated

Welcome to SamsHead! This guide will walk you through the installation process and initial configuration to get pixel-perfect player avatars working in-game.

Requirements

  • Java 21 or higher.
  • Paper 1.21+ (or derivatives like Purpur).
  • PlaceholderAPI (Highly recommended).

Installation

Download and Install

Place the SamsRank.jar file into your server's plugins/ folder.

Initial Startup

Start your server to generate the default configuration files.

ResourcePack Integration

SamsHead automatically detects your environment:

  • ItemsAdder/Nexo: Files are written directly to their respective content folders.
  • Vanilla: A built-in HTTP server starts on port 8765 to serve the pack.

Reload and Verify

Reload your resource pack. Use /sh reload to ensure everything is synced. You should see a success message in the console showing the number of cached skins.