# 🌙 xBloodMoon v1.0.1 > A major quality update bringing a fully customizable item system, clean architecture, smart tab completion and improved persistence. --- ## ✨ What's New ### Custom Items System (`items.yml`) - Brand-new `items.yml` file — fully editable, hot-reloaded with `/bm reload`. - **BasHead support** — set `material: "basehead-<base64>"` to use any custom skull texture from [minecraft-heads.com](https://minecraft-heads.com). - **Glow effect** — `glow: true` adds a shimmer without showing fake enchantments. - **HEX color support** — use `&#FF0000` anywhere in `name` or `lore`. - **Item flags** — `HIDE_ALL` or individual flags (`HIDE_ENCHANTS`, `HIDE_ATTRIBUTES`, etc.). - **Enchantments** — any vanilla enchantment at any level, hidden or visible. - **Drop sound** — plays a configurable sound at the mob's location when the item drops. - **Drop chance** — moved from `config.yml` to `items.yml`, per-item. ### Persistent Kill Data - Kill counters are saved to `data/kills.yml` after each kill. - Data survives server restarts and is cleared automatically after the event ends. --- ## 🐛 Bug Fixes - Fixed `NullPointerException` when WorldGuard is absent. - Fixed `stopAll()` iterating over a live set by using a defensive copy. - Fixed permission check not reading dynamically from config on each command call. --- ## 📦 Requirements - **Server:** PaperMC 1.19.4+ (Forks supported) - **Java:** 17 or higher - **WorldGuard:** Optional — 7.0.8+ for region protection --- *Built with ❤️ by xPlugins*

# 🌙 xBloodMoon v1.0.0 — Initial Release > The first official release of **xBloodMoon** — an advanced, zero-lag Blood Moon event system for PaperMC servers. --- ## ✨ What's New ### Core Event System - Random Blood Moon trigger at nightfall with configurable probability (0–100%). - Configurable start and end time via `bloodmoon.start-time` and `bloodmoon.end-time` in `config.yml`. - Supports multiple worlds and a `blocked-worlds` list to prevent the event entirely. ### Anti-Lag Engine - Strict mob-per-chunk cap to prevent entity overflow during the event. - Automatic disabling of mob item pickup to reduce CPU overhead. - Explosion block damage suppression during the event. ### Entity Modifiers - Configurable attack damage multiplier for hostile mobs. - Configurable movement speed multiplier. - Configurable drop chance for custom **Blood Essence** items. ### Ambient Particles - Ambient red dust particles (`REDSTONE`) spawned around all players in active worlds. - Particle task runs asynchronously via `BukkitRunnable` — zero TPS impact. - Automatically enables and stops with the event. ### Top Killers Leaderboard - Post-event broadcast with a fully customizable leaderboard (up to 10+ positions). - Persistent kill data saved to `data/kills.yml` — survives server restarts. - Supports HEX color codes and placeholders. ### Discord Webhook Integration - Async webhook support for Blood Moon start and end notifications. - Fully customizable embed title, color, bot name and avatar URL. - Can be enabled or disabled in `config.yml`. ### WorldGuard Compatibility - Soft-dependency hook — works with or without WorldGuard installed. - Respects regions where `mob-spawning` flag is set to `DENY`. ### Commands & Tab Completion - `/bm start` — Force-start the Blood Moon (sets world time to night). - `/bm stop` — Stop the event and broadcast the Top Killers. - `/bm reload` — Hot-reload all configuration and language files. - `/bm help` — Contextual help menu (admin view / player view). - Full **TabCompleter** support — subcommands auto-complete in chat. ### Permissions System - Admin permission fully configurable in `config.yml` under `permissions.admin`. - Set to `"default"` or `"none"` to allow all players to use admin commands. ### Multilingual Support - Default configuration in **English**. - **Spanish VIP** config included inside `build/Config Español/`. - Full HEX (`&#FF0000`) and classic (`&c`) color code support in all messages. --- ## 📦 Requirements - **Server:** PaperMC 1.19.4+ (Forks supported) - **Java:** 17 or higher - **WorldGuard:** Optional — 7.0.8+ for region protection --- ## 🐛 Known Issues - None at this time. Please report any bugs on the project's issue tracker. --- *Built with ❤️ by xPlugins*