? AsWelcomeHead
动态玩家头像与欢迎消息系统
由 ItzAzeem | AsDevs 制作

*聊天中渲染的真实玩家皮肤——像素级精准,零延迟。*
? 什么是 AsWelcomeHead?
AsWelcomeHead 是一个专为公共 Minecraft 服务器打造的轻量级、电影感欢迎系统。当玩家加入时,系统会自动获取他们的真实皮肤,将其渲染为聊天中的像素艺术头像,并显示完全自定义的欢迎消息——就像你在 YouTube 上看到的那些大型服务器一样!
无需数据库。无需复杂设置。只需将 JAR 文件放入文件夹即可运行。
✨ 功能特性
? 实时玩家头像渲染
- 加入时自动获取玩家的真实 Mojang 皮肤
- 直接以彩色方块字符(█)在聊天中渲染
- 异步获取——主线程零延迟
- 首次下载后将皮肤缓存到磁盘——后续加入即时显示
- 如果皮肤 API 不可用,则使用默认头像作为后备
? 完全可定制的欢迎消息
- 在玩家头像旁显示最多 8 行自定义文本
- 支持完整的 hex 颜色代码
&#FF5500 + 经典 &c 颜色代码
- 分别设置首次加入和回归玩家的消息
- 提供文本居中选项以实现完美对齐
? 首次加入庆祝
- 在玩家出生地点绽放烟花
- 数量可配置——设置为
0 可禁用
- 独特的首次加入消息,让新玩家倍感特别
? 自定义音效
- 加入时播放任意 Bukkit 音效
- 区分首次加入与回归玩家的音效
- 可配置音量和音高
? 占位符支持
| 占位符 |
输出内容 |
%player_name% |
玩家用户名 |
%server_name% |
配置文件中设置的服务器名称 |
| 所有 PAPI 占位符 |
通过 PlaceholderAPI 支持 |
⚡ 性能优化
- 零数据库——无 SQL,无 MongoDB
- 异步皮肤下载流水线
- 基于磁盘的皮肤缓存
- 对 TPS 影响近乎为零
? 命令
| 命令 |
描述 |
权限 |
/awh reload |
重载配置而无需重启服务器 |
aswelcomehead.reload |
/awh preview |
实时预览你的欢迎消息 |
aswelcomehead.preview |
/awh version |
显示插件版本 |
(所有人) |
别名: /awh · /wh · /welcomehead
? 权限
| 权限 |
描述 |
默认值 |
aswelcomehead.reload |
重载配置 |
op |
aswelcomehead.preview |
预览欢迎消息 |
op |
aswelcomehead.* |
所有权限 |
op |
⚙️ 配置
# ╔══════════════════════════════════════════╗
# ║ AsWelcomeHead Config ║
# ║ Made by ItzAzeem | v1.0.0 ║
# ╚══════════════════════════════════════════╝
# 你的服务器名称 —— 可与 %server_name% 配合使用
server-name: "Your SMP Name Here"
# 头像渲染字符:BLOCK (█) DARK_SHADE (▓) MEDIUM_SHADE (▒) LIGHT_SHADE (░)
image-char: BLOCK
# 消息前后空白行数(仅针对该玩家)
Spaces-Top: 2
Spaces-Bot: 0
# 显示消息前的延迟时间(秒)
Timer: 3
# ── 回归玩家 ──────────────────────
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"
# ── 首次加入 ─────────────────────────────
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"
# ── 音效 ─────────────────────────────────
SoundB:
enable: true
sound: ENTITY_VILLAGER_CELEBRATE
volume: 1.0
pitch: 1.0
# ── 烟花(仅限首次加入) ────────────
Firework:
amount: 5
?️ 兼容性
| 软件 |
支持情况 |
| Paper 1.20 — 1.21 |
✅ |
| Spigot 1.20 — 1.21 |
✅ |
| Purpur 1.20 — 1.21 |
✅ |
| Java 17+ |
✅ |
| PlaceholderAPI |
✅ 可选 |
? 安装指南
- 下载
AsWelcomeHead.jar
- 将其放入你的
/plugins 文件夹
- 重启服务器
- 编辑
plugins/AsWelcomeHead/config.yml
- 运行
/awh reload —— 完成! ✅
?? 开发者
ItzAzeem —— AsDevs 创始人
热衷于 Minecraft 插件开发,为公共和竞技 SMP 服务器构建独特、高质量的工具。
? 技术支持
遇到问题?需要帮助配置?
加入我们的 Discord 获取快速支持:
? discord.gg/xRW5rdAvs5
请不要在 Modrinth 评论区提交 bug 报告——Discord 的速度要快得多!
由 ItzAzeem | AsDevs 用 ❤️ 制作
喜欢 AsWelcomeHead 吗?请在 Modrinth 上留下 ⭐ 评论——这真的很有帮助!
? AsWelcomeHead
Animated Player Head & Welcome Message System
by ItzAzeem | AsDevs

*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
| 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
# ╔══════════════════════════════════════════╗
# ║ 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
- Download
AsWelcomeHead.jar
- Drop it into your
/plugins folder
- Restart your server
- Edit
plugins/AsWelcomeHead/config.yml
- Run
/awh reload — done! ✅
?? Developer
ItzAzeem — Founder of AsDevs
Passionate Minecraft plugin developer building unique, high-quality tools for public and competitive SMP servers.
? 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!
Made with ❤️ by ItzAzeem | AsDevs
Enjoying AsWelcomeHead? Please leave a ⭐ review on Modrinth — it really helps!
评论 0
登录后参与评分
还没有评论,来抢沙发吧