SimpleCommands

插件

· 作者 Dominos111G

SimpleCommands 允许服务器管理员在简单的配置文件(或游戏内实时)中定义自定义命令。每个自定义命令可以以玩家或控制台的身份运行一个或多个真实命令,支持冷却时间、权限、别名、占位符等功能。

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

最新 1.0.3 · 1.21.8 · Paper / Purpur

一键开服(送7天)

注意: 此描述由 AI 生成,欢迎提供您的建议!

⚡ SimpleCommands

无需编写代码即可创建自定义命令 —— 适用于 Paper Minecraft 1.20+ 服务器

SimpleCommands 允许服务器管理员在简单的配置文件(或游戏内实时)中定义自定义命令。每个自定义命令会按顺序执行一个或多个真实命令——可以是作为 玩家 或作为 控制台 执行——并支持冷却时间、权限、别名、占位符以及可选的时间窗口。玩家输入 /spawn,而不是 /sc spawn:命令直接注册到服务器中,表现如同原生命令。

✨ 主要功能

?️ 无需代码的自定义命令

  • 在 YAML 文件或游戏内定义 /spawn、/discord、/shop 等更多命令
  • 每个命令按顺序执行一组真实命令
  • 无需 Java,无需重新编译——只需编辑并运行 /sc reload

? 以玩家或控制台身份运行

  • PLAYER(玩家) → 使用玩家自身的权限运行
  • CONSOLE(控制台) → 拥有完全权限(传送、给予物品等)
  • 非常适合让玩家安全地触发仅限管理员的操作

⏱️ 持久化冷却时间

  • 每个命令针对每个玩家的独立冷却时间
  • 保存至磁盘 —— 即使玩家注销或服务器重启也不会丢失
  • 工作人员可绕过此限制(权限 simplecommands.cooldown.bypass)

? 灵活的权限设置

  • EVERYONE → 对所有人开放
  • OP → 仅限操作员
  • PERMISSION → 自定义节点,完全兼容 LuckPerms

? 占位符

  • {player}、{uuid}、{world}、{x}、{y}、{z}
  • 可扩展架构——在不修改现有代码的情况下添加新占位符

? 限时命令

  • 可选的 available-from / available-until 时间窗口
  • 非常适合活动、促销和限时奖励

? 代理支持 (Velocity / BungeeCord)

  • 通过 [server] <name> 动作标签在不同服务器间移动玩家
  • 在普通代理命令 (/server) 无法工作的场景下生效——通过插件消息发送

? 音效效果

  • 在命令执行 之前 和 之后 播放声音
  • 使用 Bukkit 声音名称 (ENTITY_ENDERMAN_TELEPORT) 或命名空间键 (minecraft:entity.player.levelup)
  • 无效的声音名称会被安全跳过——不会崩溃,仅在控制台中显示警告

⏳ 带动作栏倒计时的延迟

  • 命令执行前可选的延迟时间(例如:传送前等待 3 秒)
  • 动作栏倒计时 —— 显示剩余时间(可使用 {time} 和 {total} 自定义文本)
  • 冻结模式 —— 在延迟期间可选择阻止玩家移动(行走、跳跃)
  • 头部旋转仍被允许,玩家只是无法走开

? 命名参数

  • 使用单个命令条目定义 /warp spawn、/warp shop、/warp nether
  • 每个参数映射到其各自的命令列表
  • /warp(无参数)运行默认的 commands 列表(例如:用法提示)
  • Tab 补全 自动建议可用的参数名称
  • 游戏内可编辑:/sc edit warp addarg mine tp {player} 100 64 200

?️ 防循环执行

  • 检测到直接或间接调用自身的命令时会中止执行
  • 不会出现 StackOverflowError,也不会因配置错误的命令导致服务器崩溃

♻️ 热重载与翻译

  • /sc reload 应用更改而无需重启服务器
  • 所有消息均位于 lang.yml 中——完全支持翻译

? 安装

  1. 从 GitHub 或 Modrinth 下载 .jar 文件
  2. 放入 plugins/ 文件夹
  3. 重启服务器
  4. 编辑 plugins/SimpleCommands/commands.yml(自动生成)
  5. 运行 /sc reload

要求: Paper(或其分支)1.20.x–1.21.x,Java 21。可选: LuckPerms。

? 玩家命令

/spawn          # 或者你在 commands.yml 中定义的任意命令

玩家只需输入你创建的命令名称及其别名。

? 管理员命令

/sc create <name> <command...>      # 创建新命令
/sc delete <name>                   # 删除命令
/sc edit <name> <field> <value...>  # 编辑单个字段
/sc list                            # 列出所有命令及其状态
/sc info <name>                     # 显示命令的完整详情
/sc reload                          # 重载配置 + 命令

/simplecommands 和 /sc 可以互换使用。

? 权限

权限 默认值 描述
simplecommands.admin op 所有管理员命令
simplecommands.admin.create op /sc create
simplecommands.admin.delete op /sc delete
simplecommands.admin.edit op /sc edit
simplecommands.admin.list op /sc list
simplecommands.admin.info op /sc info
simplecommands.admin.reload op /sc reload
simplecommands.cooldown.bypass op 忽略自定义命令的冷却时间

使用 permission-mode: PERMISSION 的自定义命令需要在其 permission 字段中设置的相应节点(例如 simplecommands.cmd.spawn)。

示例:LuckPerms

/lp user <player> permission set simplecommands.cmd.spawn true
/lp group admin permission set simplecommands.admin true

⚙️ 配置

SimpleCommands 将配置拆分为多个专注的文件:

文件 用途
config.yml 插件常规设置
lang.yml 所有插件消息(可翻译)
commands.yml 你的自定义命令定义
cooldowns.yml 已保存的冷却时间(自动生成)

命令定义

commands:
  spawn:
    enabled: true
    description: "Teleport to spawn."
    permission-mode: PERMISSION
    permission: simplecommands.cmd.spawn
    aliases:
      - lobby
      - hub
    cooldown: 5
    execute-as: CONSOLE
    commands:
      - "tp {player} 0 78 0"
    message: "&aTeleported to spawn."

字段参考

字段 描述
enabled true/false。禁用的命令仍会注册,但拒绝执行
description 在 /sc list 和 /sc info 中显示
permission-mode EVERYONE、OP 或 PERMISSION
permission 当模式为 PERMISSION 时检查的权限节点
aliases 命令的备用名称
cooldown 使用间隔秒数(0 = 无冷却)。重启后保留
execute-as PLAYER(玩家权限)或 CONSOLE(完全权限)
commands 按顺序执行的命令列表(无需前导 /)
message 执行后的可选消息
available-from / available-until 可选的 yyyy-MM-dd HH:mm 时间窗口
sound-before 执行前播放的音效(Bukkit 名称或命名空间键)
sound-after 执行完成后播放的音效
delay 运行命令前的等待秒数(0 = 立即)
delay-message 倒计时期间动作栏文本({time} = 剩余时间,{total} = 总时间)
delay-freeze true/false。延迟期间禁止移动
args 命名参数映射表 — 每个键是参数名,值是命令列表

占位符

占位符 含义
{player} 玩家名称
{uuid} 玩家 UUID
{world} 世界名称
{x} {y} {z} 方块坐标

颜色代码

&a &c ...        # 经典颜色代码
&#RRGGBB         # 十六进制颜色(例如 &#ff8800)

有关所有选项,请参阅完整的 commands.yml 和 lang.yml。

? 用例

仅发送消息的命令(Discord 链接)

commands:
  discord:
    enabled: true
    description: "显示 Discord 邀请链接。"
    permission-mode: EVERYONE
    execute-as: PLAYER
    commands: []
    message: "&b我们的 Discord: &fhttps://discord.gg/yourserver"

多命令启动包(每天一次)

commands:
  starterkit:
    enabled: true
    permission-mode: PERMISSION
    permission: simplecommands.cmd.starterkit
    cooldown: 86400
    execute-as: CONSOLE
    commands:
      - "give {player} bread 16"
      - "give {player} iron_sword 1"
    message: "&a你已收到新手礼包!明天再来吧。"

代理服务器切换(Velocity / BungeeCord)

像 /server 这样的代理命令不能作为普通命令条目运行——它们在后端运行,而不是在代理上。请改用 [server](或 [connect])动作标签:

commands:
  lobby:
    enabled: true
    permission-mode: EVERYONE
    execute-as: PLAYER
    aliases: [ hub ]
    commands:
      - "[server] lobby"
    message: "&b正在将你传送到大厅..."

代理端要求:

  • Velocity: velocity.toml → bungee-plugin-message-channel = true(默认值)
  • Paper 后端: spigot.yml → settings.bungeecord: true

限时活动命令

commands:
  event:
    enabled: true
    permission-mode: EVERYONE
    execute-as: CONSOLE
    available-from: "2026-12-24 00:00"
    available-until: "2026-12-26 23:59"
    commands:
      - "give {player} firework_rocket 8"
    message: "&a节日快乐!"

带延迟、冻结和音效的传送

commands:
  spawn:
    enabled: true
    permission-mode: EVERYONE
    execute-as: CONSOLE
    sound-before: BLOCK_NOTE_BLOCK_PLING
    sound-after: ENTITY_ENDERMAN_TELEPORT
    delay: 3
    delay-message: "&e将在 {time}s 后传送..."
    delay-freeze: true
    commands:
      - "tp {player} 0 78 0"
    message: "&a已传送到出生点。"

玩家会听到一声提示音,在动作栏看到“将在 3s 后传送...”,无法移动,3 秒后伴随着末影人的音效被传送。

带命名参数的传送点

commands:
  warp:
    enabled: true
    permission-mode: PERMISSION
    permission: simplecommands.cmd.warp
    cooldown: 3
    execute-as: CONSOLE
    commands:
      - "msg {player} 用法: /warp <spawn|shop|nether>"
    message: ""
    args:
      spawn:
        - "tp {player} 0 78 0"
      shop:
        - "tp {player} -200 78 512"
      nether:
        - "tp {player} 0 78 0 world_nether"
  • /warp spawn → 传送到出生点
  • /warp shop → 传送到商店
  • /warp → 显示用法提示
  • Tab 补全建议:spawn、shop、nether

? 故障排除

插件无法加载

检查:

  1. 你是否在使用 Paper 1.20+?(/version)
  2. JAR 文件是否在 plugins/ 文件夹中?
  3. 你是否安装了 Java 21?(java -version)

找不到自定义命令

检查:

  1. 插件是否已加载?(在控制台中查找 "[SimpleCommands]")
  2. 命令是否设置了 enabled: true?
  3. 编辑 commands.yml 后是否运行了 /sc reload?

“你没有权限”

检查:

  1. 命令的 permission-mode 和 permission 节点
  2. 授予该节点(例如通过 LuckPerms)
  3. 对于 OP 模式,玩家必须是管理员

命令执行但无反应

检查:

  1. execute-as —— 对于玩家自己无法执行的操作,请使用 CONSOLE
  2. commands: 列表中的命令没有前导 /
  3. 占位符拼写正确({player},而非 %player%)

/server(代理)提示“未知命令”

代理命令无法在后端运行。请改用动作标签代替普通命令:

  1. 在 commands: 列表中写入 "[server] lobby"(而不是 "server lobby")
  2. Velocity: velocity.toml → bungee-plugin-message-channel = true
  3. Paper 后端: spigot.yml → settings.bungeecord: true

注意:冷却时间按后端服务器存储,不跨整个网络共享。

? 性能

SimpleCommands 轻量高效,旨在提供流畅的性能:

  • ✅ 命令直接注册到服务器的 CommandMap
  • ✅ 异步保存冷却时间(退出时无主线程文件 I/O)
  • ✅ 检测并中止递归命令(防止无限循环/崩溃)
  • ✅ 无外部依赖(LuckPerms 为可选软依赖)
  • ✅ 单个 JAR 兼容 1.20.x–1.21.x
  • ✅ 主线程安全执行

? 版本历史

未来路线图

  • PlaceholderAPI 集成
  • 用于命令的游戏内 GUI 编辑器
  • 周期性冷却自动保存
  • 按命令的使用统计

1.0.3

  • 命名参数:通过 args 映射,在单个命令条目中定义 /warp spawn、/warp shop 等。
  • 参数名的 Tab 补全。
  • 游戏内编辑:使用 /sc edit <cmd> addarg <name> <command> 和 removearg <name>。
  • 当输入未知参数时,向玩家显示可用选项。

1.0.2

  • 音效功能:支持 sound-before 和 sound-after,并安全处理无效的音效名称。
  • 延迟系统:动作栏倒计时显示 {time} 占位符,可选的移动冻结功能(delay-freeze)。
  • 命令现在会强制覆盖现有命令(修复与其他插件的 /spawn 冲突问题)。

1.0.1

  • 通过 [server] / [connect] 动作标签实现代理服务器切换(适用于 Velocity/BungeeCord)。
  • 无限循环保护:检测递归命令并安全中止。
  • 持久化冷却时间:保存至磁盘,玩家登出和服务器重启后依然保留。

1.0.0

  • 初始发布:自定义命令、玩家/控制台执行、持久化冷却时间、权限控制(EVERYONE/OP/PERMISSION)、别名、占位符、时间窗口、实时重载、可翻译消息。

? 链接

  • GitHub:
  • Modrinth:
  • 问题反馈:

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源