📄 Official Documentation

🚀 Strategy-Style Selection

Whether you're developing a strategy game, a simulation similar to The Sims, or a turn-based adventure, our Unit Selection System is designed to seamlessly integrate into your project.

This package supports single and multiple unit selection with various configurations.

• Short well documented code
• No-coding required for out-of-the-box use!
• Quick Set up with step-by-step Guide
• 2 selection areas included (2D and 3D)
• Includes example demo scene with no additional 3D models or other assets seen on previews!

🔧 Core Functionality

• Click on unit to select it
• Drag mouse to create selection area and highlight units within it and then select units when selection button is release.
• Double mouse click to select all visible units to the camera
• Mouse hover highlight unit on cursor

🎮 Flexible Behaviour

Here is a list of few options available that can be enabled/disabled:

• Max. selection: adjust maximal number of selected units, or disable the limit
• Sort Units: sort units by distance from drag start position; comes in handy when selection has a maximum selection limit.
• Modify existing selection: add or remove units to modify existing selection
• Double Click: select all visible units on screen
• Drag Selection: select all units when mouse drag is released
• Drag Highlight: highligh units when mouse is dragged
• And more

🧑‍🤝‍🧑 NEW*

• Group/squad selection: Group units as a single selectable object.
• Nearest/Furthest selection: On click or hover, when units are behind selectable walls.
• Improved User experience: Now all core functionality configurable through a single component.
• Global events: Selection events available in editor or anywhere in code.
• Use filter: to specify selection for owned, friendly, neutral and enemy types.

🔑 Quick Unit Access

Optional component for quick access of units saved units.

• Save and Recall with Ease: Use Ctrl+Hotkey to save selections and recall them with simple hotkey presses.
• Customisation: Replace keys for any input actions to fit your needs.

🔲 Selection Prefabs Ready to Use

Choose from prefabs designed for 2D screen rectangle or 3D world cube selections, each utilizing different visual and unit detection methods. Extending and implementing your own is also supported.

• 2D screen rectangle: Select objects using screen rectangle. Supports detection types: screen position, world position (frustum), renderer bounds and custom bounds.
• 3D world cube: Select objects using cube in world space. Supports detection types: collision, position, renderer bounds and custom bounds.

🎮 Input Control Support

Works with newer Unity's InputSystem and older Input frameworks.

Prefabs for both are ready for use and each action can be configured.

Customisation

Every level of selection system is well defined by abstractions and interfaces. If ever there comes a time when the package won't suit all of your needs, you can replace any component with a custom one or write us with a feature request on this email.

Get Started Quickly

• Drag & Drop Setup: Simply place the selection system prefab into your scene along with selection area.
• Flexible Configuration: Adjust component settings to match your game’s mechanics.
• Immediate Selection Capabilities: Add the SelectableUnit component to any game object in your scene for instant selection functionality.
• Visuals: Drag & drop selection indicator prefab on unit and connect it to SelectableUnit component.

And now you're done!

📭 Support Ready: Have a question or need help? Reach out via Email, Discord, or our Forum!