LeafWE v5.1.2: The Immersion & Security Update!

This is a major update combining changes from v5.1.1 and v5.1.2. We have significantly reduced the file
size, expanded protection support, and added beautiful immersive details to the building process.

New Features (Immersion & UX)

* Localized Block Names: No more raw technical names like BIRCH_SLAB! The progress bar now displays
block names in the player's client language (e.g., "Placing Birch Slab" or "Placing Huş Ağacı Basamağı").
* ✨ Interactive Wand Selection:
* Visuals & Sounds: Selecting positions now plays a satisfying sound and shows particle effects
(Position 1).
* Coordinates: Chat messages now include the exact (X, Y, Z) coordinates of your selection.
* Configurable: Don't like the sounds or particles? You can fully customize or disable them in
config.yml.
* Worker Sounds: The construction worker (ArmorStand) now plays realistic block placement sounds while
working.

️ Extended Protection Hooks

We have expanded our integration with popular protection plugins. Players can only edit areas they are
allowed to build in:
* ✅ Lands: Added support for BLOCK_PLACE flag checking.
* ✅ GriefPrevention: Added support for BuildTrust checking in claims.
* ✅ PlotSquared: Added support for plot ownership and permission checks.
* (Existing support for WorldGuard, SuperiorSkyblock2, and Towny remains unchanged.)

⚡ Performance & Technical Changes

* Massive File Size Reduction: We switched to the Library Loader system. The .jar file is now incredibly
small (~200KB). Dependencies (SQLite, HikariCP) are downloaded automatically by your server on the first
startup.
* SQLite Driver Fix: Fixed a No suitable driver found error that occurred on some server setups.
* ️ Refactored Codebase: The entire project structure has been modernized for better stability and future
updates.
* Bug Fixes: Fixed NoClassDefFoundError issues when certain hooks (like Lands) were not installed on the
server.

---

How to Update:
1. Delete your old LeafWE.jar.
2. Upload the new v5.1.2 jar.
3. Restart your server.
4. (Optional) Check config.yml to customize the new wand-selection-effects.

GitHub & Source Code: https://github.com/KAREBLOK/leafwe ( https://github.com/KAREBLOK/leafwe)

LeafWE is now faster, smarter, and more scalable than ever!
This version includes a full backend rewrite and delivers the most requested features from the community.

⚙️ Performance Improvements:

Feature	Before	After
Data Storage	YAML files	SQLite / MySQL
Disk I/O	Every operation	Batched (30s)
Memory Usage	All data in RAM	Cache (5min TTL)
Scalability	Poor	Excellent
Concurrent Access	Problematic	Thread-safe

✅ Community Feedback — Completed:

• 
  [+] ✔ Tab Completion system added
  [+] ✔ Central Command Manager implemented
  [+] ✔ Dynamic Version Management enabled
  [+] ✔ Singleton Registry Pattern applied
  [+] ✔ Modular Architecture complete
  [+] ✔ Removed Getter Boilerplate

Modern Architecture:

Feature	Before	After
Command Management	Each command separate	Central Manager
Tab Completion	None	Automatic
Error Handling	Scattered	Centralized
Add New Commands	Hard	Easy
Maintainability	Poor	Simple

Dynamic Improvements:

• /lwe undo now also cancels the worker NPC ✅
• Particles are automatically removed after inactivity ✅

New Core Systems:

Migration System:

• Version-controlled schema updates
• Auto-migration on startup
• Rollback support
• View with /lwe migration status

Advanced Async Architecture:

• Separate thread pools
• Retry with exponential backoff
• Real-time performance monitoring (/lwe status)

Stability & Safety:

• Auto-recovery on errors
• Circuit breaker crash protection
• Query timeout handling
• Memory usage tracking
• Detailed debug command: /lwe debug

New Commands:

• /lwe status – Monitor system health
• /lwe migration – Manage database migration
• /lwe debug – Debugging & diagnostics

Final Words:

LeafWE is now fully prepared for large-scale servers.
Thanks to this update, it's more stable, maintainable, and high-performance than ever before.

New Systems in LeafWE v4.0.3
Progress Bar System (Live Feedback)
Make every action feel alive!

• Real-time visual progress bar in the ActionBar
• Percentage, block count (e.g., 400/500), and time left (e.g., 2m 30s)
• Displays operation type (e.g., /set, /replace)
• Completion messages for success, cancel, or error

✅ Daily Limit System (User-Specific Quotas)
Give players controlled access to powerful tools!

• Group-based limits via permissions
• Daily auto-reset of limits
• Supports both block amount and operation count
• Use -1 for unlimited access
• Fully persistent (saved to file) and performance-optimized (cached)

New Admin Commands
Manage user limits effortlessly:

/lwe limits <player> → View your or others' limits
/lwe resetlimits <player> → Reset a player's limits
/lwe givelimits <player> <amount> → Give or reset bonus limits
New Permissions

• leafwe.limits.others – View other players' limits
• leafwe.resetlimits – Reset limits
• leafwe.givelimits – Give bonus usage

️ LeafWE v4.0.2 — Major Compatibility & Performance Update!
We’re back with one of our biggest updates yet! This version brings full support for the most popular protection and island systems, along with massive performance improvements and smarter behavior all around.

✅ New Plugin Support

• ✅ WorldGuard – Full region respect and block placement control
• ✅ SuperiorSkyblock – Seamless island boundaries & protection integration
• ✅ Towny – Native support for Towny plots and restrictions

Performance Upgrades

• 30% Less RAM Usage – Optimized backend logic
• Faster Command Execution – Smoother performance on large edits
• Crash Protection – Automatically catches and stops risky operations before they can impact the server

️ GUI & Usability Improvements

• Improved GUIs – Cleaner interfaces and faster menu responses
• Smart Validation – Detects invalid blocks/positions and prevents errors before they occur
• Better Feedback System – More informative action bar messages and visual cues

✨ And much more...
We’ve added dozens of bug fixes, under-the-hood tweaks, and QoL improvements to make LeafWE faster, safer, and more compatible than ever.

Have a suggestion or bug to report? Post it on the plugin page or join our Discord — we’re actively listening!

✨ New Feature: “Eyedropper” Tool (Blockstate Copying)
This feature will be a game changer for detailed builders!

• Instant Copying: By sneaking and right-clicking a block with your building wand, you can instantly copy not just the block type, but its full blockstate—like stair directions, fence connections, and more.
  
• Smart Pasting: When using commands like /set or /wall, the plugin now uses the saved blockstate to place blocks exactly as copied, including orientation and state.
  
• Immediate Feedback: When you copy a block, a message appears in the Action Bar showing what block was copied, along with a confirmation sound.
  
• Clear Memory: To cancel the copied state and return to normal placement, simply sneak and right-click the air.
  

GUI System Improvements
We've designed fully visual and interactive menus to remove the need for command typing.

• Inventory-Based GUI: When using /set or /wall without typing a block name, the plugin opens a menu displaying only the placeable blocks from your inventory. No more memorizing block names!
  
• Interactive /replace Menu: A special two-slot menu has been added for the /replace command, where you can select both the "old" and "new" block visually. Simply click a block from your inventory to assign it to the new block slot.
  
• Smart Memory: The /replace menu now remembers the last used “old block” and automatically fills it in for your next use—leaving only the new block selection up to you.

Added support for 1.19.x, 1.20.x versions.

The problem of blocks not coming back when using the /undo command has been solved.

✨ New "Worker" Animation & Customization

Lifelike Animation:
Now, when you use commands like /set or /wall, a personal worker NPC appears beside you. This worker teleports to each placement location, focuses on the task with head movement, and swings their arm to simulate actually placing the block!

Fully Customizable:

• Head: The worker’s head uses the skin of the player who issued the command.
• Equipment: They hold the block currently being placed.
• Armor: You can customize the color of their leather armor using any RGB value in the config.yml.
• Size & Positioning: You can now control the worker's size (small/big) and vertical offset (y-offset) from the config.yml.
  

Improvements & Enhancements

Single Worker Rule:
While a player has an active construction task, they cannot run another build command. This prevents bugs and reduces unnecessary load on the server, ensuring a more stable experience. A new warning message (task-already-running) has been added to the config.yml for this situation.

Commands and headings with Turkish support have been translated into English to make them easier to understand for international users.

Now with English language support and the ability to restrict it in any world you choose!

NEW FEATURES

• /wall <block> Command Added
  You can now build only the four outer walls of your selected area with a single command. Perfect for quickly outlining castles, buildings, or room structures.
  
  
• /replace <old_block> <new_block> Command Added
  One of the most requested features! This powerful command lets you replace only specific block types within your selection. Making adjustments in large areas has never been easier.

IMPROVEMENTS & ENHANCEMENTS

• Smart Command Assistant
  If you mistype or leave a command incomplete, the plugin no longer just shows “invalid usage”—it guides you!
  
  • Typing /wall will ask you to enter a block.
    
    
  • Typing /replace will walk you through by asking for the old and then the new block.
    You no longer need to memorize command syntax!
    
• Code Optimization & Security
  The plugin codebase has been migrated to the more modern and reliable Maven Shade Plugin.
  This ensures future updates are more stable and unused code is cleaned for better performance.

TECHNICAL CHANGES

• Plugin version has been bumped to 2.0.0 to reflect these major improvements.