VirtualFilter
Last Update: v1.8.0 - FIXED 1.7.9 ISFE CORRUPTING SF MATERIALS

Main Features
│===========================================
│➜ ASF > ISF > ISFE > ABF > Inventory.
│➜ It means a item only will get on player inventory after check all filters.
│===========================================
│➜ NBT DNA Shield (Binary Serialization):
│➜ ISFE Binary Storage: Edited items are now stored as BLOB
│➜ (Binary Large Object). The plugin now captures the full "DNA"
│➜ of the item (all 14+ components, hidden enchantments,
│➜ and crafting tags) and restores them via binary serialization.
│➜ prices in prices.yml (Vanilla items only).
│➜ " Pick Block" Logic: When withdrawing an item, the plugin now
│➜ performs an identical clone of the original template, ensuring custom │➜ machines and external plugin processes recognize the item
│➜ immediately.
│➜ Dual-Datbase Architecture :
│➜ Risk Isolation: we have implemented simultaneous database
│➜ connections.
│➜ storage.db : Keeps your legacy data for ISF, ASF,
│➜ ABF, and Player Settings. (Untouched and Safe).
│➜ storage_edit.db : A brand new, high-performance binary
│➜ database exclusive for ISFE.

1. Safety Backup
Although we isolated the databases to ensure your original storage.db remains safe, always perform a full backup of the plugin folder before uploading the new JAR. Safety first!

2. Language & Config Reset
If you are updating from a very old version (below v1.7.0), we strongly recommend deleting the files messages_en.yml, messages_pt.yml, and config.yml.

• This version introduces new translation keys specifically for the ISFE system and new command routes that must be correctly mapped in the resource files.

3. Fresh Start for ISFE
Since the edited item system now uses a new binary database (storage_edit.db), your ISFE menu will appear empty at first.

• Items that were in the old ISFE (the "buggy" version) will not be migrated because they had already lost their properties. Please ask players to add their items again so the new system can capture their correct "DNA" (NBT) now.

️ Technical Changes

• Implementation of serializeAsBytes() for total component persistence on 1.21.1.
• Performance optimization: ISF (Vanilla) and ISFE (Edited) operations now run on separate database channels to prevent Database is Locked errors.
• FilterEngine Hardening: Edited items now bypass Vanilla filters to prevent accidental metadata wiping.

OLD CONTENT:

│➜ InfinityStack ( ISF): Infinite virtual storage for stackable
│➜ vanilla items, accessible by commands or GUI.
│➜ InfinityStackEdit ( ISFE): NEW! Infinite virtual storage
│➜ exclusive for EDITED items (Slimefun, RPG, Custom NBT).
│➜ AutoBlock ( ABF): Automatically blocks vanilla items from
│➜ entering the player's inventory.
│➜ AutoFillHand ( AFH): Integrated with ISF! Automatically refills your
│➜ hand with blocks from virtual storage while building.
│➜ SafeDrop ( SD): NEW! Toggles 10s protection for dropped items.
│➜ Shows countdown and instructions in chat when enabled.
│➜ Independent Logs: Full control via /lo (Personal) and /la
│➜ (Nearby players) logs. Shows player names and destinations.
│➜ AutoLoot & Magnet: Advanced 10-block radius item pickup with a
│➜ 2-second sound cooldown to prevent audio spam.
│➜ Bedrock & Geyser Focus: Full support for mobile/console players
│➜ via specific chat commands. ( /getisf <slotid> amount/pack/all )
│➜ Chest Guard System: Prevents item loss when breaking
│➜ containers. Processes items into ISF/ISFE or Inventory.
│➜ Smart Grouped Reports: Summarizes results into a single message
│➜ (ISF, ISFE, INV, or GROUND) showing the player's name.
│===========================================
│➜ Shulker Box Integrity: Complete protection for Shulker Boxes.
│===========================================
│➜ Shulker boxes now bypass all filters (ASF/ISF/ISFE/ABF) to
│➜ preserve internal NBT data and items when mined.
│➜ Smart Routing: Mined shulkers follow a priority path:
│➜ Inventory > EnderChest > Ground (Fallback).
│===========================================
│➜ Improved Localization: Fully updated messages_pt.yml and
│➜ messages_en.yml with new syntax and ISFE keys.

Commands
│➜ /vfhelp | /vf Opens the main help menu with all available features.
│➜ /isf | /asf | /abf | /isfe Opens the GUI for each specific
│➜ filter. Java and Backrock Players can Check Filters
│➜ /getisf | /getisfe < slotid> < amount| pack| all> Withdraws items from
│➜ ISF or ISFE using the Slot ID. (Essential for Bedrock players).
│➜ /addisf | /addasf | /addabf Adds the vanilla item in hand to filters.
│➜ /addisfe Adds the edited/custom item in hand to ISFE storage.
│➜ /remisf | /remasf | /remabf | /remisfe [slotid] Removes a filter.
│➜ The filter must be empty to be removed (Bedrock command)
│➜ Java players can remove filter clicking on Shift + Right Click
│➜ /al | /afh Toggles AutoLoot (pickup) or AutoFillHand (refill).
│➜ /lo | /la Toggles Personal Loot Report Own/All (Nearby).
│➜ /sd | /safedrop Toggles 10s drop protection for other players.
│➜ /vfat Toggles sale and refill notifications in the Action Bar.
│➜ /vflang Switches personal language between English (en) and
│➜ Portuguese (pt).
│➜ /vfreload virtualfilter.admin Reloads all configs (Admin only).

Permissions
│➜ virtualfilter.admin Permission for reload and admin commands.
│➜ virtualfilter.chestdebug Permission to toggle chest break reports.
│➜ virtualfilter.<filter>.<number> Slots available ISF/ ASF/ ABF/ ISFE

Important Notice
│➜ ISFE (Edited Storage) only accepts items with custom names.
│➜ Vanilla filters (ASF/ISF/ABF) now ignore all custom/edited items
│➜ to prevent NBT corruption (Slimefun compatibility).
│➜ Vault and a valid Economy plugin are required for AutoSell.
│➜ But the prices must be configurated in prices.yml
│➜ Remember to remove config.yml and messages_pt / en files to
│➜ update new files before start server when you put the new release on
│➜ plugins folder.
│➜ Always save database before updates for a backup | the database
│➜ will update safely but it's good you have a backup.