SkMorkaz - Skript addon - NoteBlockAPI - SkMorkaz - Skript 扩展插件

简介

本插件是 Skript 的一个扩展插件，旨在为其添加新的功能。它最初为 Spigot 1649（1.7+/1.8+）版本创建，但也应兼容更新的 1.8+ 版本。如果遇到问题，请联系开发者进行编译。本插件支持与 AuthMe 和 NoteBlockAPI 等插件联动，并可根据需求添加更多特定功能。

💡支持的插件与功能扩展

本插件目前支持以下插件，并为其添加了新的语法元素：

• AuthMe：新增 1 个条件、1 个效果、2 个表达式。
• NoteBlockAPI：新增 2 个效果。

开发者可以根据您的需求，为其他插件（如 WorldGuard、WorldEdit）或特定功能（如发送资源包、创建铁砧菜单）添加支持。如果您有需要集成的插件，请发送其 .jar 文件。

🎮计划添加的功能

以下是一些计划在未来版本中添加的功能构想

• 发送主题为 %string%、内容为 %string% 的邮件至 %string%
• 粘贴名为 %string% 的 schematic（可排除 %block%）
• 检查 %location% 处的区域是否包含名为 %string% 的 flag
• 玩家跳跃事件
• 玩家落地事件
• 生成黑曜石或圆石事件
• 药水效果应用事件
• 将 %block% 或 %itemstack% 设置为 %player% 的头颅
• 从文件 %string% 中读取 YAML 值 %string%
• 将 %string% 保存到文件 %string% 的 YAML 值中

如果您有更多想法，欢迎联系开发者提出建议。

🔧捐赠

如果您希望支持本插件的开发，可以通过捐赠来表达您的支持。捐赠者将有机会在此页面获得宣传。您的支持是开发者持续更新和添加新功能的动力。所有插件功能均可免费使用，您的捐赠将被视为一份珍贵的礼物。

✨功能列表

本插件为 Skript 添加了以下新功能。语法说明：[] 表示可选，(X|Y) 表示二选一，%% 表示特定类型。

事件

`on [mor.]jump`

• 描述：当玩家跳跃时触发。此事件每个跳跃动作仅触发一次，避免了 WildSkript 跳跃事件的错误。
• 选项：
• cancellable - 可取消，阻止跳跃。
• player - 正在跳跃的玩家。
• 示例：

on mor.jump:
if player is in the region "SpectatorArea":
cancel event

`on dragon['s] portal creat(e|ion)`

• 描述：当实体创建末地传送门时触发（例如末影龙死亡时）。
• 选项：
• cancellable - 可取消，阻止传送门创建。
• event-entity - 触发事件的实体。
• event-location - 事件发生的位置。
• 示例：

on dragon portal create:
cancel event
paste schematic "myportal" at event-location

`on block piston push`

• 描述：当活塞推动特定方块时触发。事件围绕被推动的方块（而非活塞本身），每个被推动的方块都会触发。
• 选项：
• cancellable - 可取消，阻止推动。
• event-block - 被推动的方块。
• event-string - 方块被推动的方向（例如 WEST）。
• 示例：

on block piston push:
set {regions::*} to regions at location 1 meter event-string event-block
if size of {regions::*} is not 0:
cancel event

`on block fall[ing]`

• 描述：比 Skript 原有 on fall 事件更优的版本。在方块开始下落（变为掉落沙实体）或落地变为稳定方块时触发。
• 选项：
• cancellable - 可取消，阻止方块下落或变为稳定方块。
• event-block - 即将变为掉落沙的方块，或掉落沙即将落地的空气方块。
• event-entity - 掉落沙实体。当方块刚开始下落时，此选项未设置。
• 示例：

on block falling:
if event-block is not air:
broadcast "BLOCK START FALLING"
add event-entity to {fallingblocks::*}
else:
broadcast "BLOCK STOPED FALLING"
remove event-entity from {fallingblocks::*}

`on mor.inventory click`

• 描述：当玩家点击库存时触发的额外事件，与本插件的表达式 cursor item of %player% 结合使用非常有用。
• 选项：
• event-player - 点击库存的玩家。
• event-inventory - 被点击的库存。
• event-item - 被点击的物品。
• event-number - 被点击的槽位编号。可使用 slot event-number of event-inventory 获取点击后的物品（例如，如果光标物品为空，则返回空气）。
• 示例：

on mor inventory click:
broadcast "%event-item%, %cursor-item%, %event-inventory%, %player%"

条件

`if %player% (has|is having) potion [effect] %string%`

• 描述：当玩家拥有指定的药水效果时返回 true。药水名称必须使用 Bukkit 名称（例如 SLOW，而非 SLOWNESS）。
• 示例：

if player is not having potion effect "SLOW":
apply potion of slow of tier 10 to the player for 10 seconds

`if %player% is registered`

• 描述：如果玩家已注册昵称，则返回 true。
• 依赖：AuthMe 插件。
• 示例：

on portal:
if player is not registered:
send "&c&lYou are not registered to enter this portal!"
stop
else:
send player to "skyblock"

`if %player% is (logged|authorized)`

• 描述：如果玩家已通过 /login <password> 登录，则返回 true。
• 依赖：AuthMe 插件。
• 示例：

on portal:
if player is logged:
send player to "skyblock"
else:
stop

`if password %string% is (password of %player%|%player%['s] password)`

• 描述：如果条件中使用的密码与玩家在 AuthMe 中设置的密码匹配，则返回 true。
• 依赖：AuthMe 插件。
• 示例：

command log <text>:
trigger:
if password text-argument is player's password:
force login player

效果

`[mor.]send email [with] subject %string% [with] message %string% to %string%`

• 描述：发送一封真实邮件。您需要在配置中设置主机、端口、登录信息、密码（如果需要）和连接类型（推荐 SSL）。如果您使用的是旧版本，请生成新配置。
• 示例：

command send <text> <text> <text>:
trigger:
send email with subject "%text-argument-2%" with message "%text-argument-3%" to "%text-argument-1%"

`set cursor item of %player% to %itemstack%`

• 描述：将玩家的光标物品设置为指定的物品。
• 示例：

on inventory click:
if slot clicked slot of event-inventory is enderchest:
if cursor item of player is not air:
if player's enderchest can hold cursor item of player:
cancel event
add cursor item of player to player's enderchest
set cursor item of player to air

`set [mor.]amount of %itemstack% to %number%`

• 描述：将变量或选项（如 player's tool）中物品的数量设置为指定数字。
• 示例：

set mor.amount of {_item} to 5

`set mor.maxhp of %entity% to %number%`

• 描述：设置可受伤实体的最大生命值。
• 示例：

on rightclick:
if event-entity is set:
set mor.maxhp of event-entity to max health of event-entity + 1

`play [noteblock] music %string% for %player%`

• 描述：为指定玩家播放位于 /plugins/SkMorkaz/NBSFiles/ 文件夹中的 NoteBlock 音乐文件。您可以使用 NoteBlockStudio 轻松将 .midi 文件转换为 .nbs 格式。
• 依赖：NoteBlockAPI 插件。
• 示例：

play noteblock music "test.nbs" for player

`stop [noteblock] music for %player%`

• 描述：停止为指定玩家播放音乐。
• 依赖：NoteBlockAPI 插件。
• 示例：

stop noteblock music for player

`force login %player%`

• 描述：使玩家强制登录。此效果允许在玩家加入服务器但未授权时，使其变为已登录状态。
• 依赖：AuthMe 插件。
• 示例：

on join:
if IP-address of the player is {authme::sesions::lastloged::ip::%player%}:
force login player

表达式

`row [number] of %inventory%`

• 描述：返回指定库存的行数。
• 示例：

loop (row of player's current inventory)*9 times:
add slot "%loop-number - 1%" parsed as number of player's current inventory to {_items::*}

`window [number] of %inventory%`

• 描述：与行数类似，但返回的是库存的窗口数。
• 示例：

loop (windows of player's current inventory) times:
add slot "%loop-number - 1%" parsed as number of player's current inventory to {_items::*}

`cursor item of %player%`

• 描述：返回玩家光标上的物品（例如点击后）。
• 示例：

set {_item} to cursor item of player

`[mor.]potion tier [of] %string% of %player%`

• 描述：返回指定玩家身上特定药水效果的等级。如果未应用，则返回 0。请使用 Bukkit 药水名称（如示例所示）。
• 示例：

set {_tier.number} to potion tier of "SLOW" of player

`[mor.]potion duration [of] %string% of %player%`

• 描述：返回指定玩家身上特定药水效果的剩余持续时间（解析为 Skript 时间格式）。如果未应用，则返回 0。请使用 Bukkit 药水名称（如示例所示）。
• 示例：

set {_potion.duration} to potion duration of "SLOW" of player