Welcome to ExplosionProtector Discussions!

[K2zik]

💬 Welcome to the ExplosionProtector Discussion!

Hello everyone! Welcome to the official discussion thread for ExplosionProtector, an addon for CoreProtect that keeps player‑placed blocks safe from blasts. Whether you’d like to report bugs, suggest features, or share your experiences, this is the place!

---

🔍 Overview

ExplosionProtector hooks into CoreProtect’s API to determine block origins. When an explosion (TNT, creeper, or other) occurs:

1. Gather the list of affected blocks.
2. For each block, query CoreProtect:
   • If it was placed by a player → protect it.
   • If it wasn’t placed by a player (e.g., naturally generated or WorldEdit) → allow normal destruction.
   • TNT blocks always break to preserve explosion behavior.

---

🚀 Features

• Player‑Block Protection
  Only preserves blocks you’ve placed yourself—no accidental “over‑protection” of natural terrain.
• Lightweight & Efficient
  Minimal performance impact, ideal for large servers and heavy explosions.
• Simple Configuration
  Toggle TNT protection and adjust log levels via config.yml.

---

⚙️ Installation

1. Place ExplosionProtector.jar in your server’s plugins/ directory alongside CoreProtect (v10+).
2. Restart or reload your server.
3. (Optional) Edit plugins/ExplosionProtector/config.yml to customize settings.

# plugins/ExplosionProtector/config.yml
protect-tnt: false    # true to protect player-placed TNT too
log-level: INFO       # DEBUG for troubleshooting

---

🐞 Bug Reports

When opening a Bug Report, please include:

1. Server version (e.g. Paper 1.18.2)
2. CoreProtect version (v10+).
3. Explosion type (TNT, creeper, etc.).
4. What happened vs. expected behavior.
5. Relevant server logs (linked via Gist if large).

---

💡 Feature Requests

For Feature Requests, share:

1. Description of the desired feature.
2. Use case—how it benefits your server.
3. Configuration ideas, if any.

---

🤝 Contributing

We welcome pull requests! To contribute:

1. Fork the repository and clone locally.
2. Target Java 8+ (Spigot/Paper 1.13+).
3. Write unit tests for new functionality.
4. Update README and configuration examples.
5. Submit a PR targeting the main branch.

---

🙏 Acknowledgments

Thanks to the CoreProtect team for their robust API and to all community members who’ve tested and provided feedback so far!

---

Drop your questions, feedback, and suggestions below. Let’s make building on your server blast‑proof!