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

1. Download the latest release
2. Place the JAR file in your server's plugins folder
3. Restart or reload your server
4. Configuration files will be created in plugins/kaizen/kaizen-torches/

Usage

Upgrading Torches

1. Place a regular torch (or soul torch)
2. 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.