*Real player skin rendered in chat — pixel-perfect, zero lag.*

🎯 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.

✨ 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

⚡ Performance

• Zero database — no SQL, no MongoDB
• Async skin download pipeline
• Disk-based skin cache
• Near-zero TPS impact

📜 Commands

Aliases: /awh · /wh · /welcomehead

🔑 Permissions

⚙️ Configuration

# ╔══════════════════════════════════════════╗
# ║          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

🔧 Installation

1. Download AsWelcomeHead.jar
2. Drop it into your /plugins folder
3. Restart your server
4. Edit plugins/AsWelcomeHead/config.yml
5. Run /awh reload — done! ✅

👨‍💻 Developer

ItzAzeem — Founder of AsDevs

Passionate Minecraft plugin developer building unique, high-quality tools for public and competitive SMP servers.

• 🌐 Portfolio: asdevs.netlify.app
• 💬 Discord: discord.gg/xRW5rdAvs5

🆘 Support

Having issues? Need help with config?

Join our Discord for fast support: 👉 discord.gg/xRW5rdAvs5

Please do not use Modrinth comments for bug reports — Discord is way faster!