CommandAttribute

Attribute that marks a static method as a discoverable command. Methods decorated with [Command] are automatically found by CommandProvider at editor load time and made available through the Command static API.

Definition

Namespace: Paragon Assembly: Paragon.dll

[AttributeUsage(AttributeTargets.Method), MeansImplicitUse]
public class CommandAttribute : Attribute

Inheritance: Attribute → CommandAttribute

Remarks

CommandAttribute is the base attribute for the command system. It supports two specializations:

• RuntimeCommandAttribute — Shorthand for [Command(runtimeOnly: true)], restricts execution to play mode

• EditorCommandAttribute — Editor-only command (compiled out of builds via #if UNITY_EDITOR)

The Name field controls the registered command name. If null, the CommandProvider uses the method name instead. Spaces in the name are automatically replaced with dashes.

The attribute includes [MeansImplicitUse] (JetBrains annotations) to suppress "unused method" warnings in IDEs since commands are invoked via reflection.

Quick Lookup

Goal	How
Register a command	[Command("command-name")]
Runtime-only command	[RuntimeCommand("command-name")]
Editor-only command	[EditorCommand("command-name")]
Auto-name from method	[Command] (uses method name)

Fields

Name

public readonly string Name;

The registered command name. Spaces are replaced with dashes. If null, the method name is used as the command name.

RuntimeOnly

public readonly bool RuntimeOnly;

When true, the command can only be executed during play mode.

Constructors

CommandAttribute

public CommandAttribute(string name = null, bool runtimeOnly = false)

Parameter	Type	Default	Description
name	string	null	Command name (spaces → dashes). null = use method name
runtimeOnly	bool	false	Restrict to play mode execution

Derived Types

RuntimeCommandAttribute

Convenience attribute equivalent to [Command(runtimeOnly: true)].

public class RuntimeCommandAttribute : CommandAttribute

Parameter	Type	Default	Description
name	string	null	Command name (spaces → dashes)

EditorCommandAttribute

Editor-only command attribute. Compiled out of builds via #if UNITY_EDITOR.

public class EditorCommandAttribute : CommandAttribute

Parameter	Type	Default	Description
name	string	null	Command name (spaces → dashes)

Common Pitfalls

Spaces are silently replaced with dashes [Command("my command")] registers as "my-command". Use dashes explicitly for clarity.

EditorCommandAttribute is stripped from builds Since it's wrapped in #if UNITY_EDITOR, any method using [EditorCommand] will not be registered in builds. Use [RuntimeCommand] for play mode commands that should also work in builds.

MeansImplicitUse suppresses IDE warnings The [MeansImplicitUse] annotation tells JetBrains IDEs that the method is invoked via reflection, preventing false "unused method" warnings.

Examples

Defining Commands

public static class GameCommands
{
    // Basic command — available everywhere
    [Command("set-health")]
    public static void SetHealth(int amount)
    {
        Player.Health = amount;
    }

    // Runtime-only — only during play mode
    [RuntimeCommand("spawn-enemy")]
    public static void SpawnEnemy(string type, int count)
    {
        EnemyManager.Spawn(type, count);
    }

    // Auto-named from method name
    [Command]
    public static void ResetLevel()
    {
        LevelManager.Reset();
    }

    // Editor-only — stripped from builds
    #if UNITY_EDITOR
    [EditorCommand("validate-assets")]
    public static void ValidateAssets()
    {
        AssetValidator.RunAll();
    }
    #endif
}

See Also

• Command — Static API for executing and searching commands

• CommandMethod — Wraps attributed methods with runtime metadata