
TorchLight
Transform your Minecraft torches into powerful, rechargeable light sources! TorchLight brings an innovative fuel-based lighting mechanic that creates dynamic light wherever you go.
📖About TorchLight
✨ Key Features
💡 Dynamic Lighting
Hold a torch and watch as dynamic light follows you everywhere
Light updates in real-time (10 ticks/0.5 seconds) for smooth movement
Enhanced brightness: Each torch in your hand provides 2x the normal light
Light radius expands with multiple torches (up to 5 blocks)
Automatically removes light blocks when you move away
⚡ Fuel System
Torches require fuel to stay lit
80 seconds of default fuel for new torches
Maximum capacity: 1000 seconds (over 16 minutes!)
Fuel drains only when torch is held and active
Your fuel level is saved automatically
🔧 Three Ways to Refuel
Quick Refuel (Right-Click)
Hold fuel in one hand and torch in the other
Right-click to add 1 fuel item at a time
Perfect for precise fuel management
Inventory Charging
Left-Click: Drop entire fuel stack on torch to charge completely
Right-Click: Add fuel one piece at a time
Visual and audio feedback for each charge
Drop & Charge
Throw torch and fuel items near each other
They automatically merge within 1.5 blocks
Spectacular particle effects and sounds!
👹 Monster Repelling
Lit torches push away hostile mobs
8 block default radius (configurable)
More torches = stronger push force
Keeps you safe while exploring caves!
🎨 Beautiful Effects
Flame and lava particles when charging
Sound effects for feedback
Action bar display showing fuel and torch count
Elegant message formatting with frames
🎮 Commands
CommandPermissionDescription/rtl or /rtorchlight-Show plugin info/rtl check-Check your current fuel level/rtl reloadrtorchlight.reloadReload configuration
⚙️ Configuration
yaml# Language (en, ru, or custom)
language: en
Starting fuel amount
default-charge: 80
Maximum fuel capacity
max-charge: 1000
Light level (1-15)
light-level: 15
Monster repel radius
repel-radius: 8.0
Auto-save interval (seconds)
save-interval: 300
Action bar display
actionbar:
enabled: true
message: "&6⚡ &eTorch Fuel: &a%time%s &8│ &7Torches: &fx%count%"
🔥 Fuel Values
Fuel TypeSeconds AddedCoal Block800sLava Bucket1000sDried Kelp Block400sCoal/Charcoal80s eachBoat60sPlanks/Logs15s eachFences/Signs10-15sWooden Tools10sWool5sSticks5sBooks10s
All vanilla burnable items are supported!
🌍 Multi-Language Support
English (en) - Full support
Russian (ru) - Полная поддержка
Custom language files supported
Beautiful formatted messages with ASCII frames
All messages fully customizable
🎯 How It Works
Get a torch - Any regular Minecraft torch
Add fuel - Use any burnable item (coal, planks, logs, etc.)
Hold the torch - Dynamic light appears around you instantly
Watch your fuel - Action bar shows remaining time
Refuel anytime - Multiple convenient charging methods
💡 Pro Tips:
Stack multiple torches for brighter light and larger radius
Use coal blocks for maximum efficiency (800s per block)
Check fuel with left-click or /rtl check
Fuel only drains when torch is actively held
Your fuel persists through server restarts
🛠️ Technical Details
Minecraft Version: 1.13+
Server Software: Spigot, Paper, Purpur
Dependencies: None required
Performance: Optimized with async tasks
Storage: YAML-based data persistence
Metrics: bStats integration (ID: 23456)
Performance Optimized:
Light updates every 0.5 seconds (not every tick)
Efficient concurrent data structures
Automatic cleanup of light blocks
Smart mob detection and repelling
📦 Installation
Download rTorchLight.jar
Place in your server's plugins folder
Restart or reload your server
Configure in plugins/rTorchLight/config.yml
Customize messages in language files
🎬 Perfect For:
Survival Servers - Add challenge with fuel management
Adventure Maps - Dynamic lighting for atmosphere
RPG Servers - Immersive exploration mechanics
Cave Exploration - Stay safe from monsters
Hardcore Worlds - Resource management matters
🐛 Support & Updates
Found a bug or have a suggestion? Let us know!
Report issues on the issue tracker
Join our community for support
Regular updates and improvements
📜 License & Credits
rTorchLight - Created with ❤️ for the Minecraft community
Features Summary:
✅ Real-time dynamic lighting
✅ Fuel-based torch system
✅ Monster repelling
✅ Multiple refueling methods
✅ Beautiful particle effects
✅ Multi-language support
✅ Highly configurable
✅ Performance optimized
✅ Persistent data storage
✅ No dependencies required
Download now and light up your world! 🔥