Kaizen Torches
一个 Minecraft Paper 插件,允许玩家使用矿石升级火把,以创建具有惊艳粒子效果的生物生成阻挡区域。
功能
- 火把升级:使用铁、金、绿宝石、紫水晶或钻石升级普通火把,以增加生物阻挡半径
- 生物生成阻挡:阻止敌对生物在火把半径内生成(支持 3D 球形范围,包括地下)
- 精美粒子效果:发光的球体粒子配合烟花效果显示受保护的区域
- 灵魂火把支持:同时适用于普通火把和灵魂火把
- 可配置:完全自定义半径、粒子数量和行为
- 保护机制:Kaizen 火把不能被活塞推动,并且在被破坏时会掉落其升级材料
安装
- 下载最新版本
- 将 JAR 文件放入服务器的
plugins 文件夹中
- 重启或重新加载服务器
- 配置文件将在
plugins/kaizen/kaizen-torches/ 中创建
使用方法
升级火把
- 放置一个普通火把(或灵魂火把)
- 手持升级材料右键点击火把:
- 铁锭 → 8 格半径(灰色粒子)
- 金锭 → 12 格半径(金色粒子)
- 绿宝石 → 16 格半径(绿色粒子)
- 紫水晶碎片 → 20 格半径(紫色粒子)
- 钻石 → 24 格半径(青色粒子)
你可以直接升级到任意等级(无需逐级升级)。
切换粒子效果
- 空手 Shift + 右键 点击 Kaizen 火把可以开启或关闭半径粒子效果
- 火把本身的发光粒子始终可见,用于识别已升级的火把
破坏火把
当你破坏 Kaizen 火把时,升级材料会被掉落回来。
命令
| 命令 |
描述 |
权限 |
/ktorches toggle <radius> [on|off] |
切换指定半径内所有火把的粒子效果 |
kaizen.torches.toggle |
/ktorches reload |
重新加载配置 |
kaizen.torches.reload |
/ktorches list |
列出所有 Kaizen 火把 |
kaizen.torches.list |
/ktorches help |
显示帮助信息 |
- |
别名: /kt, /kaizentorches
权限
| 权限节点 |
描述 |
默认值 |
kaizen.torches.* |
所有权限 |
op |
kaizen.torches.upgrade |
使用矿石升级火把 |
true |
kaizen.torches.use |
使用 Kaizen 火把(切换粒子效果) |
true |
kaizen.torches.toggle |
通过命令切换粒子效果 |
op |
kaizen.torches.reload |
重新加载配置 |
op |
kaizen.torches.list |
列出所有火把 |
op |
配置
配置文件位置:plugins/kaizen/kaizen-torches/config.yml
# 常规设置
general:
messages-enabled: true # 启用/禁用插件消息
sounds-enabled: true # 启用/禁用音效
drop-on-destroy: true # 破坏时掉落升级材料
prevent-piston-move: true # 防止活塞移动火把
# 粒子设置
particles:
enabled: true # 启用/禁用所有粒子效果
max-sphere-particles: 80 # 球体最大粒子数(推荐 40-120)
max-torch-particles: 6 # 火把周围的粒子数
default-enabled: true # 默认显示半径粒子效果
# 生物生成阻挡
mob-blocking:
enabled: true # 启用生物生成阻挡
block-spawner-spawns: false # 阻挡刷怪笼生成
block-egg-spawns: false # 阻挡生成蛋生成
# 各等级半径(单位:格)
tiers:
iron:
radius: 8
gold:
radius: 12
emerald:
radius: 16
amethyst:
radius: 20
diamond:
radius: 24
数据存储
火把数据存储在:plugins/kaizen/kaizen-torches/torches.yml
依赖要求
- Minecraft: 1.21+
- 服务端: Paper(或其分支如 Purpur)
- Java: 21+
从源代码构建
# 克隆仓库
git clone https://github.com/kaizen/kaizen-torches.git
# 使用 Gradle 构建
./gradlew build
# 运行测试服务器
./gradlew runServer
编译后的 JAR 文件位于 build/libs/ 目录中。
支持
如有问题或功能请求,请在 GitHub 上提交 Issue。
许可证
MIT License - 欢迎根据需要进行使用和修改。
Kaizen Torches
A Minecraft Paper plugin that allows players to upgrade torches with ores to create mob-spawn blocking zones with stunning particle effects.
Features
- Torch Upgrades: Upgrade regular torches with Iron, Gold, Emerald, Amethyst, or Diamond to increase the mob-blocking radius
- Mob Spawn Blocking: Prevents hostile mobs from spawning within the torch's radius (works in 3D sphere, underground included)
- Beautiful Particles: Glowing sphere particles with firework effects show the protected area
- Soul Torch Support: Works with both regular and soul torches
- Configurable: Fully customizable radius, particle counts, and behavior
- Protection: Kaizen torches cannot be moved by pistons and drop their upgrade material when destroyed
Installation
- Download the latest release
- Place the JAR file in your server's
plugins folder
- Restart or reload your server
- Configuration files will be created in
plugins/kaizen/kaizen-torches/
Usage
Upgrading Torches
- Place a regular torch (or soul torch)
- Right-click the torch while holding an upgrade material:
- Iron Ingot → 8 block radius (gray particles)
- Gold Ingot → 12 block radius (gold particles)
- Emerald → 16 block radius (green particles)
- Amethyst Shard → 20 block radius (purple particles)
- Diamond → 24 block radius (cyan particles)
You can upgrade directly to any tier (no need to go through each level).
Toggle Particles
- Shift + Right-click (empty hand) on a Kaizen torch to toggle radius particles on/off
- The torch glow particles always remain visible to identify upgraded torches
Breaking Torches
When you break a Kaizen torch, the upgrade material is dropped back.
Commands
| Command |
Description |
Permission |
/ktorches toggle <radius> [on|off] |
Toggle particles for all torches within radius |
kaizen.torches.toggle |
/ktorches reload |
Reload configuration |
kaizen.torches.reload |
/ktorches list |
List all Kaizen torches |
kaizen.torches.list |
/ktorches help |
Show help |
- |
Aliases: /kt, /kaizentorches
Permissions
| Permission |
Description |
Default |
kaizen.torches.* |
All permissions |
op |
kaizen.torches.upgrade |
Upgrade torches with ores |
true |
kaizen.torches.use |
Use Kaizen torches (toggle particles) |
true |
kaizen.torches.toggle |
Toggle particles via command |
op |
kaizen.torches.reload |
Reload configuration |
op |
kaizen.torches.list |
List all torches |
op |
Configuration
Configuration file location: plugins/kaizen/kaizen-torches/config.yml
# General settings
general:
messages-enabled: true # Enable/disable plugin messages
sounds-enabled: true # Enable/disable sounds
drop-on-destroy: true # Drop upgrade material when destroyed
prevent-piston-move: true # Prevent pistons from moving torches
# Particle settings
particles:
enabled: true # Enable/disable all particles
max-sphere-particles: 80 # Max particles for sphere (40-120 recommended)
max-torch-particles: 6 # Particles around the torch
default-enabled: true # Show radius particles by default
# Mob spawn blocking
mob-blocking:
enabled: true # Enable mob blocking
block-spawner-spawns: false # Block spawner spawns
block-egg-spawns: false # Block spawn egg spawns
# Tier radius (in blocks)
tiers:
iron:
radius: 8
gold:
radius: 12
emerald:
radius: 16
amethyst:
radius: 20
diamond:
radius: 24
Data Storage
Torch data is stored in: plugins/kaizen/kaizen-torches/torches.yml
Requirements
- Minecraft: 1.21+
- Server: Paper (or forks like Purpur)
- Java: 21+
Building from Source
# Clone the repository
git clone https://github.com/kaizen/kaizen-torches.git
# Build with Gradle
./gradlew build
# Run test server
./gradlew runServer
The compiled JAR will be in build/libs/
Support
For issues and feature requests, please open an issue on GitHub.
License
MIT License - feel free to use and modify as needed.
评论 0
登录后参与评分
还没有评论,来抢沙发吧