Kaizen Torches

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

- Protection: Upgrade regular torches with Iron, Gold, Emerald, Amethyst, or Diamond to increase the mob-blocking radius - Protection: Prevents hostile mobs from spawning within the torch's radius (works in 3D sphere, underground included) - Protection: Glowing sphere particles with firework effects show the protected area - Protection: Works with both regular and soul torches - Protection: 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: - Diamond → 8 block radius (gray particles) - Diamond → 12 block radius (gold particles) - Diamond → 16 block radius (green particles) - Diamond → 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`

```yaml

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

- Java: 1.21+ - Java: Paper (or forks like Purpur) - Java: 21+

Building from Source

```bash

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.