AsWelcomeHead

<div align="center"> # 👤 AsWelcomeHead ### Animated Player Head & Welcome Message System **by ItzAzeem | AsDevs** (https://img.shields.io/badge/Discord-Join%20Us-5865F2?logo=discord&logoColor=white)](https://discord.gg/xRW5rdAvs5) (https://img.shields.io/badge/Website-asdevs.netlify.app-orange)](https://asdevs.netlify.app/) (https://img.shields.io/badge/MC-1.20--1.21-brightgreen)](https://modrinth.com) (https://img.shields.io/badge/License-MIT-blue)](https://modrinth.com) (https://img.shields.io/badge/PlaceholderAPI-Supported-yellow)](https://www.spigotmc.org/resources/placeholderapi.6245/) </div> --- <div align="center"> !(https://cdn.modrinth.com/data/cached_images/9f4160f307e46b056debd4a57fd1a0aa05db6b18.jpeg) *Real player skin rendered in chat — pixel-perfect, zero lag.* </div> --- ## 🎯 What is AsWelcomeHead? AsWelcomeHead is a **lightweight, cinematic welcome system** for public Minecraft servers. The moment a player joins, their **real skin is fetched, rendered as a pixel-art head in chat**, and displayed alongside a fully customizable welcome message — just like the big servers you see on YouTube! No databases. No complicated setup. Just drop the JAR in and go. --- <div align="center"> !(screenshot2.png) </div> --- ## ✨ Features ### 👤 Live Player Head Rendering - Player's **real Mojang skin** fetched automatically on join - Rendered as **colored block characters** (█) directly in chat - Async fetching — **zero main thread lag** - Skin **cached to disk** after first download — instant on future joins - Fallback default avatar if skin API is unavailable ### 💬 Fully Customizable Welcome Message - **8 lines** of custom text shown beside the player's head - Full **hex color** support `&#FF5500` + classic `&c` color codes - Separate message for **First Join** and **Returning Players** - Center text option for perfect alignment ### 🎉 First Join Celebration - **Fireworks** burst at player spawn location - Configurable amount — set `0` to disable - Unique first-join message to make new players feel special ### 🔊 Custom Sounds - Play any Bukkit sound on join - Separate sound for first join vs returning players - Configurable **volume** and **pitch** ### 📝 Placeholder Support | Placeholder | Output | |---|---| | `%player_name%` | Player's username | | `%server_name%` | Your server name from config | | *All PAPI placeholders* | Supported via PlaceholderAPI | ### ⚡ Performance - Zero database — no SQL, no MongoDB - Async skin download pipeline - Disk-based skin cache - Near-zero TPS impact --- ## 📜 Commands | Command | Description | Permission | |---|---|---| | `/awh reload` | Reload config without restart | `aswelcomehead.reload` | | `/awh preview` | Preview your welcome message live | `aswelcomehead.preview` | | `/awh version` | Show plugin version | *(everyone)* | **Aliases:** `/awh` · `/wh` · `/welcomehead` --- ## 🔑 Permissions | Permission | Description | Default | |---|---|---| | `aswelcomehead.reload` | Reload config | `op` | | `aswelcomehead.preview` | Preview welcome message | `op` | | `aswelcomehead.*` | All permissions | `op` | --- ## ⚙️ Configuration ```yaml # ╔══════════════════════════════════════════╗ # ║ AsWelcomeHead Config ║ # ║ Made by ItzAzeem | v1.0.0 ║ # ╚══════════════════════════════════════════╝ # Your server name — use with %server_name% server-name: "Your SMP Name Here" # Head render character: BLOCK (█) DARK_SHADE (▓) MEDIUM_SHADE (▒) LIGHT_SHADE (░) image-char: BLOCK # Blank lines before/after message (for that player only) Spaces-Top: 2 Spaces-Bot: 0 # Delay before showing message (seconds) Timer: 3 # ── Returning Players ────────────────────── Players-Back: enable: true show-head: true center: false head-text: 1: "" 2: " &4&lWELCOME TO &c&l%server_name%&4&l!" 3: "" 4: " &fWelcome &b%player_name%&f!" 5: " &7Here are some useful commands!" 6: "" 7: " &7Find updates in our &b/discord" 8: " &7Support the server by doing &6/store" # ── First Join ───────────────────────────── Players-FirstJoin: enable: true show-head: true head-text: 2: " &4&lWELCOME TO &c&l%server_name%&4&l!" 4: " &fWelcome &b%player_name%&f!" 5: " &aYou are joining for the &lfirst time&a!" 7: " &7Find updates in our &b/discord" 8: " &7Support the server by doing &6/store" # ── Sounds ───────────────────────────────── SoundB: enable: true sound: ENTITY_VILLAGER_CELEBRATE volume: 1.0 pitch: 1.0 # ── Fireworks (first join only) ──────────── Firework: amount: 5 ``` --- ## 🖥️ Compatibility | Software | Supported | |---|---| | Paper 1.20 — 1.21 | ✅ | | Spigot 1.20 — 1.21 | ✅ | | Purpur 1.20 — 1.21 | ✅ | | Java 17+ | ✅ | | PlaceholderAPI | ✅ Optional | --- ## 🔧 Installation 1. Download `AsWelcomeHead.jar` 2. Drop it into yo