Skip to content

mattymatty97/carpet-shadow

Repository files navigation

Carpet Shadow

carpet extension to fix various bugs related to shadow item stacks

Carpet Settings

  • shadowItemMode what should happen to shadow items when saved and re-loaded from disk?

    • UNLINK ( vanilla default = dupe them )
    • PERSIST ( shadow items will re-link once re-load )
    • VANISH ( shadow items will disappear when re-load )
  • shadowItemTooltip

    shows the shadow stack unique identifier when hovering over a shadow stack with the mouse

  • shadowItemFragilityFixes

    various fixes to item related actions that might unlink/dupe/delete the shadow stacks

  • shadowItemUpdateFix

    inventory updates from shadow items will propagate to the other shadow item stacks even if in other invenotories

  • shadowItemPreventCombine

    by default instances of the same shadow stack won't merge on inventory actions; this option expands that behavior and prevents merging operations between any shadow stack

    PS: this option only has an effect if shadowItemFragilityFixes is active

  • shadowItemIdSize

    changes the length of the shadow stack unique identifiers

    PS: do not edit unless you know what you're doing

Feature List

  • Shadow Item Persistence/Removal
    • Server Restarts
    • Player Join/Leave
    • Chunk Unload/Reload
    • Shulker Box Break/Place
    • Bundle add/remove ( To be tested )
  • Fragility Fixes
    • Player Pick-Up shadow stacks from Item Entities
    • Mouse Pickup and Place shadow stacks
    • Shift Click shadow stacks ( will only transfer them entirely w/o merging )
    • Quick Craft with/to shadow stacks ( simply disallowed )
    • Hoppers
      • Fail to pull from shadow stacks
    • Droppers
      • Unlinking on transfer to Inventory
  • Inventory Uodates
    • propagation of updates after the world tick

Known Bugs

  • General
    • MINOR: this mod only tracks shadow items that get generated with update suppression and the item swap operation, if another method of generating a shadow item is found this mod will not work.
  • Persistence
    • MINOR: when the mod generates a new shadow ID it only performs a check on the currently loaded IDs so there is a very small chance of overlapping IDs
    • MINOR: if two instances of a shadow item get unloaded with different amounts, the stack count will be of the first instance to get loaded back
  • Fragility
    • MAJOR: opening creative inventory will unlink and duplicate all the shadow stacks in the current inventory
  • Tooltips
    • MINOR: on servers the tooltips are sent to the clients as LORE nbt tags; this mod will strip them down on the clientside but non modded clients will see some de-synced lores while performing item movements/splits in inventories
    • MAJOR (Unconfirmed): non modded creative inventory might behave strangely if tooltips are active on server