JoinLeaveSound

插件

· 作者 Dalict

一个轻量级的 Bukkit/Paper 插件,在玩家加入或离开服务器时播放可自定义的音效,支持静音管理和冷却时间。

0 本站下载 0 关注 更新于 4 个月前

最新 1.1.0 · 26.2 · Bukkit / Paper

一键开服(送7天)

JoinLeaveSound - Minecraft 加入/离开服务器音效插件

简介

一款轻量级的 Bukkit/Spigot/Paper 插件,当有人加入或离开服务器时,向所有在线玩家播放可配置的音效。
代码仓库:


功能特性

  • 自定义加入/离开音效(支持调节音量和音调)
  • 基于权限组的音效系统(不同组别播放不同音效,按优先级匹配)
  • 新手首次加入专属音效(拥有独立的冷却时间)
  • 静音玩家管理 (/jls mute/unmute <player>,支持离线玩家)
  • 独立的冷却计时器(加入、离开、新手分别统计,防止因快速进出导致音效刷屏)
  • 热重载 (/jls reload)
  • 多语言支持 (lang/zh_CN.yml, lang/en_US.yml)
  • OP 豁免开关(OP 可以不被触发音效)
  • 调试模式(在控制台输出详细的匹配日志)
  • 独立存储文件 (muted-players.yml, groups.yml)
  • 纯 Bukkit API,零依赖

安装方法

  1. 将 JoinLeaveSound.jar 放入服务器的 plugins/ 文件夹中。
  2. 重启服务器或使用插件管理器加载该插件。
  3. 通过编辑 plugins/JoinLeaveSound/ 目录下的文件来自定义设置。

配置文件结构

文件 用途
config.yml 全局设置(冷却时间、语言、OP 豁免、调试模式)
groups.yml 权限组音效、默认音效、新手音效
lang/zh_CN.yml 简体中文消息
lang/en_US.yml 英文消息
muted-players.yml 被静音的玩家列表(由插件自动维护)

命令与权限

命令 别名 权限节点 描述
/joinleavesound reload /jls reload joinleavesound.reload 重新加载所有配置和消息
/joinleavesound mute <player> /jls mute <player> joinleavesound.mute 静音某玩家(支持离线状态)
/joinleavesound unmute <player> /jls unmute <player> joinleavesound.mute 取消对某玩家的静音

权限默认授予 OP。Tab 补全支持子命令和在线玩家名称。


权限组音效系统 (groups.yml)

匹配优先级(从高到低)

  1. 新手 (当 hasPlayedBefore() == false 且 newbie.enabled: true 时)
  2. 自定义组 (按照 groups 列表中从上到下的顺序,首个匹配成功即生效)
  3. 默认组 (当 enable-default: true 时使用)
  4. 无音效 (上述条件均未匹配时)

配置示例

# 启用默认组
enable-default: true
# 启用自定义组
enable-groups: true

# 新手首次加入音效
newbie:
  enabled: true
  join-sound:
    sound: BLOCK_NOTE_BLOCK_PLING
    volume: 1.0
    pitch: 2.0

# 默认组音效
default:
  join-sound:
    sound: BLOCK_NOTE_BLOCK_PLING
    volume: 1.0
    pitch: 1.0
  leave-sound:
    sound: BLOCK_NOTE_BLOCK_BASS
    volume: 1.0
    pitch: 1.0

# 自定义组(按优先级排序)
groups:
  admin:
    permission: "joinleavesound.group.admin"
    join-sound:
      sound: UI_TOAST_CHALLENGE_COMPLETE
      volume: 1.0
      pitch: 1.0
    leave-sound:
      sound: ENTITY_LIGHTNING_BOLT_THUNDER
      volume: 1.0
      pitch: 1.0

  vip:
    permission: "joinleavesound.group.vip"
    join-sound:
      sound: ENTITY_PLAYER_LEVELUP
      volume: 1.0
      pitch: 1.2
    leave-sound:
      sound: ENTITY_ENDERMAN_TELEPORT
      volume: 1.0
      pitch: 1.0

权限分配示例 (LuckPerms)

/lp user Dalict permission set joinleavesound.group.admin true
/lp group vip permission set joinleavesound.group.vip true

常见场景对照表

配置情况 无权限玩家 VIP Admin
开启默认组 + 有自定义组 默认音效 VIP 音效 Admin 音效
关闭默认组 + 有自定义组 无音效 VIP 音效 Admin 音效
开启默认组 + 空自定义组 默认音效 默认音效 默认音效

冷却系统

冷却类型

类型 配置路径 默认值 独立计时
普通加入 cooldown.join 10 秒 ✅
普通离开 cooldown.leave 10 秒 ✅
新手加入 cooldown.newbie 0 秒(已禁用) ✅

冷却行为说明

  • 冷却期间:后续相同事件不会播放音效,但会重置冷却计时器。
  • 冷却结束后:只有在距离上一次事件经过完整的冷却周期后,音效才能再次播放。
  • 设置为 0 或负数:表示禁用该类型的冷却。

示例(加入冷却为 10 秒)

  1. 玩家 A 加入 → 播放音效,开始倒计时。
  2. 5 秒后玩家 B 加入 → 不播放音效,冷却重置(从第 5 秒开始重新计算)。
  3. 再过 10 秒玩家 C 加入 → 播放音效。

全局配置 (config.yml)

# 冷却时间(秒),设为 0 或负数以禁用
cooldown:
  join: 10
  leave: 10
  newbie: 0

# 服务器语言 (zh_CN / en_US)
language: en_US

# OP 豁免:true = OP 永远不会触发音效
op-bypass: false

# 调试模式:在控制台记录详细的匹配信息
debug: false

多语言支持

插件自带 zh_CN(简体中文)和 en_US(英文)语言文件,位于 lang/ 目录下。

  • 修改 config.yml 中的 language 值并执行重载即可切换语言。
  • 如果缺少对应的语言文件,系统将自动回退使用 zh_CN。
  • 如需添加新语言,只需在 lang/ 文件夹中放置一个命名正确的 .yml 文件即可。

常见问题

Q: 我可以禁用冷却吗?
A: 可以。将相应的冷却值设置为 0 即可。

Q: 被静音的玩家会完全听不到声音吗?
A: 是的,被静音的玩家不会触发任何加入/离开音效,并且他们的操作也会跳过冷却计时。

Q: 我可以使用哪些音效名称?
A: 请参阅 Bukkit Sound 枚举。

问:这个插件会与其他插件冲突吗? 答:不会。它仅监听标准的加入/离开事件,且不修改任何游戏机制。轻量级且无依赖。

问:我可以添加无限数量的自定义组吗? 答:理论上可以,数百个组不会影响性能。匹配过程仅仅是带有哈希查找的简单列表迭代。

问:如果禁用了新人音效,新玩家会听到什么? 答:他们将遵循正常的组/默认匹配流程,就像普通玩家一样。

问:在 LuckPerms 中支持自定义权限节点的 Tab 补全吗? 答:不支持,首次输入时必须手动键入。之后,LuckPerms 会记住这些节点。

问:当大量玩家同时加入或离开时,声音会变得嘈杂吗? 答:不会,冷却系统会抑制过多的声音,保持服务器氛围优雅。


许可证

MIT 许可证

支持与反馈

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源