ExtraGreetings

插件

· 作者 BloodRed

一款功能丰富的 Minecraft 服务器问候插件,支持自定义粒子效果、标题、副标题、动作栏、Boss 栏、聊天消息等。

0 本站下载 0 关注 更新于 1 年前

最新 1.5 · 1.21.8 · Folia / Paper

一键开服(送7天)

? 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

? 工作原理:

  1. 启动: 插件自动检查缺失的配置选项
  2. 更新: 添加带有默认值的新选项
  3. 清理: 移除过时的配置选项
  4. 保留: 保留所有自定义设置和注释

? 控制台消息:

[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 状态
  • 反馈提示:显示正在触发的问候类型
  • 错误处理:如果出现问题,提供清晰的错误消息

? 故障排除

常见问题

  1. 问候未显示:检查配置中是否启用了加入/退出事件
  2. 粒子未生成:验证粒子效果名称是否正确
  3. 音效未播放:检查音效名称和音量设置
  4. PlaceholderAPI 无法工作:确保已安装并加载了 PlaceholderAPI
  5. 配置未更新:使用 /extragreetings update 手动更新

调试模式

启用调试模式以查看详细日志:

settings:
  debug: true

或使用命令:/extragreetings debug on

? 迁移

从其他问候插件迁移

  1. 停止服务器
  2. 移除旧插件及其数据文件
  3. 安装 ExtraGreetings
  4. 按照本指南配置新插件
  5. 启动服务器

? 支持

  • Discord: 加入我们的 Discord

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源