Current Version: v1.0.0-pre (Pre-release)
SpotlightUI is an open-source guided focus module that lets you quickly build interactive tutorials, onboarding flows, and visual guidance systems in Roblox with just a few lines of code. It allows you to highlight UI elements and world objects using dynamic spotlight masks, pulsing effects, and step-based sequences through a clean, chainable API.
The module works using a step system. Each step focuses on a specific UI element or 3D object, and you can move between steps through code or player actions. This makes it easy to build onboarding tutorials, feature hints, or interactive walkthroughs. SpotlightUI supports different shapes like circles and squares and works for both UI and world targets.
SpotlightUI updates targets at runtime, so highlights stay accurate even if UI moves or changes. While it’s mainly built for tutorials, it can also be used for quick callouts or temporary highlights.
DEMO:
Rectangle / Square Shape [UI]
Circle Shape [UI]
World / Viewpoint [3D]
Getting started: Getting Started – SpotlightUI
Links:
• GitHub
• Documentation / Examples
• Model
Development Roadmap / Changelog
Development Roadmap
SpotlightUI is actively maintained and continuously improved. This section outlines planned features, bug fixes, and future enhancements.
Current Version: v1.0 (Pre-Release)
Known Issues
- Potential memory leaks in long-running or repeated spotlight sequences
- Circle shape width inconsistency on certain screen sizes
- Triangle shape rendering issue (appears as a sideways rectangle instead of a triangle)
Version 1.1 (Next Release)
Bug Fixes
- Fix memory leaks and improve cleanup reliability
- Fix triangle shape rendering and positioning
- Correct circle shape width inconsistencies
- Improve mobile touch detection
- Enhanced performance for multiple spotlights
New Features
- Custom Color Themes
- Click-to-Advance (auto progress on interaction)
- Progress Indicators (e.g. “Step 2 of 5”)
- Step Callbacks (
OnShow,OnComplete) - Arrow Indicators pointing to spotlight targets
Version 1.2 (Planned)
Features
- Multi-Target Highlighting
- Animation Presets (fade, bounce, zoom, slide)
- Custom Shapes (polygon support)
- Replay Controls (skip, previous, replay)
- Mobile Gestures support
Version 2.0 (Future)
Advanced Features
- Conditional Steps
- Branching Tutorials
- Voice-Over Integration
- World Space UI (billboard spotlights)
Polish & Accessibility
- High Contrast Mode
- Reduced Motion option
- Screen Reader compatible hints
- Analytics & Metrics
Community Requests
Have a feature request? Open an issue on GitHub.
Last updated: January 20, 2026
Credits
• @pobammer for the package Janitor
• @stravant for the package GoodSignal
this gonna help soo much for onboarding systems