**Version:** Snapshot 26w18a (v2.0.0-alpha-2)
**Date:** May 2, 2026
## Major Features
* **Multi-version support:** The plugin has been updated to run natively on multiple Minecraft versions, removing the strict dependency on a specific server version.
* **Folia compatibility:** The server platform is now automatically detected, ensuring full compatibility with both traditional Bukkit/Paper architectures and Folia-based servers.
* **Extended time format:** The timer system now supports and calculates full days. Formats for days, hours, minutes, and seconds have been separated, requiring an update to the messages in the `config.yml` file.
* **Probability system:** Chest repopulation now allows randomization and the use of custom probabilities for item spawning.
* **Improved data saving:** The method used to save and identify chest items was restructured, achieving greater storage stability.
## Hologram System & Performance
* **Strict environment validation:** Holograms are now directly bound to the physical existence of the chest. Upon server startup, the plugin will only load holograms if the corresponding block remains in the world. Additionally, a real-time check is performed right before displaying any hologram to a player.
* **Automatic cleanup:** An internal task was implemented that runs every 5 minutes. Its function is to find and remove orphaned holograms that have been left in the world without a valid chest.
* **Fault tolerance:** The hologram generation system no longer breaks the plugin's general workflow. If a creation error occurs, it is safely logged to the console without stopping other functions.
## Loot System Changes
* **Dynamic loot sequence:** The behavior when looting chests has been changed to be more fluid. Now, the regeneration timer starts silently the moment the first item is taken. The player can continue removing items, and the reload notification will only display upon closing the inventory if the chest is completely empty.
* **Loot detection modes:** Added the `chest-regen.loot-detection-mode` setting in the main configuration file.
* Available options: `on-open`, `on-empty`, and `on-loot`.
* The default value has been modified to `on-loot`.
* **Duplicate prevention:** An internal tracker was implemented to prevent rapid inventory actions from generating multiple timers for the same chest.
## Bug Fixes
* **Persistent holograms:** Fixed the bug that left holograms permanently floating in the world after the destruction of their associated chest.
* **Conversion and physical validation:** Fixed inconsistencies detected when converting chests to items. Multiple physical existence checks are now executed to prevent data desynchronization.
* **Permanent chests:** Solved an issue that applied cooldown checks to chests explicitly configured as permanent.
* **"on-empty" mode:** Fixed an error that caused full chests to reset or trigger timers simply by opening and closing them without taking items.
* **General stability:** Improved null data handling and removed obsolete configurations that caused performance conflicts in previous versions.
### Chest Logic & Systems
* **Instant Regeneration Cycle:** Fixed an issue where new chests required a server restart to begin cooldowns; timers now activate immediately upon creation via `/css savechest`.
* **Smart Drop Probability:** Set a 100% (1.0) default spawn rate for new chests, including a failsafe system to correct null or invalid config values and prevent empty containers.
* **Advanced Item Serialization:** Improved the saving system to correctly detect and store all item metadata, including enchantments above vanilla limits.
* **Real-time Inventory Sync:** Patched an inconsistency in the `/css upgradechest` command that prevented inventory updates if the chest was already on cooldown.
### Visuals & User Experience
* **Hologram Safety Toggle:** Changed the default state of holograms to `false` in both global settings and the creation assistant to prevent entity duplication or visual clipping.
* **Visual Cleanup Optimization:** Refined the `/css clearvisuals` command to ensure total removal of ArmorStands and particles for specific chests without affecting nearby entities.
* **Metadata Persistence:** Resolved a bug in the `ChestCreator` menu where items were being saved without their custom names or enchantments.
### Technical & Dev Updates
* **Semantic Versioning:** Project version officially updated to `1.1.0-ALPHA` to align with standardized testing and release protocols.
* **Maven Resource Filtering:** Updated `pom.xml` to enable automatic version synchronization between the build file and `plugin.yml`.
* **Runtime Data Fixes:** Fixed a critical error in `ChestManager` that prevented regeneration times from loading correctly from `chest.yml` during execution.
### Alpha Release Notes
> **Warning:** This is a testing version. It is highly recommended to back up your `chest.yml` before upgrading, as the item serialization format has been significantly enhanced.
#### Added
* **Base Version Migration**: Successfully updated the base version to **1.8.8**.
#### Changed
* **GUI Compatibility**: Refactored the Graphical User Interface to align with the requirements of version 1.8.8.
* **Timer System**: Modified the internal timer logic to improve synchronization and performance within the new base environment.
* **Configuration Files**: Updated all **.yml** files to the new format to ensure full compatibility with the current system architecture.
**✅ Correcciones:**
- Se solucionaron errores en los hologramas que causaban visualizaciones incorrectas o inconsistentes.
- Corrección de problemas relacionados con las ubicaciones de los cofres.
- Solucionado un fallo en los archivos `.yml` que provocaba conflictos en la carga de configuraciones.
- Mejoras y correcciones en algunos menús existentes.
**🆕 Novedades:**
- Nuevos menús añadidos para ampliar la funcionalidad.
- Se añadieron partículas personalizadas para una experiencia visual más atractiva.
---
**En:**
**✅ Fixes:**
- Fixed issues with holograms displaying incorrectly or inconsistently.
- Corrected problems with chest locations not aligning properly.
- Resolved a `.yml` configuration loading error.
- Improved and fixed some existing menus.
**🆕 Additions:**
- Added new menus to expand functionality.
- Introduced custom particle effects for enhanced visuals.
**Es:**
• Bugs arreglados.
• Mejoras en la gestión del temporizador.
• Se agregó soporte para cofres aleatorios, con una nueva función y un archivo .yml dedicado.
• Optimización de archivos de configuración (.yml) y mejoras en la documentación para mayor claridad y evitar confusiones.
• Reajustes internos en varias funciones del plugin.
• Compatibilidad ampliada: ahora funciona desde la versión 1.21.5 hasta la 1.8 de Minecraft.
• Corrección de bugs menores para mayor estabilidad.
• Desactivación temporal de menús tras múltiples fallos para evitar errores encadenados.
• Mejoras visuales en hologramas y mensajes del sistema para una experiencia más clara y pulida.
**In:**
• Bugs fixed.
• Improvements to timer management.
• Added support for random chests, with a new function and a dedicated .yml file.
• Configuration file (.yml) optimizations and documentation improvements for clarity and to avoid confusion.
• Internal adjustments to several plugin features.
• Expanded compatibility: now supports Minecraft versions 1.21.5 through 1.8.
• Minor bug fixes for improved stability.
• Temporary menu disabling after multiple errors to prevent cascading failures.
• Visual enhancements to holograms and system messages for a clearer, more polished experience.
**Es:**
• Mejoras en la gestión del temporizador.
• Se agregó soporte para cofres aleatorios, con una nueva función y un archivo .yml dedicado.
• Optimización de archivos de configuración (.yml) y mejoras en la documentación para mayor claridad y evitar confusiones.
• Reajustes internos en varias funciones del plugin.
• Compatibilidad ampliada: ahora funciona desde la versión 1.21.4 hasta la 1.8 de Minecraft.
• Corrección de bugs menores para mayor estabilidad.
• Desactivación temporal de menús tras múltiples fallos para evitar errores encadenados.
• Mejoras visuales en hologramas y mensajes del sistema para una experiencia más clara y pulida.
**In:**
• Improvements to timer management.
• Added support for random chests, with a new function and a dedicated .yml file.
• Configuration file (.yml) optimizations and documentation improvements for clarity and to avoid confusion.
• Internal adjustments to several plugin features.
• Expanded compatibility: now supports Minecraft versions 1.21.4 through 1.8.
• Minor bug fixes for improved stability.
• Temporary menu disabling after multiple errors to prevent cascading failures.
• Visual enhancements to holograms and system messages for a clearer, more polished experience.
