What a bag is
A bag is a utility piece that stores pieces internally and supports random draw behavior.
How the system uses bags
- bags are containers inside the piece family
- they are used when hidden or randomized retrieval matters more than visible order
- they keep piece containment in the standard table workflow instead of requiring a separate subsystem
- a bag holds at most 2,000 pieces. Putting in more, or restoring a bag from the trash that would come back holding more, is refused with a message saying so
Triggers
Bags support reactive triggers that fire when pieces move in or out:
- Piece Added -- fires when a piece is added to the bag
- Piece Removed -- fires when a piece is drawn from the bag
Bag triggers can filter by piece type and tags. See Triggers for full details.