Avatar Speed Package Script

Description

Version 1.2 Control avatar movement speed in your experience using Nearby chat commands, trigger zones, or ScriptEvents. MPP — AvatarSpeedPackage is a dual-script system delivered as a single Script asset in your inventory. It includes a central controller that manages all speed logic and optional zone triggers that request speed changes through ScriptEvents. This architecture keeps your experience organized, scalable, and easy to maintain, while allowing speed changes to be triggered from multiple systems. Perfect for: • obstacle courses and parkour maps • racing or movement challenges • roleplay areas with slow/fast zones • adventure experiences with temporary boosts • interactive systems controlled by buttons or events Speed changes can be triggered through: • Nearby chat commands • collision trigger zones • ScriptEvents from other scripts (including MPP – ActionButton) ________________________________________ Key Features • Nearby chat commands /speedhelp /speedup /speeddown /speedreset /speedset <value> • Flexible speed control Define minimum and maximum SpeedFactor values and adjust movement using a configurable Step Coefficient. • Local or global control Apply speed changes only to the triggering avatar, or to everyone in the experience. • Advanced global permissions Owner only, Owner + whitelist, or Owner + blacklist using Avatar UUID lists. • Multi-zone gameplay ready Create unlimited SpeedUp, SpeedDown, Reset, or Set zones. • ScriptEvent integration Trigger speed changes from other scripts such as MPP – ActionButton or custom systems. • Anti-spam cooldown Commands and zone triggers are protected against abuse. Cooldown activates only when a speed change is actually applied. • Optional timed boosts Temporary speed boosts can automatically reset after a configurable duration. • Optional sound feedback Independent sounds for SpeedUp, SpeedDown, Reset, and Set actions. Sound behavior: • Local mode → 3D positional sound from the avatar • Global mode → single global sound when applied to everyone ________________________________________ Quick Setup 1. Add MPP – AvatarSpeedController to one object in your scene (one controller recommended). 2. Optional: add MPP – AvatarSpeedZone to trigger volumes and select the desired Zone Action. 3. Make sure zone objects include a RigidBodyComponent and have collision enabled (Trigger Volume recommended). 4. Ensure the ScriptEvent message name matches between controller and zones (default works out of the box). 5. Adjust speed limits, cooldown, permissions, sounds, and boost duration as desired. ________________________________________ Notes • Visitors can freely use local speed commands unless global permissions restrict them. • Sounds and timed boosts are optional and disabled by default. ________________________________________ Changelog — Version 1.2 • Added ScriptEvent support allowing other scripts to trigger speed actions (SpeedUp / SpeedDown / Reset / Set). • Added MPP – ActionButton compatibility for interactive speed control. • Improved anti-spam cooldown logic to prevent repeated commands without actual speed changes. • Added timed boost system allowing automatic reset after a configurable duration. • Improved stability and internal speed change validation. ________________________________________ Enjoy and Keep Good Vibes. Hugs from Morgane. ________________________________________