Skip to content

作用

NoFallDamage 用于让玩家不再受到摔落伤害。

它适合大厅、跑酷、跳跳乐、小游戏、空岛中转区等需要频繁跳跃或高低落差移动的玩法场景。

默认配置:GroovyConfig/NoFallDamage.yml

如果你在 config.yml -> feature-scripts.config-directory 中改过脚本配置目录,请以实际目录为准。

配置示例

yml
# 是否启用该脚本
enabled: true

# 生效世界列表
# 留空 [] 表示所有世界都生效
worlds: []

# 拥有该权限的玩家可绕过限制
bypass-permission: 'hncore.scripts.nofalldamage.bypass'

# 取消摔落伤害时发送的提示
# 留空 '' 表示不发送
message: ''

# 提示消息冷却(毫秒)
message-cooldown-ms: 1000

关键项说明

worlds

限定脚本生效的世界。

  • []:所有世界生效
  • 填世界名列表:只在这些世界生效

bypass-permission

拥有该权限的玩家不会被脚本保护,仍会受到正常摔落伤害。

message

取消摔落伤害时发送的提示消息。

message-cooldown-ms

同一玩家提示消息的冷却时间,避免频繁落地时刷屏。

实际行为

当前实现监听的是 EntityDamageEvent,并只拦截:

  • 实体为玩家
  • 伤害原因是 FALL

因此它只影响摔落伤害,不会改变火焰、爆炸、虚空、窒息等其他来源的伤害。

启用与重载

修改这个脚本的配置文件后,通常执行:

text
/hncore reload scripts

如果你改的是 config.yml 中的脚本目录名、脚本系统总开关等核心配置,则应执行:

text
/hncore reload

联动说明

注意事项

  • 这个脚本当前只保护玩家,不保护其他实体
  • 如果你想让某些特殊玩家仍保留摔伤,可以用 bypass-permission 区分

HN 系列插件文档