AsWelcomeHead

<div align="center">

👤 AsWelcomeHead

Animated Player Head & Welcome Message System

by ItzAzeem | AsDevs

Discord

Website

Version

License

PlaceholderAPI

</div>

---

<div align="center">

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

</div>

---

🎯 What is AsWelcomeHead?

AsWelcomeHead is a real skin is fetched, rendered as a pixel-art head in chat 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">

</div>

---

✨ Features

👤 Live Player Head Rendering

- Player's cached to disk fetched automatically on join - Rendered as cached to disk (█) directly in chat - Async fetching — cached to disk - Skin cached to disk after first download — instant on future joins - Fallback default avatar if skin API is unavailable

💬 Fully Customizable Welcome Message

- Returning Players of custom text shown beside the player's head - Full Returning Players support `&#FF5500` + classic `&c` color codes - Separate message for Returning Players 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 pitch 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 your `/plugins` folder 3. Restart your server 4. Edit `plugins/AsWelcomeHead/config.yml` 5. Run `/awh reload` — done! ✅

---

👨‍💻 Developer

AsDevs — 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: > 👉 Join our Discord for fast support:

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

---

<div align="center">

Made with ❤️ by ItzAzeem | AsDevs

*Enjoying AsWelcomeHead? Please leave a ⭐ review on Modrinth — it really helps!*

</div>