? ExtraGreetings
一款功能丰富的 Minecraft 服务器欢迎插件,支持 Folia、Adventure API、MiniMessage,并针对 Minecraft 1.20.1+ 进行了优化。
✨ 特性
- ? 自定义加入问候 - 使用标题、副标题、动作栏、Boss 栏、粒子效果、音效和聊天消息来欢迎玩家
- ? 首次加入检测 - 为新老玩家提供不同的问候语
- ? VIP 支持 - 为拥有权限的 VIP 玩家提供特殊问候(现已包含退出消息!)
- ? 基于权限的退出消息 - 为 VIP 和普通玩家提供不同效果的退出消息
- ⚡ Folia 兼容性 - 完全支持 Folia 的调度器
- ? MiniMessage 支持 - 使用渐变、颜色和效果进行富文本格式化
- ? PlaceholderAPI 集成 - 支持自定义占位符
- ⏰ 冷却系统 - 通过可配置的冷却时间防止刷屏
- ? 命令执行 - 在加入/退出事件时运行命令
- ? 内置统计 - 追踪玩家加入情况和活跃功能
- ? 实时重载 - 无需重启即可重新加载配置
- ?️ 配置更新器 - 带备份系统的自动配置更新
- ? 增强版测试命令 - 实际触发问候语进行测试,而不仅仅是记录日志
? 要求
- Minecraft 1.20.1+
- Folia 或 Paper 服务器
- Java 17+
- 可选: PlaceholderAPI 用于额外的占位符
⚙️ 配置
插件会在 plugins/ExtraGreetings/config.yml 生成默认配置文件。示例如下:
# ExtraGreetings Configuration
settings:
enableJoin: true
enableQuit: true
cooldownSeconds: 60
debug: false
joinDelay: 1
join:
firstTime:
title: "<gradient:#FF55FF:#55FFFF>Welcome</gradient>"
subtitle: "<italic>%player% has joined for the first time!</italic>"
actionbar: "<rainbow>Enjoy your stay!</rainbow>"
bossbar:
enable: true
text: "Welcome, %player%!"
color: BLUE
style: SOLID
duration: 10
particles:
enable: true
effect: "HEART"
count: 50
offset: {x: 0.5, y: 1.0, z: 0.5}
speed: 0.1
sound:
enable: true
effect: "ENTITY_PLAYER_LEVELUP"
volume: 1.0
pitch: 1.0
message: "<bold><gold>[+]</bold> <white>%player%</white> joined for the first time!"
commands:
- "give %player% diamond 1"
- "broadcast &aWelcome new player %player%!"
recurring:
title: "<yellow>Welcome back!</yellow>"
subtitle: "<gray>Enjoy your stay!</gray>"
message: "<gray>[+]</gray> <white>%player%</white> returned!"
vip:
enable: true
title: "<gradient:#FFD700:#FFA500>VIP</gradient> <gold>Welcome!</gold>"
subtitle: "<yellow>%player% the VIP has joined!</yellow>"
# ... more VIP settings
quit:
# VIP quit greeting (for players with extragreetings.vip permission)
vip:
message: "<bold><gold>[VIP]</gold></bold> <yellow>%player%</yellow> has left the server!"
particles:
enable: true
effect: "DRAGON_BREATH"
count: 30
offset: {x: 0.5, y: 1.0, z: 0.5}
speed: 0.15
sound:
enable: true
effect: "ENTITY_ENDER_DRAGON_FLAP"
volume: 1.0
pitch: 1.2
commands:
- "say VIP %player% has left the server!"
# Regular quit greeting
regular:
message: "<gray>[-]</gray> <white>%player%</white> left the server."
particles:
enable: true
effect: "SMOKE_NORMAL"
count: 20
offset: {x: 0.0, y: 0.5, z: 0.0}
speed: 0.1
sound:
enable: true
effect: "ENTITY_HORSE_SADDLE"
volume: 0.8
pitch: 1.0
commands: []
? 命令
| 命令 |
描述 |
权限 |
/extragreetings |
显示帮助菜单 |
extragreetings.admin |
/extragreetings reload |
重新加载配置 |
extragreetings.admin |
/extragreetings info |
显示插件信息 |
extragreetings.admin |
/extragreetings stats |
显示插件统计信息 |
extragreetings.admin |
/extragreetings debug [on/off] |
切换调试模式 |
extragreetings.admin |
/extragreetings reset [data/cooldowns] |
重置插件数据 |
extragreetings.admin |
/extragreetings test [join/quit] |
测试问候语(实际触发它们!) |
extragreetings.admin |
/extragreetings update |
将配置更新到最新版本 |
extragreetings.admin |
别名: /eg
? 权限
| 权限 |
描述 |
默认值 |
extragreetings.admin |
访问管理命令 |
op |
extragreetings.vip |
接收 VIP 问候语(加入和退出) |
false |
extragreetings.bypass.cooldown |
绕过问候语冷却时间 |
op |
?️ 配置更新器
✨ 特性:
- 自动更新: 在插件启动时更新配置
- 注释保留: 保留所有配置注释
- 备份系统: 在更改前创建带时间戳的备份
- 手动更新: 使用
/extragreetings update 强制更新
- 验证: 检查无效的音效/粒子效果
? 备份位置:
备份存储在 /plugins/ExtraGreetings/backups/config.yml.timestamp.bak
? 工作原理:
- 启动: 插件自动检查缺失的配置选项
- 更新: 添加带有默认值的新选项
- 清理: 移除过时的配置选项
- 保留: 保留所有自定义设置和注释
? 控制台消息:
[ExtraGreetings] Added missing config option: quit.vip.message
[ExtraGreetings] Configuration updated successfully!
[ExtraGreetings] Config backed up to: config.yml.1234567890.bak
? MiniMessage 格式化
ExtraGreetings 支持完整的 MiniMessage 格式化:
title: "<gradient:#FF55FF:#55FFFF>欢迎</gradient>"
subtitle: "<italic><yellow>%player%</yellow> 已加入!</italic>"
actionbar: "<rainbow>祝您停留愉快!</rainbow>"
message: "<bold><gold>[+]</gold></bold> <white>%player%</white> 加入了服务器!"
可用标签:
<bold>、<italic>、<underlined>、<strikethrough>
<color:#hex>、<red>、<green>、<blue> 等
<gradient:#start:#end>、<rainbow>
<click:run_command:/command>、<hover:show_text:text>
?️ 占位符
内置占位符
%player% - 玩家名称
%player_displayname% - 玩家显示名称
%player_uuid% - 玩家 UUID
%online_players% - 在线玩家数量
%max_players% - 最大玩家数
%server_name% - 服务器名称
%current_time% - 当前时间
%server_uptime% - 服务器运行时长
%plugin_version% - 插件版本
PlaceholderAPI 支持
安装 PlaceholderAPI 后,您可以使用任何可用的占位符:
%player_level% - 玩家等级
%vault_eco_balance% - 玩家余额
%luckperms_prefix% - 玩家前缀
- 以及更多!
? 粒子效果
支持的粒子效果包括:
HEART(爱心)、VILLAGER_HAPPY(村民喜悦)、FLAME(火焰)、SMOKE_NORMAL(普通烟雾)
EXPLOSION_LARGE(大型爆炸)、FIREWORKS_SPARK(烟花火花)、ENCHANTMENT_TABLE(附魔台)
SNOWFLAKE(雪花)、WATER_BUBBLE(水泡)、REDSTONE(红石)
- 新增:
DRAGON_BREATH(龙息,用于 VIP 退出问候)
- 以及所有其他 Bukkit 粒子类型
? 音效
支持的音效包括:
ENTITY_PLAYER_LEVELUP(玩家升级)、ENTITY_EXPERIENCE_ORB_PICKUP(经验球拾取)
ENTITY_ENDER_DRAGON_GROWL(末影龙咆哮)、ENTITY_HORSE_SADDLE(马鞍放置)
BLOCK_ANVIL_USE(铁砧使用)、ENTITY_FIREWORK_ROCKET_LAUNCH(烟花火箭发射)
- 新增:
ENTITY_ENDER_DRAGON_FLAP(末影龙扇动翅膀,用于 VIP 退出问候)
- 以及所有其他 Bukkit 音效类型
? Boss Bar 配置
bossbar:
enable: true
text: "欢迎, %player%!"
color: BLUE # BLUE, RED, GREEN, YELLOW, PURPLE, PINK, WHITE
style: SOLID # SOLID, SEGMENTED_6, SEGMENTED_10, SEGMENTED_12, SEGMENTED_20
duration: 10 # 持续时间(秒)
? 高级配置
自定义命令
当玩家加入或离开时执行命令:
commands:
- "give %player% diamond 1"
- "broadcast &a欢迎 %player%!"
- "tp %player% spawn"
VIP 配置
为 VIP 玩家提供特殊问候语(包含加入和退出):
vip:
enable: true
title: "<gradient:#FFD700:#FFA500>VIP</gradient> <gold>欢迎!</gold>"
# 玩家需要 extragreetings.vip 权限
基于权限的退出消息
根据权限显示不同的退出消息:
- VIP 玩家 (
extragreetings.vip):带有龙粒子的特殊退出效果
- 普通玩家:标准退出消息
冷却系统
防止问候刷屏:
settings:
cooldownSeconds: 60 # 冷却时间(秒)
joinDelay: 1 # 显示问候前的延迟时间
? 统计信息
使用 /extragreetings stats 查看:
- 总加入玩家数
- 活跃的冷却状态
- 活跃的 Boss Bar
- 插件状态
? 测试系统
使用方法:
/extragreetings test join - 测试加入问候(显示实际效果!)
/extragreetings test quit - 测试退出问候(显示实际效果!)
功能特性:
- 真实触发:显示真实的问候效果,而不仅仅是记录日志
- 权限检测:自动检测 VIP 状态
- 反馈提示:显示正在触发的问候类型
- 错误处理:如果出现问题,提供清晰的错误消息
? 故障排除
常见问题
- 问候未显示:检查配置中是否启用了加入/退出事件
- 粒子未生成:验证粒子效果名称是否正确
- 音效未播放:检查音效名称和音量设置
- PlaceholderAPI 无法工作:确保已安装并加载了 PlaceholderAPI
- 配置未更新:使用
/extragreetings update 手动更新
调试模式
启用调试模式以查看详细日志:
settings:
debug: true
或使用命令:/extragreetings debug on
? 迁移
从其他问候插件迁移
- 停止服务器
- 移除旧插件及其数据文件
- 安装 ExtraGreetings
- 按照本指南配置新插件
- 启动服务器
? 支持
? ExtraGreetings
A feature-rich greeting plugin for Minecraft servers with Folia support, Adventure API, MiniMessage, and optimized for Minecraft 1.20.1+.
✨ Features
- ? Customizable Join Greetings - Welcome players with titles, subtitles, action bars, boss bars, particles, sounds, and chat messages
- ? First-Time Join Detection - Different greetings for new players vs returning players
- ? VIP Support - Special greetings for VIP players with permissions (now includes quit messages!)
- ? Permission-Based Quit Messages - VIP and regular quit messages with different effects
- ⚡ Folia Compatibility - Full support for Folia's scheduler
- ? MiniMessage Support - Rich text formatting with gradients, colors, and effects
- ? PlaceholderAPI Integration - Support for custom placeholders
- ⏰ Cooldown System - Prevent spam with configurable cooldowns
- ? Command Execution - Run commands on join/quit events
- ? Built-in Statistics - Track player joins and active features
- ? Live Reload - Reload configuration without restarting
- ?️ Config Updater - Automatic configuration updates with backup system
- ? Enhanced Test Command - Actually test greetings instead of just logging
? Requirements
- Minecraft 1.20.1+
- Folia or Paper server
- Java 17+
- Optional: PlaceholderAPI for additional placeholders
⚙️ Configuration
The plugin generates a default configuration file at plugins/ExtraGreetings/config.yml. Here's an example:
# ExtraGreetings Configuration
settings:
enableJoin: true
enableQuit: true
cooldownSeconds: 60
debug: false
joinDelay: 1
join:
firstTime:
title: "<gradient:#FF55FF:#55FFFF>Welcome</gradient>"
subtitle: "<italic>%player% has joined for the first time!</italic>"
actionbar: "<rainbow>Enjoy your stay!</rainbow>"
bossbar:
enable: true
text: "Welcome, %player%!"
color: BLUE
style: SOLID
duration: 10
particles:
enable: true
effect: "HEART"
count: 50
offset: {x: 0.5, y: 1.0, z: 0.5}
speed: 0.1
sound:
enable: true
effect: "ENTITY_PLAYER_LEVELUP"
volume: 1.0
pitch: 1.0
message: "<bold><gold>[+]</bold> <white>%player%</white> joined for the first time!"
commands:
- "give %player% diamond 1"
- "broadcast &aWelcome new player %player%!"
recurring:
title: "<yellow>Welcome back!</yellow>"
subtitle: "<gray>Enjoy your stay!</gray>"
message: "<gray>[+]</gray> <white>%player%</white> returned!"
vip:
enable: true
title: "<gradient:#FFD700:#FFA500>VIP</gradient> <gold>Welcome!</gold>"
subtitle: "<yellow>%player% the VIP has joined!</yellow>"
# ... more VIP settings
quit:
# VIP quit greeting (for players with extragreetings.vip permission)
vip:
message: "<bold><gold>[VIP]</gold></bold> <yellow>%player%</yellow> has left the server!"
particles:
enable: true
effect: "DRAGON_BREATH"
count: 30
offset: {x: 0.5, y: 1.0, z: 0.5}
speed: 0.15
sound:
enable: true
effect: "ENTITY_ENDER_DRAGON_FLAP"
volume: 1.0
pitch: 1.2
commands:
- "say VIP %player% has left the server!"
# Regular quit greeting
regular:
message: "<gray>[-]</gray> <white>%player%</white> left the server."
particles:
enable: true
effect: "SMOKE_NORMAL"
count: 20
offset: {x: 0.0, y: 0.5, z: 0.0}
speed: 0.1
sound:
enable: true
effect: "ENTITY_HORSE_SADDLE"
volume: 0.8
pitch: 1.0
commands: []
? Commands
| Command |
Description |
Permission |
/extragreetings |
Show help menu |
extragreetings.admin |
/extragreetings reload |
Reload configuration |
extragreetings.admin |
/extragreetings info |
Show plugin information |
extragreetings.admin |
/extragreetings stats |
Show plugin statistics |
extragreetings.admin |
/extragreetings debug [on/off] |
Toggle debug mode |
extragreetings.admin |
/extragreetings reset [data/cooldowns] |
Reset plugin data |
extragreetings.admin |
/extragreetings test [join/quit] |
Test greetings (actually triggers them!) |
extragreetings.admin |
/extragreetings update |
Update configuration to latest version |
extragreetings.admin |
Aliases: /eg
? Permissions
| Permission |
Description |
Default |
extragreetings.admin |
Access to admin commands |
op |
extragreetings.vip |
Receive VIP greetings (join AND quit) |
false |
extragreetings.bypass.cooldown |
Bypass greeting cooldown |
op |
?️ Configuration Updater
✨ Features:
- Automatic Updates: Updates configuration on plugin startup
- Comment Preservation: Maintains all your configuration comments
- Backup System: Creates timestamped backups before changes
- Manual Updates: Use
/extragreetings update to force updates
- Validation: Checks for invalid sound/particle effects
? Backup Location:
Backups are stored in /plugins/ExtraGreetings/backups/config.yml.timestamp.bak
? How It Works:
- Startup: Plugin automatically checks for missing config options
- Updates: Adds new options with default values
- Cleanup: Removes obsolete configuration options
- Preservation: Keeps all your custom settings and comments
? Console Messages:
[ExtraGreetings] Added missing config option: quit.vip.message
[ExtraGreetings] Configuration updated successfully!
[ExtraGreetings] Config backed up to: config.yml.1234567890.bak
? MiniMessage Formatting
ExtraGreetings supports full MiniMessage formatting:
title: "<gradient:#FF55FF:#55FFFF>Welcome</gradient>"
subtitle: "<italic><yellow>%player%</yellow> has joined!</italic>"
actionbar: "<rainbow>Enjoy your stay!</rainbow>"
message: "<bold><gold>[+]</gold></bold> <white>%player%</white> joined!"
Available Tags:
<bold>, <italic>, <underlined>, <strikethrough>
<color:#hex>, <red>, <green>, <blue>, etc.
<gradient:#start:#end>, <rainbow>
<click:run_command:/command>, <hover:show_text:text>
?️ Placeholders
Built-in Placeholders
%player% - Player name
%player_displayname% - Player display name
%player_uuid% - Player UUID
%online_players% - Online player count
%max_players% - Maximum players
%server_name% - Server name
%current_time% - Current time
%server_uptime% - Server uptime
%plugin_version% - Plugin version
PlaceholderAPI Support
When PlaceholderAPI is installed, you can use any available placeholder:
%player_level% - Player level
%vault_eco_balance% - Player balance
%luckperms_prefix% - Player prefix
- And many more!
? Particle Effects
Supported particle effects include:
HEART, VILLAGER_HAPPY, FLAME, SMOKE_NORMAL
EXPLOSION_LARGE, FIREWORKS_SPARK, ENCHANTMENT_TABLE
SNOWFLAKE, WATER_BUBBLE, REDSTONE
- NEW:
DRAGON_BREATH (used in VIP quit greetings)
- And all other Bukkit particle types
? Sound Effects
Supported sound effects include:
ENTITY_PLAYER_LEVELUP, ENTITY_EXPERIENCE_ORB_PICKUP
ENTITY_ENDER_DRAGON_GROWL, ENTITY_HORSE_SADDLE
BLOCK_ANVIL_USE, ENTITY_FIREWORK_ROCKET_LAUNCH
- NEW:
ENTITY_ENDER_DRAGON_FLAP (used in VIP quit greetings)
- And all other Bukkit sound types
? Boss Bar Configuration
bossbar:
enable: true
text: "Welcome, %player%!"
color: BLUE # BLUE, RED, GREEN, YELLOW, PURPLE, PINK, WHITE
style: SOLID # SOLID, SEGMENTED_6, SEGMENTED_10, SEGMENTED_12, SEGMENTED_20
duration: 10 # Duration in seconds
? Advanced Configuration
Custom Commands
Execute commands when players join or quit:
commands:
- "give %player% diamond 1"
- "broadcast &aWelcome %player%!"
- "tp %player% spawn"
VIP Configuration
Special greetings for VIP players (both join AND quit):
vip:
enable: true
title: "<gradient:#FFD700:#FFA500>VIP</gradient> <gold>Welcome!</gold>"
# Players need extragreetings.vip permission
Permission-Based Quit Messages
Different quit messages based on permissions:
- VIP Players (
extragreetings.vip): Special quit effects with dragon particles
- Regular Players: Standard quit messages
Cooldown System
Prevent greeting spam:
settings:
cooldownSeconds: 60 # Cooldown in seconds
joinDelay: 1 # Delay before showing greeting
? Statistics
Use /extragreetings stats to view:
- Total players who have joined
- Active cooldowns
- Active boss bars
- Plugin status
? Testing System
Usage:
/extragreetings test join - Tests join greetings (shows actual effects!)
/extragreetings test quit - Tests quit greetings (shows actual effects!)
Features:
- Actual Triggering: Shows real greetings instead of just logging
- Permission Detection: Automatically detects VIP status
- Feedback: Shows which type of greeting is being triggered
- Error Handling: Provides clear error messages if something fails
? Troubleshooting
Common Issues
- Greetings not showing: Check if join/quit events are enabled in config
- Particles not spawning: Verify particle effect names are correct
- Sounds not playing: Check sound effect names and volume settings
- PlaceholderAPI not working: Make sure PlaceholderAPI is installed and loaded
- Config not updating: Use
/extragreetings update to manually update
Debug Mode
Enable debug mode to see detailed logging:
settings:
debug: true
Or use the command: /extragreetings debug on
? Migration
From Other Greeting Plugins
- Stop your server
- Remove the old plugin and its data files
- Install ExtraGreetings
- Configure the new plugin using this guide
- Start your server
? Support
- Discord: Join our Discord
评论 0
登录后参与评分
还没有评论,来抢沙发吧