itolib

itolib

[![ Downloads](

)](

[![GitHub Releases](

)](

[![License](

)](

Wondrous gizmos and gadgets for the restless mind.

A collection of wacky scripts I've written for projects I'm involved in, most prominently Bozoros and PlayZone.

Everything's kept fairly abstract so it can be generally applied for many use cases. Feel free to add this to your project to play around with, if anything catches your eye!

• NOTE: Expect a few breaking changes here and there (at least while everything is being polished), should you choose to add this as a dependency.

• NOTE 2: This is not intended to be a JLL replacement and follows a pretty different design philosophy, though there _are_ several overlapping features. It should be fine to use both libraries in the same project without issues, however.

Features (~~but here's the yapper~~)

A proper write-up and documentation for all components and their intended usage is planned, but here's a quick rundown of them all:

• PlayerAttachable: An abstract effect or concept that continually affects a player (attach), and eventually stops (detach).
• PlatformGrabbable: Physically attaches a player and makes them 'grab' on to a 'platform', making the player's position follow said platform's until either a certain action stops being held (e.g. Jump), or they are detached through some other means. Used for Bozoros' balloon rides and PlayZone's slides.
• PlayerElectrode: Drains the batteries of any attached player's held and/or pocketed items, at a configurable rate.
• PlayerHinderer: Slows down any player who attaches in a similar way to the vanilla spider web, up until the moment they detach. Has options to act as quicksand and sink the player (as long as the Collider underneath it has an appropriate tag), with a few customizable traits. Players can also be inflicted with the TZP 'drunk' effect, at a configurable rate. Used for PlayZone's ball pit.
• PlayerLauncher: Launches any player who attaches, with heavily customizable trajectory parameters, and some additional optional features like fall damage prevention (until detached) and camera/player model tilting. Used for Bozoros' banana peels and PlayZone's trampolines.
• PlayerSeater: Makes any player who attaches enter a sitting animation until detaching, without reparenting the player or having to use an InteractTrigger. Used for PlayZone's slides.
• PlayerTracker: Physically attaches to a player and follows them around, at a configurable speed. Has an optional list of Transform 'pivots' to rotate to look towards the target, also at configurable speeds.
• PlayerWeightEvent: An event that has a chance to be invoked periodically, with the chance being dependant on the attached player's weight.
• MovementSensor: Checks if the attached player performs a specific movement action (e.g. Jump, Move, Crouch), and invokes an event callback if so. A cooldown can be applied so as to not trigger continuously, which can even be used for things like fake custom footstep sound effects. Used for PlayZone's ball pit movement effects.
• ShotgunSensor: 'Detects' a shotgun being fired by an attached player towards the target, and invokes an event callback if it meets the (configurable) parameters for both range and precision.
• SpraySensor: 'Detects' spray paint being used by an attached player towards the target. Has various thresholds for number of sprays required before invoking an event. Also works with weed killer!
• DetectRegion: An abstract region