WorldListTrashCan

WorldListTrashCan - Refactored Version Changelog

I. Public Trash Can

1. New compact compact display mode

• Only one icon is shown for identical items.
• Cumulative quantity is displayed in item Lore.
• Maximum display lines of original Lore can be limited.
• Ellipsis hint will show automatically when exceeding line limit.
• Each item type accumulates up to 9999 by default.
• Set to -1 for unlimited quantity per item type.
• Left‑click takes out 1 item by default.
• Shift + Left‑click takes out 64 items by default.
• Take‑out amounts are configurable in config file.

2. Preserve stacked original stacking mode

• Keep vanilla 64/16/1 item stacking behaviour.
• compact and stacked use independent configuration nodes.
• Capacity and sorting settings of two modes do not interfere with each other.

3. Refactored public trash can storage

• GUI is no longer the real storage container for public trash can.
• Real storage and menu rendering are fully separated.
• Reduces extra overhead caused by menu refresh, page turning and item merging.
• When shrinking capacity, existing items go to read‑only overflow page.
• Overflow items remain viewable and retrievable, will NOT be silently deleted.

4. New per‑player independent sorting Each player may independently select sorting method below:

• Insertion order
• Quantity ascending
• Quantity descending
• Name sorting
• Material sorting

Sorting preference only persists during current player online session, will NOT be written to database. compact and stacked modes store their own separate sorting preferences.

5. Optimized menu refresh logic

• Sorting executes only on menu open or manual sort switch by player.
• Page turning and item taking use lightweight snapshot generated at menu opening.
• Sweep‑in items will not trigger unexpected re‑sort for currently viewing page.
• Different players can use different sorting modes simultaneously.

6. Extended layout buttons

• New type: close close button.
• New [close] action for actions node.
• Layout display items support glow: true enchant glow effect.
• Glow effect applies to page buttons, background, sort buttons, action buttons and close button.
• 1.20.5+ uses native pure glow effect.
• Older versions automatically fallback to hidden‑enchant implementation.

7. Fixed model‑id handling

• Minecraft 1.14+ reads and applies CustomModelData correctly.
• Minecraft 1.12.2 and 1.13 skip reading and parsing this field entirely.
• Fixed issue where configured model‑id button does not take effect on modern Paper builds.
• CustomModelData detection & cache runs only once at plugin startup, no repeated reflection in GUI hot path.

II. Item Recognition & Sweep Routing

1. New /wtc look inspection command Shows information of item held in hand:

• Material
• Item display name
• Lore
• PDC keys
• Raw NBT / Data Components keys

Helps server owners write accurate item match configurations.

2. New custom‑data‑based item routing Items can be matched by:

• Material
• Display name
• Lore
• PDC keys
• Raw NBT / Data Components keys

Match rules support * wildcard and are case‑insensitive.

3. Available handling options for matched custom items

• personal‑only: send item to personal trash can only
• keep‑ground: leave item on world ground
• direct‑remove: delete item directly

4. New public trash can entry whitelist Public trash can restricts incoming items by:

• Material
• Display name
• Lore
• PDC keys
• Raw NBT / Data Components keys

Whitelist applies to:

• World sweep collection
• Manual player item deposit
• Third‑party plugin API calls to public trash can

Swept items rejected by public trash can are configurable to:

• Remain on ground
• Be deleted directly

5. Optimized wildcard matching performance

• Wildcard rules are pre‑compiled on config load.
• Identical rules will not be re‑parsed in sweep hot path.
• Extra PDC / Raw NBT checks are skipped when custom‑data routing is disabled.

III. World Filter for Item Sweep

1. New include / exclude world filter Example:

world-filter: include: - "*" exclude: - "dungeon"

2. World name supports * wildcard

• Case‑insensitive.
• exclude takes higher priority than include.
• All worlds are allowed by default.
• Worlds whose name contains "dungeon" are protected by default.

3. World filter applies to:

• Scheduled world sweep
• /wtc clear true
• /wtc clear false

/wtc clear true only skips player‑count & entity‑count guards, it does NOT bypass world filter.

IV. Audit Add‑on Support

1. Precise item tracking keys added

• Each real storage entry inside public trash can gets its own independent tracking key.
• Homologous items in personal trash cans can also be precisely tracked.
• Sorting, page turning and display mode switching will not break tracking relation.

2. WorldListTrashCanAudit provides further information:

• Which trash can the item finally entered.
• Who took items out from public trash can.
• Whether personal‑trash‑can items have been retrieved.
• Owner, world and coordinates for world‑bound trash cans.
• Whether item was directly deleted.

3. Behaviour when Audit add‑on is not installed

• No extra database thread will be created.
• Unnecessary personal‑trash‑can identity hash calculation is skipped.
• Main plugin functions work normally without side‑effects.

V. Bug Fixes

1. Fixed repeated skip hint message when sweep guards conditions are not satisfied.

2. Fixed issue: after modifying personal‑trash.gui.title and running /wtc reload, already‑created personal trash cans still show old title.

• New title takes effect on next menu open.
• Existing items inside personal trash cans are preserved.

3. Fixed invalid public‑trash‑can model‑id on modern Paper versions.

4. Corrected low‑version compatibility boundary for model‑id.

• 1.12.2 and 1.13 ignore irrelevant configuration field.
• CustomModelData is only enabled starting from 1.14+.

5. Supplemented Chinese comments and function descriptions inside configuration files for different Minecraft versions.

VII. Update Summary

This major update refactors public trash can from fixed‑chest implementation to dedicated independent storage system. New features include dual display modes, per‑player independent sorting, stable pagination, capacity overflow protection, customizable layout buttons, cross‑version glow effect and full CustomModelData support.

The sweep system is enhanced with world filtering, custom‑data item recognition, fine‑grained item routing and public‑trash‑can entry whitelist control.

Besides, audit tracking capability is implemented. Multiple bugs are resolved: personal trash can title reload issue, repeated sweep‑guard hint spam, broken model‑id on modern Paper and other compatibility problems.