gh-dev-gom-claude-code-marketplace-plugins-unity-editor-toolkit/skills/references/COMMANDS_PREFS.md

Unity Editor Toolkit - EditorPrefs Management Commands

Complete reference for reading, writing, and managing Unity EditorPrefs (persistent editor settings).

Last Updated: 2025-01-15

---

cd && node .unity-websocket/uw prefs get

Get EditorPrefs value by key.

Usage:

cd <unity-project-root> && node .unity-websocket/uw prefs get <key> [options]

Arguments:

<key>                  EditorPrefs key name

Options:

-t, --type <type>      Value type: string|int|float|bool (default: "string")
-d, --default <value>  Default value if key does not exist
--json                 Output in JSON format
-h, --help             Display help for command

Examples:

# Get string value
cd <unity-project-root> && node .unity-websocket/uw prefs get "UnityEditorToolkit.DatabaseConfig"

# Get int value with default
cd <unity-project-root> && node .unity-websocket/uw prefs get "MyInt" -t int -d "0"

# Get bool value as JSON
cd <unity-project-root> && node .unity-websocket/uw prefs get "MyBool" -t bool --json

---

cd && node .unity-websocket/uw prefs set

Set EditorPrefs value by key.

Usage:

cd <unity-project-root> && node .unity-websocket/uw prefs set <key> <value> [options]

Arguments:

<key>                  EditorPrefs key name
<value>                Value to set

Options:

-t, --type <type>      Value type: string|int|float|bool (default: "string")
--json                 Output in JSON format
-h, --help             Display help for command

Examples:

# Set string value
cd <unity-project-root> && node .unity-websocket/uw prefs set "MyKey" "MyValue"

# Set int value
cd <unity-project-root> && node .unity-websocket/uw prefs set "MyInt" "42" -t int

# Set bool value
cd <unity-project-root> && node .unity-websocket/uw prefs set "MyBool" "true" -t bool

# Set float value as JSON
cd <unity-project-root> && node .unity-websocket/uw prefs set "MyFloat" "3.14" -t float --json

---

cd && node .unity-websocket/uw prefs delete

Delete EditorPrefs key.

Usage:

cd <unity-project-root> && node .unity-websocket/uw prefs delete <key> [options]

Arguments:

<key>                  EditorPrefs key name to delete

Options:

--json                 Output in JSON format
-h, --help             Display help for command

⚠️ Warning: Deletion is irreversible. Make sure you have the correct key name.

Examples:

# Delete key
cd <unity-project-root> && node .unity-websocket/uw prefs delete "MyKey"

# Delete with JSON output
cd <unity-project-root> && node .unity-websocket/uw prefs delete "OldConfig" --json

---

cd && node .unity-websocket/uw prefs clear

Delete all EditorPrefs (WARNING: irreversible).

Usage:

cd <unity-project-root> && node .unity-websocket/uw prefs clear [options]

Options:

--force                Skip confirmation prompt (REQUIRED)
--json                 Output in JSON format
-h, --help             Display help for command

⚠️ DANGER: This command deletes ALL EditorPrefs data for the entire Unity Editor, not just the current project. Use with extreme caution. Always backup your settings first!

Examples:

# Attempt to clear (will show warning without --force)
cd <unity-project-root> && node .unity-websocket/uw prefs clear

# Force clear all EditorPrefs
cd <unity-project-root> && node .unity-websocket/uw prefs clear --force

# Clear with JSON output
cd <unity-project-root> && node .unity-websocket/uw prefs clear --force --json

---

cd && node .unity-websocket/uw prefs has

Check if EditorPrefs key exists. If key exists, also returns its type and value.

Usage:

cd <unity-project-root> && node .unity-websocket/uw prefs has <key> [options]

Arguments:

<key>                  EditorPrefs key name to check

Options:

--json                 Output in JSON format
-h, --help             Display help for command

Output:

Key: <key-name>
Exists: Yes/No
Type: string|int|float|bool      (only if exists)
Value: <value>                    (only if exists)

Examples:

# Check if key exists (shows value if exists)
cd <unity-project-root> && node .unity-websocket/uw prefs has "UnityEditorToolkit.Database.EnableWAL"
# Output:
# Key: UnityEditorToolkit.Database.EnableWAL
# Exists: Yes
# Type: bool
# Value: true

# Check non-existent key
cd <unity-project-root> && node .unity-websocket/uw prefs has "NonExistentKey"
# Output:
# Key: NonExistentKey
# Exists: No

# Check with JSON output
cd <unity-project-root> && node .unity-websocket/uw prefs has "MyKey" --json

---

Common Use Cases

Debug DatabaseConfig

# Check if config exists
cd <unity-project-root> && node .unity-websocket/uw prefs has "UnityEditorToolkit.DatabaseConfig"

# Get current config (JSON format)
cd <unity-project-root> && node .unity-websocket/uw prefs get "UnityEditorToolkit.DatabaseConfig"

# Reset config (delete)
cd <unity-project-root> && node .unity-websocket/uw prefs delete "UnityEditorToolkit.DatabaseConfig"

Manual Configuration

# Set custom database path
cd <unity-project-root> && node .unity-websocket/uw prefs set "CustomDatabasePath" "D:/MyData/db.sqlite"

# Enable feature flag
cd <unity-project-root> && node .unity-websocket/uw prefs set "FeatureEnabled" "true" -t bool

# Set numeric setting
cd <unity-project-root> && node .unity-websocket/uw prefs set "MaxConnections" "10" -t int

---

EditorPrefs Storage Location

EditorPrefs are stored per-Unity-Editor (not per-project):

• Windows: HKEY_CURRENT_USER\Software\Unity\UnityEditor\CompanyName\ProductName
• macOS: ~/Library/Preferences/com.CompanyName.ProductName.plist
• Linux: ~/.config/unity3d/CompanyName/ProductName/prefs

Note: CompanyName and ProductName are from your Unity Project Settings.

---

See Also

• Connection & Status Commands
• GameObject & Hierarchy Commands
• Transform Commands
• Scene Management Commands
• Asset Database & Editor Commands
• Console & Logging Commands