Ultimate Scriptables Documentation

Introduction

Ultimate Scriptables is a powerful Unity editor extension designed to revolutionize how you work with ScriptableObjects. It provides a comprehensive suite of tools for creating, managing, organizing, and optimizing ScriptableObjects in your Unity projects.

This documentation covers all aspects of Ultimate Scriptables, from installation to advanced features, providing you with everything you need to maximize your productivity.

Installation

Import the Ultimate Scriptables package into your Unity project
Access the tool through the menu: Tools > Ultimate Scriptables
The main window will open, displaying all ScriptableObjects in your project

Main Interface

The Ultimate Scriptables interface consists of several key areas:

Main Toolbar

Located at the top of the window, providing access to:

Refresh button (updates the ScriptableObject list)
Import/Export dropdown
Display Options dropdown
Power Tools dropdown
Search Options dropdown
Search field for filtering objects

Object View Area

The central area displaying your ScriptableObjects in either:

Grid View: Visual display with icons
List View: Detailed display with properties

Preview Panel

The right-side panel showing:

Selected ScriptableObject details
Quick actions like Edit, Duplicate, and Export
Reference information when available
Validation issues when detected

Creation Buttons

Prominent buttons for:

Create ScriptableObject Instance
Create ScriptableObject Script

Visual Management

Viewing Modes

Ultimate Scriptables offers two primary viewing modes:

Grid View

Visual representation of ScriptableObjects with icons
Compact display for seeing many objects at once
Quick access to common operations
Enable by selecting “Grid View” in Display Options

List View

Detailed information for each ScriptableObject
Expandable entries to view and edit properties
Hierarchical display for nested data
Default view when Grid View is disabled

Organization Methods

Organize your ScriptableObjects using these methods:

By Type

Groups objects by their class type
Makes it easy to find objects of a specific type
Enable by selecting “Show By Type” in Display Options

By Inheritance

Groups objects by their class hierarchy
Shows parent-child relationships between types
Enable by selecting “Show By Inheritance” in Display Options

By Category

Groups objects by user-defined categories
Custom organization independent of type hierarchy
Enable by selecting “Show By Category” in Display Options

Search and Filter

Find specific ScriptableObjects using:

Search by name
Search by type
Filter by favorite status
Filter by category assignment

Creating ScriptableObjects

Ultimate Scriptables offers two powerful creation tools:

Script Generator

Create new ScriptableObject classes with:

Click “Create ScriptableObject Script”
Enter class name, description, and namespace
Add variables with customizable:
- Types (int, float, string, Unity object types, etc.)
- Access modifiers (public/private)
- Array support
- Tooltips and ranges
Preview generated code before creation
Generate and automatically open the script

Instance Creator

Create new ScriptableObject instances with:

Click “Create ScriptableObject Instance”
Browse available ScriptableObject types (organized by namespace)
Enter asset name and select save location
Generate the new instance
Start editing immediately

Categories System

Organize ScriptableObjects with custom categories:

Creating Categories

Right-click on a ScriptableObject or use “Add to Category” button
Select “New Category” and enter a name
The object is added to the new category

Managing Categories

Click “Manage Categories” when category view is enabled
Add, rename, or delete categories
Add or remove objects from categories
View all objects in each category

Using Categories

Filter and group objects by category
Batch-assign objects to categories
Categories persist between Unity sessions

Favorites System

Mark frequently used ScriptableObjects for quick access:

Click the star icon or use the “Add to Favorites” option
Use “Show Favorites Only” to filter to just favorite objects
Remove from favorites by clicking the star again

Import and Export

Share and version your ScriptableObjects with multiple format options:

Export Formats

JSON: Human-readable format ideal for version control
CSV: Tabular format for spreadsheet editing
YAML: Human-readable hierarchical format

Export Methods

Select a ScriptableObject
Click “Export” in the preview panel
Choose a format and destination

Import Methods

Click Import/Export > Import from the format menu
Select a file to import
Confirm import settings
Save the new ScriptableObject

Batch Operations

Export multiple ScriptableObjects at once
Import multiple files simultaneously
Convert between formats

Validation and References

Ensure data integrity with validation tools:

Validation System

Enable “Validation” in Display Options
Automatically checks for missing references and other issues
Warning icons appear on objects with problems
View specific issues in the preview panel

Finding References

Enable “Show References” in Display Options
View where each ScriptableObject is used
Detect usage in scenes, prefabs, and other assets
Locate potential dependencies

Fixing Missing References

Use Power Tools > Find Missing References
View all objects with missing references
Fix individual references or apply batch fixes
Validate fixed objects

Comparison Tool

Compare and synchronize values between ScriptableObjects:

Select an object and click “Compare…”
Select a second object to compare against
View all property differences
Copy values in either direction
Apply changes selectively or all at once

Batch Operations

Perform actions on multiple ScriptableObjects:

Select multiple objects (Ctrl/Cmd+click)
Use Selection Toolbar options:
- Add to Category
- Add to Favorites
- Export
- Duplicate
- Delete

Power Tools

Advanced features for power users:

Templates

Save common ScriptableObject configurations
Create new objects based on templates
Share templates between projects

Asset Dependencies

Visualize relationships between assets
Find circular dependencies
Analyze usage patterns

Documentation Generation

Create documentation for your ScriptableObjects
Export types and properties
Generate formatting for wikis or documentation sites

Quick Edit Mode

Edit ScriptableObjects directly in the manager:

Enable “Quick Edit Mode” in Display Options
Click on a ScriptableObject to select it
Edit common properties directly in the grid/list view
Changes are saved automatically

Tips and Best Practices

Organization Tips

Create categories for gameplay systems (AI, Weapons, UI, etc.)
Use inheritance grouping for reviewing class hierarchies
Mark core objects as favorites for quick access

Workflow Optimization

Use keyboard shortcuts for common operations
Set up templates for frequently created objects
Run validation checks before major milestones

Team Collaboration

Use import/export to share objects between team members
Document category structures for consistent organization
Export to JSON for better version control diff viewing

Keyboard Shortcuts

Improve your workflow with these shortcuts:

F5: Refresh the ScriptableObject list
Ctrl/Cmd+F: Focus the search field
Ctrl/Cmd+N: Create a new ScriptableObject instance
Ctrl/Cmd+Shift+N: Create a new ScriptableObject script
Delete: Delete selected ScriptableObjects (with confirmation)
Ctrl/Cmd+Click: Select multiple objects
Double-Click: Open a ScriptableObject for editing
Escape: Clear selection

Troubleshooting

Common Issues

Q: Some ScriptableObjects are not appearing in the manager
A: Click the Refresh button to update the list. Ensure objects are in the Assets folder.

Q: Validation is not showing any issues
A: Enable Validation in the Display Options menu and refresh the view.

Q: Import operation failed
A: Check that the file format matches the expected structure. Review the format documentation.

Q: Manager performance is slow
A: For large projects, try disabling “Show References” and “Validation” when not needed.

Getting Help

For additional support:

Check the included example scenes
Review the API documentation
Contact support at [your support email/website]

Conclusion

Ultimate Scriptables transforms how you work with ScriptableObjects in Unity, combining powerful creation tools, intuitive organization systems, and advanced utilities to maximize your productivity.

By integrating Ultimate Scriptables into your workflow, you’ll spend less time managing assets and more time creating amazing games and applications.