TuSKe - 全能Skript扩展插件

TuSKe 是一款 Skript 扩展插件，它为 Skript 带来了与多个流行实用插件的集成支持，并新增了一系列功能，帮助服务器管理员更便捷地管理服务器。

💡支持的插件

TuSKe 目前支持与以下插件进行集成

• Marriage
• SimpleClans
• LegendChat
• ProtocolSupport / ViaVersion

❓文档与支持

• 文档：完整的语法文档可在 SkUnity's Doc 查阅。
• 支持：编写脚本时若遇到问题，可访问 SkUnity's Forum。若问题与 TuSKe 插件本身相关，请前往 TuSKe 的发布帖 进行反馈。
• 建议与漏洞：如有任何功能建议，请在下方评论区留言。若发现漏洞，请通过私信或在讨论页面评论的方式提交。

⭐主要功能

LegendChat 集成

TuSKe 为聊天插件 LegendChat 提供了全面的语法支持。

事件

• on legendchat chat
• 当玩家在聊天频道发言时触发。
• 返回值：

- `player`：发送消息的玩家。

- `legendchat channel`：玩家发送消息的频道。返回 `%channel%`。

- `legendchat message`：消息内容。可被清除或设置为 `%string%`。返回 `%string%`。

• on legendchat tell
• 当玩家发送私聊时触发。
• 返回值：

- `sender`：消息发送者（玩家或控制台）。

- `receiver`：消息接收者（玩家或控制台）。

- `tell message`：私聊消息。可被清除或设置为 `%string%`。返回 `%string%`。

条件

• %player% is (not) muted
• 检查玩家是否被禁言。
• %player% can(‘t) (see|say in) [channel] %channel%
• 检查玩家是否拥有在指定频道的查看/发言权限。

效果

• [make] %player% [send] tell %string% to %player%
• 让一个玩家向另一个玩家发送私聊。
• mute %player% [for %integer% minute[s]]
• 禁言玩家指定分钟数（不指定时间则为永久禁言，直到服务器重启）。
• unmute %player%
• 解除玩家的禁言。
• make %player% say %string% in [channel] %channel%
• 让玩家在指定频道发言。

表达式

• mute (left|remaining) time of %player%
• 返回玩家剩余的禁言时间（分钟）。返回 %integer%。
• default channel of %player%
• 返回玩家在 LegendChat 中的默认频道。可设置为 %channel%。返回 %channel%。
• spy state of %player%
• 返回玩家的间谍模式状态（布尔值）。可设置为 %boolean%。返回 %boolean%。
• hide state of %player%
• 返回玩家的隐藏状态（布尔值）。可设置为 %boolean%。返回 %boolean%。
• [chat] tag %string% of %player%
• 返回玩家的指定自定义聊天标签（需在 LegendChat 配置文件中添加对应标签格式）。可设置或清除。返回 %string%。
• [chat] tags of %player%
• 返回玩家所有的自定义标签列表（返回如 "Mytag" 的格式，而非 "[MyTag]"）。

类型

• channel
• 代表 LegendChat 配置中创建的频道类型，例如：global, local。

自定义附魔

从 TuSKe 1.5.3 版本开始，你可以通过 Skript 效果创建自定义附魔。

创建基础附魔

首先，你需要注册一个附魔并指定其 ID 名称。

on skript load:
    register a new custom enchantment with id name "Magic"

此处的 ID 名称 "Magic" 将在后续代码中用于为物品附魔。

可选配置项

注册后，你可以为附魔设置以下可选属性

• set max level of Magic to 10
• 设置附魔的最大等级，范围为 1 到 10，默认为 3。
• set rarity of Magic to 3
• 设置附魔的稀有度，范围为 1（稀有）到 5（常见），默认为 3。
• set accepted items for Magic to "Swords", "Bow" and "Armor"
• 设置附魔可应用的物品类型。接受以下特定值：

- 单个类型：`Helmets`, `Chestplates`, `Leggings`, `Boots`, `Pickaxes`, `Axes`, `Shovels`, `Bow`, `Fishing Rod`

- 组合类型：`Tools`（镐、斧、锹）、`Armor`（头盔、胸甲、护腿、靴子）、`All`（所有类型）

• 默认值为 All。可使用逗号或 “and” 分隔多个值。
• set enabled for Magic to true
• 设置为 true 时，此附魔可在附魔台中获得；否则只能通过 Skript 代码添加。默认为 false。
• set conflicts for Magic to Enchantment and Another_Enchantment
• 设置与此附魔冲突的其他附魔 ID 名称列表，冲突的附魔无法同时存在于同一物品上。

完整配置示例

on skript load:
    register a new custom enchantment with id name "Magic"
    set {_enchantment} to "Magic" parsed as custom enchantment
    set max level of {_enchantment} to 5
    set rarity of {_enchantment} to 1
    set accepted items for {_enchantment} to "Swords" and "Bow"
    set lore name of {_enchantment} to "Magic Power"

配置完成后，执行以下效果重载附魔以使更改生效

reload all custom enchantments

相关表达式

• %itemtype% has custom enchantment %custom enchantment%
• 检查物品是否拥有指定的自定义附魔。
• level of custom enchantment %custom enchantment% of %itemstack%
• 获取物品上指定自定义附魔的等级。
• [all] custom enchantments of %itemstack%
• 获取物品上的所有自定义附魔列表。

GUI 管理器

TuSKe 提供了一套强大的 GUI 创建与管理语法，用于格式化物品栏中的槽位。

创建 GUI 槽位效果

共有四种基础效果格式

• 无动作槽位

   (format|create|make) [a] gui slot %numbers% of %players% with %itemstack% to do nothing

• 点击关闭槽位

   (format|create|make) [a] gui slot %numbers% of %players% with %itemstack% to close [using %click action% [(button|click|action)]]

• 点击执行命令槽位

   (format|create|make) [a] gui slot %numbers% of %players% with %itemstack% to [close then] run %command sender% command %string% [as op] [using %click action% [(button|click|action)]] [with cursor [item] %itemstack%]

• 点击执行函数槽位

   (format|create|make) [a] gui slot %numbers% of %players% with %itemstack% to [close then] run function %function% [using %click action% [(button|click|action)]] [with cursor [item] %itemstack%]

参数说明

• %click action%：指定触发动作的点击类型。支持的值包括：left, right, shift left, shift right, double click, middle, number key, drop, control drop。如果使用 Bensku 的 Skript v2.2-dev16b 或更高版本，请查阅其文档以获取正确的点击动作值。
• with cursor %itemstack%：仅当玩家手持特定物品点击时才会触发动作。
• 在“执行命令”效果中，可选择以控制台或玩家身份执行命令，若以玩家身份执行，还可选择是否以 OP 权限运行。

使用示例

# 基础示例
create a gui slot 0 of player with stone to do nothing
create a gui slot 1 of player with potato to close with left click
create a gui slot 2 of player with paper to run player command "CommandHere" as op
create a gui slot 3 of player with diamond to run console command "CommandHere"
create a gui slot 4 of player with gravel to run function giveItems(player) with cursor item stone

# 同一槽位不同点击动作
create a gui slot 2 of player with stone to run function subtract(1) with left click
create a gui slot 2 of player with stone to run function increase(1) with right click

# 动态更改槽位物品
function toggle(p: Player):
    if {var} is true:
        set slot 0 of current inventory of {_p} to red wool
    else:
        set slot 0 of current inventory of {_p} to green wool
# 在你的打开物品栏代码后
create a gui slot 0 of player with green wool to run function toggle(player)

取消格式化与条件

• 取消格式化单个槽位：

  unformat the gui slot 1 of player

• 取消格式化所有槽位：

  unformat all gui slots of player

• 条件判断：
• %player% has [a] gui：检查玩家当前打开的库存是否包含 GUI 槽位。
• slot %number% of %player% is a gui：检查玩家的指定槽位是否为 GUI 槽位。

改进与优势

相较于旧方法或其他未更新的插件，TuSKe 的 GUI 管理器具有以下优势：

• 无需在打开物品栏后等待 1 tick。
• 仅格式化玩家当前打开的库存（不包括合成网格）。
• 不会与同一库存中的其他槽位冲突。
• 无循环问题，你可以在循环中创建 GUI，每个命令/函数都会拥有独立的值。

🎮其他语法示例

# 铁砧合成事件
on anvil combine:
    event-item-one is a diamond sword
    event-item-two is a diamond sword
    send "Oh, you combined two diamonds swords!"

# 铁砧重命名事件
on anvil rename:
    event-string is "Awesome axe"
    event-item-result is any axe
    send "You've renamed your %event-item% from %event-item's name% to %event-string%"

# 按字母顺序列出玩家
command /players:
    trigger:
        set {_players::*} to alphabet order of all players
        loop {_players::*}:
            send "%loop-value%"

# 显示玩家经验球数量
command /xp:
    trigger:
        send "You have %xp of player% experiences orbs."

# 使用自定义附魔“吸血鬼”的效果
on damage of player:
    if attacker's tool has custom enchantment Vampire:
        set {_AddHealth} to 1 * level of custom enchantment Vampire of attacker's tool
        add {_AddHealth} to health of attacker

🔧安装方法

• 将 Skript 和 TuSKe 的 jar 文件放入服务器的 plugins 文件夹。（如果已安装 Skript，则只需放入 TuSKe）。
• 重启你的服务器。（插件无法在服务器运行时直接加载。）
• 安装完成！现在即可开始在 Skript 脚本中使用 TuSKe 的功能。

✨前置需求

• 必需：Skript
• 可选：上述列出的支持插件（Marriage, SimpleClans, LegendChat, ProtocolSupport/ViaVersion），用于启用对应的集成功能。