Consider white/blacklists (call them deny and allow lists) for zone detection, especially part detection

[1ForeverHD]

Consider using the terms 'allowlist' and 'denylist' or 'permitonlylist' and 'ignorelist'

Methods

• [ ] zone:setDenylist(array)
• [ ] zone:addToDenylist(instance)
• [ ] zone:removeFromDenylist(instance)
• [ ] zone:setAllowlist(array)
• [ ] zone:addToAllowlist(instance)
• [ ] zone:removeFromAllowlist(instance)

Properties

• [ ] zone.denylistDictionary
• [ ] zone.allowlistDictionary
• [ ] zone.denylistArray
• [ ] zone.allowlistArray

To do:

• [ ] When adding instances to a list...
  • [ ] If isA basePart, then add instance to dictionary
  • [ ] Iterate over descendants. If descendant is a basePart, also add that to dictionary
• [ ] Repeat same when removing from list
• [ ] If the allowlist is greater than 0, only permit instances (and their descendants) within that dictionary
• [ ] Consider also providing denylistArray and allowlistArray properties as these may be needed for the zone whitelist/blacklist
• [ ] Update documentation
• [ ] Change version and write up release notes

[1ForeverHD]

First:

• [x] Similar to :findPart, have the line 487 ZoneController skipped if all zones have allZonePartsAreBlocks set to true
  • [x] ORRRRRR find the associated zone and determine whether to do extra specifc check based on that
  • [x] if this is possible, consider a new constructor such as Zone.fromRegion(size, cframe)
  • [x] make sure as all zones that are blocks use bound checks instead of specific checks
• [x] for local boundParts = workspace:GetPartBoundsInBox(charCFrame, charSize, boundParams) see if its possible to check for parts not in workspace
• [x] Update docs methodology (3) to highlight these changes
• [x] Replace all mentions of region with new API within methodology
• [x] Repeat for rest of docs

I'm gonna change this actually to 'trackable items':

• [x] zone:trackItem(instance)
• [x] zone:untrackItem(instance)
• [x] if item destroyed (parented to nil), then untrack
• [x] zone.itemEntered
• [x] zone.itemExited
• [x] if is a container (i.e. a nonbasepart) then track its descendants instead. ensure entered is called when any descendant enters, while exit only calls when every descendant left
• [x] if find humanoidRootPart then only track that if detection is Centre
• [x] zone:findItem()
• [x] test
  • [x] fix erros
  • [x] ensure _preventMultiFrameUpdates works as intended
  • [x] localplayerevents
  • [x] playerevents
  • [x] test VOLUME reversals too
  • [x] also :findPlayer
  • [x] then finally itemevents
  • [x] test VOLUME reversals too
  • [x] also :findItem
• [x] Setup zombie moving example at playground

Bind groups

• [x] Create a zone method to categorise zones and limit a singular player signal being called until exited
  • [x] ZoneController.setGroup(groupName, properties)
  • [x] name
  • [x] zones
  • [x] limit
  • [x] ZoneController.getGroup(groupName)
  • [x] zone.onlyEnterOnceExitedAll= true -- this will restrict entered events for zones within this group from being fired if already within a zone in this group
  • [x] zone:bindToGroup(settingsGroupName) - if first, set new group. if self.settingsGroupName, then unbindFromGroup then continue. set groups zones [my UID] to zone.
  • [x] zone:unbindFromGroup(settingsGroupName)
• [x] Update AmbientZone to something simpler with the new methods
• [x] Test AbmbientZone and VoteMachine
• [x] Change default Detection to 'Centre'

Additional to do:

• [x] Remove mentions of raycasting
• [x] Update all descriptions to replace 'Region checking' with 'Params'
• [x] Ensure all new methods/events have been added to src docs
• [x] Consider changing theming to purple

Final to do:

• [ ] FilterDescendantInstances should be FilterDescendantsInstances
• [ ] RaycastFilterType should be FilterType
• [ ] Any future plans to support detection outside of workspace? An OverlapParams property could be introduced for example to make this behaviour optional.