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 - **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> ` | 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 - **Minecraft**: 1.21+ - **Server**: 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.