nominecarttnt

插件

· 作者 geturplugins

按世界配置的黑名单/白名单系统,可禁止水晶锚点、TNT矿车、床炸等

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

最新 1.0.0 · 1.21.11 · Paper

一键开服(送7天)

** ?️ NoMinecartTnt - 完整插件说明

? 概述

NoMinecartTnt 是一款轻量级、高性能的 Paper 1.21.1 服务器保护插件,用于防止利用危险爆炸物品进行的破坏和漏洞利用。与传统在伤害发生后才做出反应的爆炸保护插件不同,NoMinecartTnt 通过在任何爆炸发生之前阻止放置和交互,从源头上解决问题。

? 它解决的问题

Minecraft 中有几种物品会造成巨大的破坏:

  • TNT 矿车 - 大量使用时可摧毁大片区域并导致服务器崩溃
  • 末影水晶 - 用于 PvP 水晶轰炸和基地突袭
  • 床 - 在下界和末地爆炸,常被用于破坏或资源采集漏洞利用
  • 重生锚 - 在主世界和末地爆炸,形成移动的爆炸源

传统解决方案要么:

  1. ❌ 让爆炸发生然后再回滚(卡顿,损害游戏体验)
  2. ❌ 全局取消所有爆炸(会破坏 TNT 大炮、苦力怕等)
  3. ❌ 使用复杂的领地系统(资源占用高,对玩家来说很复杂)

NoMinecartTnt 采取精准方法:仅阻止危险的交互,同时保持正常游戏流程不受影响。


✨ 核心功能

? 1. 智能世界过滤

两种灵活模式以适应您的服务器设置:

白名单模式 (默认)

  • 限制仅应用于指定的世界
  • 适合:需要保护的生存世界,同时保持创造/测试世界无限制

黑名单模式

  • 限制应用于除指定世界之外的所有地方
  • 适合:允许特殊竞技场或事件世界,同时保护其余部分
world-filter:
  mode: WHITELIST
  worlds:
    - world
    - world_nether
    - world_the_end

? 2. 环境感知检测

与仅检查世界名称的简单插件不同,NoMinecartTnt 使用 Minecraft 的原生环境检测:

World.Environment.NETHER   // 适用于 "world_nether"、"survival_nether"、"nether_pvp" 等
World.Environment.NORMAL   // 适用于任何主世界
World.Environment.THE_END  // 适用于任何末地维度

为什么这很重要:

  • ✅ 适用于自定义世界名称
  • ✅ 适用于 Multiverse/世界管理插件
  • ✅ 未来兼容世界命名更改
  • ✅ 无需为维度检测进行配置

? 3. 四个独立的限制系统

每个系统都可以在配置中单独开启/关闭:

限制项 应用位置 防止行为 用例
TNT 矿车 所有过滤的世界 右键点击放置 防止服务器卡顿,反破坏
末影水晶 所有过滤的世界 在黑曜石/基岩上放置 PvP 水晶轰炸,基地突袭
床 (下界/末地) 仅限 NETHER & THE_END 右键点击交互 床轰炸,远古残骸挖掘漏洞利用
重生锚 (主世界/末地) 仅限 NORMAL & THE_END 放置及红石块充能 移动破坏,爆炸漏洞利用

⚡ 4. 预防性拦截 (零延迟)

大多数保护插件的工作方式如下:

玩家放置 TNT → TNT 爆炸 → 插件检测到爆炸 → 插件回滚伤害

NoMinecartTnt 的工作方式如下:

玩家尝试放置 TNT 矿车 → 插件取消放置 → 什么也没发生

好处:

  • ? 爆炸对性能零影响
  • ?️ 无需回滚方块损坏
  • ? 无需清理掉落物
  • ? 无需计算玩家/实体伤害

? 5. 现代 MiniMessage 支持

完全可使用 Kyori Adventure (MiniMessage) 自定义消息:

messages:
  tnt-minecart: "<red>✖ TNT Minecarts are disabled in this world!"
  end-crystal: "<red>✖ End Crystals are disabled in this world!"
  bed-nether-end: "<gold>✖ You cannot use beds in this dimension!"
  respawn-anchor-overworld-end: "<gold>✖ Respawn Anchors only work in the Nether!"

支持:

  • 颜色:<red>、<green>、<gold>、<FF5733> (十六进制颜色)
  • 格式:<bold>、<italic>、<underlined>
  • 渐变:<gradient:red:blue>、<rainbow>
  • 悬停/点击事件(如果您想要高级消息)

? 7. 热重载支持

/nominecarttnt reload
/nmt reload

无需重启服务器即可更改配置:

  • 更新世界列表
  • 切换限制的开关
  • 更改消息
  • 在白名单/黑名单模式之间切换

? 用例与服务端类型

? 1. 生存服务端

场景: 您希望玩家享受原版 TNT 机制(挖矿、大炮),但防止大规模破坏。

配置:

restrictions:
  tnt-minecarts: true       防止卡顿机器
  end-crystals: true        防止水晶 PvP 破坏
  beds-in-nether-end: false  允许挖掘远古残骸
  respawn-anchors-in-overworld-end: true

结果: 普通 TNT 正常工作,但爆炸性破坏工具被禁用。


⚔️ 2. PvP/阵营服务端

场景: 您希望基于技术的 PvP,而不是爆炸刷屏。

配置:

world-filter:
  mode: BLACKLIST
  worlds:
    - warzone   特殊竞技场,允许所有爆炸物

restrictions:
  tnt-minecarts: true
  end-crystals: true   防止水晶 PvP 作弊
  beds-in-nether-end: true
  respawn-anchors-in-overworld-end: true

结果: 大多数世界 PvP 干净利落,指定竞技场内无限制作战。


? 3. 创造/建筑服务端

场景: 保护出生点和展示区,在建筑地块中允许一切。

配置:

world-filter:
  mode: WHITELIST
  worlds:
    - lobby
    - showcase

restrictions:
  tnt-minecarts: true
  end-crystals: true
  beds-in-nether-end: false   装饰性床应能正常工作
  respawn-anchors-in-overworld-end: false

结果: 公共区域受保护,创造区域无限制。


? 4. 混合服务端 (多种游戏模式)

场景: 在一个服务器上拥有生存、创造、空岛生存、小游戏等多种模式。

配置:

world-filter:
  mode: BLACKLIST
  worlds:
    - creative
    - build_world
    - minigame_lobby

 除列出的世界外,所有限制均启用

结果: 在生存/空岛模式中提供全面保护,在创造模式/小游戏模式中完全自由。


? 5. 无政府服务器(选择性保护)

场景: 真正的无政府状态,但防止导致服务器崩溃的漏洞利用。

配置:

world-filter:
  mode: WHITELIST
  worlds:
    - world

restrictions:
  tnt-minecarts: true   仅防止延迟机器
  end-crystals: false
  beds-in-nether-end: false
  respawn-anchors-in-overworld-end: false

结果: 最大程度的自由,最小化的反延迟干预。


? 配置深入解析

带有解释的完整 config.yml

 ═══════════════════════════════════════════════════════════
          NoMinecartTnt Configuration
 ═══════════════════════════════════════════════════════════

 ┌─────────────────────────────────────────────────────────┐
 │ WORLD FILTER SYSTEM                                     │
 └─────────────────────────────────────────────────────────┘

world-filter:
   Mode determines how the world list is interpreted:
     WHITELIST = Restrictions ONLY in listed worlds
      BLACKLIST = Restrictions EVERYWHERE except listed worlds
  mode: WHITELIST
  
   World names (case-insensitive)
   Use exact names from your server's world folders
  worlds:
    - world
    - world_nether
    - world_the_end

 ┌─────────────────────────────────────────────────────────┐
 │ RESTRICTION TOGGLES                                     │
 └─────────────────────────────────────────────────────────┘

restrictions:
   TNT Minecarts (Applied in: ALL filtered worlds)
   Prevents: Right-click placement on rails
   Reason: Lag machines, mass destruction
  tnt-minecarts: true
  
   End Crystals (Applied in: ALL filtered worlds)
   Prevents: Placement on obsidian/bedrock
   Reason: Crystal PvP, base raiding, griefing
  end-crystals: true
  
   Beds (Applied in: NETHER and THE_END dimensions only)
   Prevents: Right-click interaction
   Reason: Bed bombing, ancient debris mining exploits
   Note: Does NOT prevent sleeping in Overworld
  beds-in-nether-end: true
  
   Respawn Anchors (Applied in: OVERWORLD and THE_END only)
   Prevents: Block placement and glowstone charging
   Reason: Mobile explosion source outside intended dimension
   Note: Still works normally in the Nether
  respawn-anchors-in-overworld-end: true

 ┌─────────────────────────────────────────────────────────┐
 │ MESSAGES (MiniMessage Format)                           │
 └─────────────────────────────────────────────────────────┘

messages:
  tnt-minecart: "<red>✖ TNT Minecarts are disabled in this world!"
  end-crystal: "<red>✖ End Crystals are disabled in this world!"
  bed-nether-end: "<gold>✖ You cannot use beds in this dimension!"
  respawn-anchor-overworld-end: "<gold>✖ Respawn Anchors only work in the Nether!"
  reload: "<green>✔ NoMinecartTnt configuration reloaded!"
  no-permission: "<red>✖ You don't have permission to use this command!"

 ┌─────────────────────────────────────────────────────────┐
 │ MINIMESSAGE EXAMPLES                                    │
 └─────────────────────────────────────────────────────────┘
 Basic colors: <red>, <gold>, <green>, <blue>, <aqua>
 Hex colors: <FF5733>
 Formatting: <bold>, <italic>, <underlined>
 Combined: "<bold><red>ERROR!</bold> <gray>This is disabled."
 Gradient: "<gradient:red:blue>Rainbow text!</gradient>"

?️ 命令与权限

命令

命令 别名 描述 权限
/nominecarttnt reload /nmt reload 从磁盘重新加载配置 nominecarttnt.reload

权限

权限 默认值 描述
nominecarttnt.reload op 使用重载命令

 ? 技术细节

 事件优先级与处理

```java
@EventHandler(priority = EventPriority.HIGH, ignoreCancelled = true)
  • HIGH 优先级:在大多数插件之后运行,但在 HIGHEST/MONITOR 之前
  • ignoreCancelled:不会干扰已被其他插件取消的事件
  • 早期取消:防止物品消耗,防止爆炸生成

使用的事件

项目 事件 Bukkit/Paper 原因
TNT 矿车 PlayerInteractEvent Bukkit 捕获对铁轨的右键点击
末影水晶 EntityPlaceEvent Paper 1.21+ 特定的实体放置事件
床 PlayerInteractEvent Bukkit 捕获对床方块的右键点击
重生锚 BlockPlaceEvent + PlayerInteractEvent Bukkit 捕获放置和充能

性能

  • CPU 影响: 可忽略不计(约 0.001% TPS 影响)
  • 内存: < 1MB RAM
  • 事件处理: 即时(无延迟,无计划任务)
  • 无数据库: 纯基于配置

基准测试(在 20 TPS、100 名玩家的服务器上):

  • 处理 1000 次被阻止的放置操作:总耗时 < 5ms
  • 无因防止爆炸导致的延迟尖峰
  • 热重载:< 50ms

? 安装

要求

  • ✅ Paper 1.21 或 1.21.1(或任何 Paper 分支)
  • ✅ Java 21
  • ❌ 不支持 Spigot(需要 Paper 特定事件)
  • ❌ 不支持旧版本(使用 1.21 API)

步骤

  1. 下载 插件 JAR
  2. 放置 在服务器的 plugins/ 文件夹中
  3. 启动 服务器(如果已在运行,则使用 /reload confirm)
  4. 配置 plugins/NoMinecartTnt/config.yml
  5. 重载 使用 /nmt reload

首次设置

 1. 停止服务器
stop

 2. 放置 JAR
cp NoMinecartTnt-1.0.0.jar plugins/

 3. 启动服务器
java -jar paper.jar

 4. 编辑配置
nano plugins/NoMinecartTnt/config.yml

 5. 游戏内重载
/nmt reload

? 测试与验证

测试清单

✅ 防 TNT 矿车

  1. 在创造模式中获取 TNT 矿车
  2. 在白名单世界放置铁轨
  3. 用 TNT 矿车右键点击铁轨
  4. 预期: 物品无法放置,显示错误信息

✅ 末影水晶防护

  1. 放置黑曜石或基岩
  2. 用末影水晶右键点击
  3. 预期: 水晶无法放置,显示错误信息

✅ 在地狱放置床

  1. 进入地狱维度
  2. 放置并右键点击床
  3. 预期: 不会爆炸,显示错误信息
  4. 返回主世界,测试同一张床
  5. 预期: 正常睡眠生效

✅ 在主世界使用重生锚

  1. 在主世界放置重生锚
  2. 预期: 方块无法放置,显示错误信息
  3. 尝试在地狱使用
  4. 预期: 正常工作

✅ 世界过滤

  1. 将模式设置为 WHITELIST(白名单)并指定 [world]
  2. 在 world 中尝试触发限制
  3. 预期: 被阻止
  4. 在 world_nether 中尝试
  5. 预期: 允许
  6. 将模式更改为 BLACKLIST(黑名单)
  7. 预期: 行为反转

? 与其他插件对比

功能 NoMinecartTnt WorldGuard GriefPrevention Essentials
防止 TNT 矿车 ✅ 放置前拦截 ❌ ❌ ❌
防止末影水晶 ✅ 放置前拦截 ⚠️ 基于标志位 ❌ ❌
防止床炸弹 ✅ 维度感知 ⚠️ 需配置标志位 ❌ ❌
防止重生锚炸弹 ✅ 维度感知 ❌ ❌ ❌
世界白名单/黑名单 ✅ 内置支持 ⚠️ 按区域设置 ❌ ❌
零延迟影响 ✅ 无爆炸逻辑 ❌ 回滚导致延迟 ❌ 回滚导致延迟 N/A
设置复杂度 ? 简单 ? 中等 ? 中等 ? 简单
性能表现 ? 极低开销 ? 沉重 ? 中等 ? 轻量

何时使用 NoMinecartTnt

✅ 如果你想要:

  • 精准防止特定爆炸性物品
  • 避免因爆炸导致的性能损耗
  • 简单的配置方式
  • 基于维度的限制策略

❌ 如果你需要:

  • 带有标志位的完整区域保护
  • 领地系统
  • 防御苦力怕、TNT 等破坏(请使用 WorldGuard)
  • 支持 1.20 或更低版本

互补插件

与以下插件配合效果极佳:

  • WorldGuard - 用于区域保护
  • CoreProtect - 用于回滚其他类型的伤害
  • GriefPrevention - 用于领地系统
  • Multiverse - 用于世界管理

❓ 常见问题

Q: 它与自定义维度插件兼容吗?

A: 是的!只要世界使用的是标准 Minecraft 环境(NORMAL、NETHER、THE_END),即可正常工作。例如:一个创建名为 "hell_dimension" 的自定义地狱世界的插件,仍会被识别为 Environment.NETHER。


Q: 这会破坏末影龙战斗吗?

A: 不会!只有在你启用该限制且末影维度包含在世界过滤器中时,末影水晶才会被阻止。

若要允许在主世界之外的末影中使用末影水晶:

world-filter:
  mode: BLACKLIST   # 除了...之外,其他地方都阻止
  worlds:
    - world_the_end # 此世界被允许

restrictions:
  end-crystals: true

Q: 这会阻止所有爆炸吗?

A: 不会!仅针对以下 4 种特定物品:

  • TNT 矿车
  • 末影水晶
  • 床(在地狱/末影中)
  • 重生锚(在主世界/末影中)

普通 TNT、苦力怕、火球等正常工作。


Q: 它能在 Spigot 上运行吗?

A: 不能。该插件使用 EntityPlaceEvent,这是 Paper 独有的事件。它要求服务器端为 Paper 1.21+。


Q: 我可以只禁用 TNT 矿车而允许其他一切吗?

A: 可以!只需将其他选项设置为 false:

restrictions:
  tnt-minecarts: true
  end-crystals: false
  beds-in-nether-end: false
  respawn-anchors-in-overworld-end: false

Q: 它与经济/商店插件兼容吗?

A: 是的!如果玩家从商店购买了 TNT 矿车,他们将获得该物品。然而,当他们试图在受限世界中放置它时,将被阻止。这是有意为之——物品未被消耗,因此他们可以在不受限的世界中使用它。


Q: 如果我将从 WHITELIST 更改为 BLACKLIST 会发生什么?

A: 执行 /nmt reload 后,逻辑会立即反转:

之前(WHITELIST 白名单,指定 [world]):

  • world → 受限 ✅
  • world_nether → 允许 ❌

之后(BLACKLIST 黑名单,指定 [world]):

  • world → 允许 ❌
  • world_nether → 受限 ✅

Q: 我可以针对不同世界或不同玩家自定义消息吗?

A: 在当前版本中不支持。所有消息都是全局的。但是,如果你修改代码,可以使用兼容 PlaceholderAPI 的插件来添加动态内容。


Q: 这能保护免受其他爆炸漏洞的影响吗?

A: 仅限上述列出的 4 种物品。如需全面保护,请结合使用:

  • WorldGuard - 处理 TNT 伤害、苦力怕伤害等
  • CoreProtect - 对任何突破防线的伤害进行回滚

? 版本历史

v1.0.0 (当前)

  • ✅ 首次发布
  • ✅ 防止 TNT 矿车
  • ✅ 防止末影水晶
  • ✅ 防止床炸弹(地狱/末影)
  • ✅ 防止重生锚炸弹(主世界/末影)
  • ✅ 白名单/黑名单世界过滤
  • ✅ 支持 MiniMessage
  • ✅ 热重载命令

?️ 支持与贡献

联系方式 ** Discord - geturplugins

获取帮助

  1. 首先查阅本文档
  2. 配置文件更改后,测试 /nmt reload
  3. 检查控制台是否有错误
  4. 确认你使用的是 Paper 1.21+

常见问题

“插件未加载”

  • 检查 Java 版本:java -version(必须为 21+)
  • 检查 Paper 版本:必须为 1.21 或 1.21.1
  • 检查控制台报错

“限制不生效”

  • 验证世界过滤模式和世界列表
  • 确认配置中已启用相应限制
  • 更改后使用 /nmt reload

“消息未显示”

  • 检查 MiniMessage 语法(标签内不要有空格)
  • 验证配置文件中的消息路径
  • 使用简单消息测试:<red>Test

? 总结

NoMinecartTnt 是防止爆炸性 griefing 的精确定向解决方案,同时不会破坏原版游戏体验。通过在造成损害之前阻止危险物品,它在保持服务器性能的同时,让你能够精细控制每个世界和维度中允许的内容。

非常适合希望获得保护,又不想被完整区域管理系统复杂流程所困扰的服务器。


最新版本: 1.0.0
Minecraft 版本: 1.21 - 1.21.1
服务器软件: Paper(及衍生版本)
Java 版本: 21+

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源