ВЕРСИИ (6)

# FIXED WORLDGUARD ISSUE STOPPING ANY CONTAINER BEING FILLED

## [4.4.3] - 2026-10-11 Includes all changes since the published 4.2.0 release. ### Added - **Console and Direct Filling**: Fill containers directly from console, command blocks or in-game commands using a world, coordinates, radius and loot source. - **Saved Areas**: Save radius or cuboid selections with their world, loot source and container types. Manage them through commands or a menu with search, favourites and last-operation results. - **Operation Review**: Review the selected area, loot table, container types and Skip/Replace setting before starting a bulk fill. - **Sample Loot Preview**: View actual generated items in a read-only inventory, including names, lore and enchantments, with Reroll, Use This Table and Back controls. - **Job Management**: Added status, cancellation, detailed results and player boss bars showing loading, inspection and filling phases. Console receives periodic progress updates. - **Preview and Undo**: Inspect how many containers would be filled without changing them. Undo fills and clears, including partial or cancelled operations, while skipping inventories changed afterwards. - **Persistent History**: Optionally retain undo records and recent results across restarts, with configurable expiry and storage limits. - **Scheduled Restocking**: Automatically refill saved areas at configured intervals, with pause controls, cooldowns and Skip/Replace settings. Scheduling is disabled by default. - **Mixed Loot Tiers and Container Assignments**: Mix common, rare and jackpot tables within an area, or assign a specific loot source to an individual container. - **Loot Balancing Tools**: Added separate selection weights, drop chances and quantity ranges, plus simulation reports showing item frequency, average quantities and empty results. - **Container Filters**: Target chests, barrels, shulker boxes or selected container materials. Shared double-chest inventories are processed once. - **Permissions and Integrations**: Added per-area permissions, vanilla lock checks, optional WorldGuard protection, cancellable container-access events and job started/finished events for other plugins. - **Table Management Commands**: List, validate and sample loot tables, and reload settings, tables and saved areas when jobs are idle. ### Changed - **Cleaner Container Browser**: Simplified labels to names such as Chest • Empty and Barrel • Filled. Coordinates, distance and available actions now appear in tooltips. - **Simplified Menu Controls**: Previous, Filter, Sort, Fill and Next remain visible. Clear, Refresh, Undo and job controls are grouped in an Actions menu, with separate confirmation for destructive operations. - **Consistent Colours and Feedback**: Teal navigation, mint success, orange primary actions and red destructive actions, with quiet, configurable menu sounds. - **Optimized Filling Engine**: Reduced repeated container snapshots, inventory copies and writes. Each successful fill now replaces its inventory once. - **Chunk Preloading**: Fast asynchronous jobs load up to 16 selected chunks ahead, configurable up to 32. Barrels and single chests avoid unnecessary neighboring chunk loads. - **Improved Loot Preparation**: Custom tables are prepared once per job/table, only relevant tables are copied, and repeated random-selection setup is reused. - **Faster Default Processing**: Fast mode allows up to 10,000 shared operations within a 25 ms tick budget. Older default configurations upgrade automatically; legacy speed controls remain available. - **Unlimited Selection Size**: Removed plugin limits on area radius, cuboid size, total chunks and container counts. Large selections are traversed lazily, while workload, concurrency and storage controls remain active. - **Clearer Results**: Reports distinguish successful changes, skips, container failures and chunk failures, with elapsed time, container work and chunk-wait timing. - **Safer Existing-Item Handling**: Fills skip occupied containers by default. Replacing contents requires an explicit option and overwrite permission. - **VexorCore.studios Branding**: Updated plugin author, website and package metadata to VexorCore.studios. ### Fixed - **Random Loot Failures**: Unstackable items such as swords no longer cause invalid quantity errors during random generation. - **Pending Vanilla Loot**: Filling clears pending loot-table metadata so opening a container cannot replace its new contents. Undo restores the original metadata. - **Chunk Loading and Cleanup**: Failed or timed-out loads no longer leave jobs waiting indefinitely. Temporary chunk tickets are released on completion, cancellation, failure and shutdown. - **Double-Chest Handling**: Shared inventories are deduplicated, and boundary chests retain their required chunks while loading and filling. - **Undo Storage Exhaustion**: Filling and clearing continue when retained undo storage is full. Results identify changes without undo coverage, while failed changes still use immediate rollback. - **Menu Interaction Safety**: Read-only previews block item transfers, lower-inventory clicks cannot activate menu controls, and returning to menus restores their listeners. - **Editor and Table Reliability**: Copies and renames preserve table settings and item data. Invalid table files report actionable errors, and renaming saves the replacement before removing the original. - **Browser Responsiveness**: Filtering and sorting use scan results instead of synchronously reloading every discovered chunk. ### Console Examples Run these commands without a leading slash in console. Replace `world` with your world name. Coordinates come before the radius. **Fill chests and barrels within 150 blocks of X 427, Y 147, Z -362 with mineshaft loot:** ```text fillloot fill world 427 147 -362 150 vanilla minecraft:chests/abandoned_mineshaft --types=chests,barrels ``` Existing items are skipped by default. **To replace their contents:** ```text fillloot fill world 427 147 -362 150 vanilla minecraft:chests/abandoned_mineshaft --types=chests,barrels --overwrite ``` Vanilla table names use namespaced paths such as `minecraft:chests/abandoned_mineshaft`, rather than `chests.abandoned_mineshaft`. **Use an existing custom table named `starter_loot`:** ```text fillloot fill world 427 147 -362 150 custom starter_loot --types=chests,barrels ``` **Generate random loot:** ```text fillloot fill world 427 147 -362 150 random --types=chests,barrels ``` **Save the selection as an area, inspect eligible targets and fill it later:** ```text fillloot area create arena world 427 147 -362 150 vanilla minecraft:chests/abandoned_mineshaft --types=chests,barrels fillloot preview arena fillloot fill arena ``` **Check progress, cancel or undo a job** (replace `JOB_ID` with the ID reported when it starts): ```text fillloot status JOB_ID fillloot cancel JOB_ID fillloot undo JOB_ID ``` Cancellation stops further work. Undo restores retained snapshots of unchanged inventories; changes made beyond the undo-storage limit have no retained undo coverage. ### Compatibility - Requires **Paper 1.21.4** and **Java 21 or newer**. - Existing player commands and saved-data paths remain compatible. Integrations using the previous Java package must update their imports. - Restocking and persistent undo are optional. Undo remains bounded; reaching its storage limit does not stop a fill. - All inventory changes run on the main server thread. Actual fill time depends on chunk loading, loot complexity, protection integrations and server load.

## [4.2.0] - 2026-03-31 ### Added - **Enchanted Loot Generation**: Items generated via "Random Loot" (including enchanted books) now receive 1-3 random levels of appropriate enchantments. - **Enchantable Item Detection**: Added intelligent filtering to identify enchantable materials (swords, armor, tools, etc.) during procedural loot generation. ### Fixed - **Enchanted Book Persistence**: Migrated to Bukkit's robust `ItemStack` serialization for custom loot tables, resolving a critical issue where enchanted books lost their enchantments after saving. - **GUI Meta Preservation**: Fixed a bug where original item lore was stripped in the Editor and Preview GUIs; items now correctly show their native lore alongside plugin metadata. - **Serialization Reliability**: Items using modern 1.21 Data Components are now correctly handled across all save/load operations.

## [4.1.0] - 2026-03-11 ### Added - **Vanilla Loot Table Expansion**: Added over 50+ missing vanilla loot tables (Trial Chambers, Ancient Cities, Ocean Ruins, etc.). - **Category-Based Filtering**: Integrated category filters (Villages, Nether, End, Dungeons, etc.) into the Loot Selection GUI for faster navigation. - **Async Batched Scanning**: Completely refactored the radius scan engine to use Paper's Async Chunk API, allowing for massive radii (450+) without server lag. - **High-Speed Filling Engine**: Replaced the adaptive rate system with an aggressive 45ms per-tick time-budgeted queue. - **Progress Tracking**: Real-time percentage feedback for both scanning and filling operations. ### Changed - **Aesthetic Overhaul**: Migrated all system messages and GUIs to **MiniMessage** with a fresh color palette. - **Performance**: Removed artificial item-per-tick caps during filling, allowing thousands of containers to be processed in a single tick if performance allows. ### Fixed - **Tick Explosion Fix**: Implemented safety buffers to prevent server hangs during heavy vanilla loot generation (e.g., Treasure Maps). - **Watchdog Errors**: Resolved critical freezes that triggered server crashes on large scans.

## [3.0.0] - 2026-02-20 ### Added - **Improved SNBT Support**: Added support for modern Minecraft data component format in loot table configurations. - **Improved Documentation**: Updated all build guides and quick reference files. ### Fixed - **Item Metadata Parsing**: Custom items (swords, armor, etc.) now correctly load with their custom names, lore, enchantments, and other components in the GUI and when filling containers. ### Changed - **Version Upgrade**: Official move to v3.0.0 project structure.

- Interactive container browser GUI - 56 vanilla loot tables with pagination - Custom loot table system - Random loot generation - TPS adaptive filling - Async mode support - bStats integration - Filter & sort options - Bulk fill/clear operations