命令

了解命令

首先我们先对一个命令进行拆解 /taboolib give <user>

• 主节点: /taboolib
• 子节点：/give
• 参数层：<user>

了解完以后我们创建命令

@CommandHeader("taboolib", ["tl"], permission = "taboolib.command")
object TestCommand {

    // 子节点
    @CommandBody
    val give = subCommand {
        // 参数 user
        dynamic("user") {
            execute<CommandSender> { sender, context, argument ->
                // 获取参数的值
                val user = context["user"]
                sender.sendMessage("Hello, ${user}")
            }
        }
    }
}

这样我们就创建了一个/taboolib的主命令，子命令是give，参数层是填写玩家名的命令了

参数类型

我们还可以根据实际情况对参数的类型进行限制和选择

1. String类型

dynamic("user") {
    execute<CommandSender> { sender, context, argument ->
        val user = context["user"]
        sender.sendMessage("Hello, ${user}")
    }
}

2. Int类型

int("amount") {
    execute<CommandSender> { sender, context, argument ->
        val amount = context.int("amount")
        sender.sendMessage("Hello, ${amount}")
    }
}

3. Double 类型

decimal("amount") {
    execute<CommandSender> { sender, context, argument ->
        val amount = context.double("amount")
        sender.sendMessage("Hello, ${amount}")
    }
}

4. Player类型

player("user") {
    execute<CommandSender> { sender, context, argument ->
        val user = context.player("user")
        // 转化为Bukkit的Player
        val bukkitPlayer = user.castSafely<Player>()
        sender.sendMessage("Hello, ${user}")
    }
}

5. Boolean类型

bool("选项"){
    execute<Player> { sender, context, argument ->
        UI.open(sender, xxx, context.bool("选项"))
    }
}

节点忽略

面对命令 /taboolib give xxx 的时候 我想实现

1. 有xxx的时候给xxx发消息
2. 没有xxx的时候给指令执行者发消息

我应该如何写呢？

@CommandBody
val give = subCommand {
    dynamic("user") {
        execute<CommandSender> { sender, context, argument ->
            val user = context["user"]
            sender.sendMessage("Hello, ${user}")
        }
    }
    execute<CommandSender> { sender, context, argument ->
        sender.sendMessage("Hello, MySelf")
    }
}

在没有接受到参数 user的时候就不再执行 user方法体内的函数了 执行下方的函数

参数补全

假如你有一个商店插件 你要对商店名进行补全 如何书写呢?

@CommandBody(permission = "shop.open")
val open = subCommand {
    dynamic("商店名") {
        suggestion<CommandSender>(uncheck = true) { sender, context ->
            ShopManager.getShopNameList()
        }
        player("目标玩家") {
            execute<CommandSender> { sender, context, argument ->
                Bukkit.getPlayer(context.player("目标玩家").uniqueId)
                    ?.let { UIShopInfo.open(it, context["商店名"]) }
            }
        }
        execute<Player> { sender, context, argument ->
            UIShopInfo.open(sender, context["商店名"])
        }
    }
}

我们注意到在参数节点下方的 suggestion 方法

suggestion<CommandSender>(uncheck = true) { sender, context ->
    ShopManager.getShopNameList()
}

我们需要在这个环节 返回一个List<String> 然后就可以进行补全了 如果只想作为提示不想强行约束需要标记 (uncheck = true)

注册简单命令

如果想要注册一个 /day 的指令如何快速注册呢？
这里利用到了 自唤醒 功能

@Awake(LifeCycle.ENABLE)
fun test() {
    simpleCommand("day") { sender, args ->
        Bukkit.getWorld("world")?.time = 1000
    }
}

我们就在服务器 Enable 环节进行注册命令