Overview
GriefHeal is a lightweight, modern restoration engine designed for competitive Factions and Survival servers. It was built from the ground up to replace aging plugins like CreeperHeal and CreeperHeal2, which often fail to handle modern 1.21.1 block states or cause massive TPS spikes.

Whether it’s a small Creeper hole or a massive TNT cannon nuke, GriefHeal handles it with a specialized "Gradual Healing" system that keeps your server at a steady 20.0 TPS.

Key Features

• SQLite Persistence [NEW]: All pending restorations are saved to a highly optimized, asynchronous local database. If your server crashes or restarts, GriefHeal remembers the damage and automatically heals the world on boot.
  
  
• ⏱️ Spatial Debouncing [NEW]: Smart timers detect TNT chain reactions. Explosions in the same area group together, and the heal timer won't start until the entire bombardment finishes.
  
  
• ️ Layered Priority Healing [NEW]: Craters heal smoothly from the outside-in. Solid blocks restore first, while fragile blocks (Redstone, Torches, Rails) are placed last to prevent physics updates from popping them off.
  
  
• ✨ Cinematic Aesthetics [NEW]: Restorations now feature a time-reversal effect using Reverse Portal particles and deep Beacon audio cues (fully toggleable).
  
  
• ️ Anti-Dupe Engine: Forced 0% item yield on all explosions. Players can't exploit TNT to farm free resources.
  
  
• ⚡ Java Optimized: Uses a blocks-per-tick restoration system. No more server-hanging "snapshot" lag.
  
  
• Container Support: Chests, Shulkers, and Barrels restore perfectly with their original contents (optional).
  
  
• Fire Healing: Automatically heals blocks destroyed by fire spread.
  
  
• ⚙️ Redstone Logic: Perfectly restores repeater delays, comparator states, and wire orientations.
  
  
• ️ World Blacklist: Easily disable healing in Creative, Hub, or Minigame worlds.
  

Commands & Permissions

• /gh - Displays the admin help menu. (griefheal.admin)
  
  
• /gh reload - Reloads the configuration. (griefheal.admin)
  
  
• /gh now - Force-restores all pending damage immediately. (griefheal.admin)
  

Installation

1. Drop GriefHeal.jar into your /plugins folder.
   
   
2. Restart your server.
   
   
3. Fine-tune your config.yml (Change restoration delays, visual effects, and blocks-per-tick as needed).
   
   
4. Enjoy a nuke-proof server!