SharedCooldowns

插件

· 作者 Jnkyns

将命令分组并在它们之间强制执行共享冷却时间。

0 本站下载 0 关注 更新于 2 周前

最新 1.2.1 · 26.3 · Paper

一键开服(送7天)

SharedCooldowns

将命令分组,并为它们强制执行共享冷却时间。

一款轻量级的 Minecraft 插件,允许你定义共享单个冷却时间的命令组——支持条件触发、自定义动作以及完整的格式化控制。


功能特性

  • 在单个共享冷却时间下管理多个命令
  • 条件冷却时间 —— 仅当玩家实际传送时才开始计时
  • 冷却时间在服务器重启和 /scd reload 后保持持久
  • 冷却期间可执行自定义动作(操作栏、标题、音效、消息)
  • 完全可配置的时间格式和消息内容
  • 轻量且高效

安装方法

  1. 从 Releases 下载最新版本
  2. 将 .jar 文件放入服务器的 plugins/ 文件夹中
  3. 重启服务器
  4. 根据需要编辑 plugins/SharedCooldowns/config.yml

要求: Paper 26.3+、Java 25+


命令与权限

命令 权限 描述
/scd check sharedcooldowns.check (所有人) 显示你的活跃冷却时间
/scd check <player> sharedcooldowns.admin 显示在线玩家的活跃冷却时间
/scd reset <player> sharedcooldowns.admin 清除某在线玩家的所有冷却时间
/scd reload sharedcooldowns.admin 重新加载配置文件
/scd version sharedcooldowns.admin 显示插件版本

sharedcooldowns.bypass 可跳过所有冷却时间。

别名: /sharedcooldowns, /scd


配置说明

pending-timeout: 120   # 条件命令等待其传送生效的秒数
teleport-causes:       # 计入冷却时间的触发原因;末影珍珠、传送门等将被忽略
  - COMMAND
  - PLUGIN

时间:
  compact: "&b%days%&7d &b%hours%&7h &b%minutes%&7m &b%seconds%&7s"
  single: "&b%value% %unit%"
  units:
    day: "天"
    days: "天"
    hour: "小时"
    hours: "小时"
    minute: "分钟"
    minutes: "分钟"
    second: "秒"
    seconds: "秒"

冷却时间:
  传送:
    commands:
      - /spawn
      - /home
      - /tpa
    cooldown: 900        # 持续时间,单位为秒
    conditional: true    # 当玩家进行传送时开始冷却
    actions:
      - "[sound] block.note_block.pling 0.5 0.5"
      - "[actionbar] &e你必须在 %time_single% &e之后才能再次传送"

### 条件冷却

条件命令会等待最多 `pending-timeout` 秒以进行传送。第一次传送将启动冷却计时器。其他仍在等待的命令(例如稍后接受的 `/tpa`)将在冷却期间被阻止传送。

- 将 `pending-timeout`(等待超时时间)设置为高于最慢的传送操作的时间(对于 CMI:即 `/tpa` 接受时间 + 预热时间)。
- 如果命令执行失败(例如使用了错误的名字调用 `/home`),系统会一直等待直到超时。其他命令触发的、带有计数原因的传送可能会消耗这个等待状态,从而导致冷却计时开始或该传送被阻止一次。

- 如果另一个插件取消了该命令,则不会开始冷却时间。这包括运行多个命令的 CMI 自定义别名:请列出它们所运行的具体命令。

`/scd` 命令的所有消息均可在 `config.yml` 的 `messages:` 部分进行编辑。

### Actions

| 标签 | 格式 | 描述 |
|---|---|---|
| `[message]` | `[message] <文本>` | 发送一条聊天消息(默认) |
| `[actionbar]` | `[actionbar] <文本>` | 发送一条动作栏消息 |
| `[title]` | `[title] <标题>;<副标题>` | 发送一个标题 |
| `[sound]` | `[sound] <音效> <音量> <音调>` | 播放一个音效 |

### 占位符

| 占位符 | 示例 | 描述 |
|---|---|---|
| `%time_compact%` | `9d 5h 15m 30s` | 剩余时间,包含所有单位 |
| `%time_single%` | `9 days` | 剩余时间,仅最大单位 |
| `%player%` | `Steve` | 玩家的用户名 |
| `%command%` | `/spawn` | 执行的命令 |

---

## 构建

运行 `./gradlew build`。生成的 jar 文件位于 `build/libs/` 目录下。需要 JDK 25。

---

## 许可证

本项目采用 [MIT 许可证](LICENSE) 授权。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源