? NoCartExplosions
NoCartExplosions 是一款轻量级、零延迟的服务器插件,旨在阻止 TNT 矿车在爆炸时破坏方块和地形,同时完全保留 Paper 对玩家、生物和物品的默认爆炸伤害。

[!IMPORTANT]
保护你的建筑,而不破坏战斗或红石装置!
当 TNT 矿车爆炸时,不会破坏任何方块,但周围的玩家和生物会受到标准原版精度的爆炸伤害。
✨ 功能
- ?️ 完整的方块与地形保护:防止 TNT 矿车损坏方块、破坏红石或造成地面凹陷。
- ? 保留 Paper 战斗机制:实体(玩家、生物、载具)仍会收到标准的 Paper 爆炸伤害。
- ⚡ 超轻量且高性能:基于事件驱动的 Bukkit 监听器,CPU 占用极低,零 Tick 损失。
- ? 世界白名单:将保护限制在特定世界(例如生存服、大厅),或在服务器范围内启用。
- ? 实时热重载:使用
/nce reload 即时更新设置,无需重启服务器。
- ☕ 现代 Java 21 - 25:原生针对 Paper API 1.21.11 构建,以实现最佳性能。
? 工作原理
| 功能 |
标准 Minecraft |
使用 NoCartExplosions 后 |
| 地形破坏 |
? 破坏方块 |
?️ 100% 受保护 |
| 实体爆炸伤害 |
? 受到伤害 |
? 保留(原版 Paper) |
| 物品掉落伤害 |
? 物品被销毁 |
?️ 受保护 |
| 性能开销 |
⚠️ 高(方块物理更新) |
⚡ 零延迟 |
⚙️ 配置 (config.yml)
默认的 config.yml 简洁明了,开箱即用:
# ======================================================
# NoCartExplosions 配置
# ======================================================
# 切换 TNT 矿车 / 爆炸性矿车的地形保护。
# 设为 true 时,矿车爆炸将不会破坏任何方块或改变地形。
prevent-terrain-damage: true
# 在此列表中列出矿车地形保护生效的世界名称。
# 留空 [] 以在所有服务器上启用保护。
# 示例:
# enabled-worlds:
# - world
# - world_nether
enabled-worlds: []
# 如果设为 true,每当阻止 TNT 矿车爆炸的地形伤害时,都会在控制台记录一条消息。
log-prevented-explosions: false
? 命令与权限
| 命令 |
权限 |
描述 |
/nocartexplosions reload |
nocartexplosions.admin |
实时重载 config.yml 设置 |
/nce reload |
nocartexplosions.admin |
重载命令的短别名 |
[!TIP]
管理权限默认为服务器操作员(op: true)。
? 安装与设置
- 下载:从 Versions 选项卡获取最新的
.jar 文件。
- 安装:将
NoCartExplosions-1.0.0.jar 放入服务器的 plugins/ 目录。
- 启动服务器:运行你的 Paper 服务器(需要 Java 21+)。
- 配置:如果需要世界过滤或调试日志,请编辑
plugins/NoCartExplosions/config.yml。
- 重载:使用
/nce reload 应用任何更改。
?️ 从源代码构建 (点击展开)
前置条件
- JDK 21+
- Apache Maven 3.9+
构建步骤
git clone https://github.com/your-repo/NoCartExplosions.git
cd NoCartExplosions
mvn clean package
编译后的输出将生成在 target/NoCartExplosions-1.0.0.jar 中。
? 许可证
本项目根据 MIT 许可证 授权。欢迎自由使用、修改和分发!

? NoCartExplosions
NoCartExplosions is a lightweight, zero-lag server plugin designed to stop TNT Minecarts from destroying blocks and terrain upon detonation while leaving Paper's default explosion damage to players, mobs, and items completely untouched.

[!IMPORTANT]
Protect your builds without breaking combat or redstone contraptions!
When a TNT Minecart detonates, 0 blocks are broken, but surrounding players and mobs take standard, vanilla-accurate explosion damage.
✨ Features
- ?️ Complete Block & Terrain Protection: Prevents TNT Minecarts from damaging blocks, breaking redstone, or cratering land.
- ? Preserves Paper Combat Mechanics: Entities (players, mobs, vehicles) still receive standard Paper explosion damage.
- ⚡ Ultra Lightweight & Performant: Event-driven Bukkit listener with minimal CPU footprint and zero tick loss.
- ? World Whitelisting: Restrict protection to specific worlds (e.g., survival, hub) or enable it server-wide.
- ? Live Hot-Reload: Update settings on the fly with
/nce reload without restarting your server.
- ☕ Modern Java 21 - 25: Built natively against Paper API 1.21.11 for peak performance.
? How It Works
| Feature |
Standard Minecraft |
With NoCartExplosions |
| Terrain Destruction |
? Destroys Blocks |
?️ 100% Protected |
| Entity Explosion Damage |
? Takes Damage |
? Preserved (Stock Paper) |
| Item Drop Damage |
? Items Destroyed |
?️ Protected |
| Performance Overhead |
⚠️ High (Block Physics Update) |
⚡ Zero Lag |
⚙️ Configuration (config.yml)
The default config.yml is simple and ready to use right out of the box:
# ======================================================
# NoCartExplosions Configuration
# ======================================================
# Toggle terrain protection for TNT Minecarts / Explosive Minecarts.
# When true, cart explosions will NOT break any blocks or alter terrain.
prevent-terrain-damage: true
# List of world names where cart terrain protection is active.
# Leave empty [] to enable protection across ALL worlds on the server.
# Example:
# enabled-worlds:
# - world
# - world_nether
enabled-worlds: []
# If set to true, logs a console message whenever a TNT Minecart explosion's terrain damage is prevented.
log-prevented-explosions: false
? Commands & Permissions
| Command |
Permission |
Description |
/nocartexplosions reload |
nocartexplosions.admin |
Reloads config.yml settings live |
/nce reload |
nocartexplosions.admin |
Short alias for reload command |
[!TIP]
Administrative permissions default to server operators (op: true).
? Installation & Setup
- Download: Grab the latest
.jar file from the Versions tab.
- Install: Drop
NoCartExplosions-1.0.0.jar into your server's plugins/ directory.
- Start Server: Run your Paper server (Java 21+ required).
- Configure: Edit
plugins/NoCartExplosions/config.yml if you want world filtering or debug logging.
- Reload: Use
/nce reload to apply any changes.
?️ Building from Source (Click to expand)
Prerequisites
- JDK 21+
- Apache Maven 3.9+
Build Steps
git clone https://github.com/your-repo/NoCartExplosions.git
cd NoCartExplosions
mvn clean package
The compiled output will be generated in target/NoCartExplosions-1.0.0.jar.
? License
This project is licensed under the MIT License. Feel free to use, modify, and distribute!

评论 0
登录后参与评分
还没有评论,来抢沙发吧