# CFX::REGISTER_COMMAND

- **Hash:** `0x5FA79B0F`
- **Namespace:** CFX
- **Runtime name (Lua/JS):** `RegisterCommand`
- **Side:** shared (Cfx runtime native)
- **Name status:** official
- **Documentation:** described with examples
- **URL:** https://natives.borderlinerp.com/natives/CFX/REGISTER_COMMAND

## Signature

```c
void REGISTER_COMMAND(char* commandName, func handler, BOOL restricted);
```

## Parameters

- `commandName` (`char*`) — The command you want to register.
- `handler` (`func`) — A handler function that gets called whenever the command is executed.
- `restricted` (`BOOL`) — If this is a server command and you set this to true, then players will need the command.yourCommandName ace permission to execute this command.

## Returns

`void`

## Description

*Source: Cfx.re native reference*

Registered commands can be executed by entering them in the client console (this works for client side and server side registered commands). Or by entering them in the server console/through an RCON client (only works for server side registered commands). Or if you use a supported chat resource, like the default one provided in the cfx-server-data repository, then you can enter the command in chat by prefixing it with a `/`.

Commands registered using this function can also be executed by resources, using the [`ExecuteCommand` native](#\_0x561C060B).

The restricted bool is not used on the client side. Permissions can only be checked on the server side, so if you want to limit your command with an ace permission automatically, make it a server command (by registering it in a server script).

**Example result**:

![](https://i.imgur.com/TaCnG09.png)

## Usage

### Lua

```lua
RegisterCommand(commandName, handler, restricted)

-- always available, by hash
Citizen.InvokeNative(0x5fa79b0f, commandName, handler, restricted)
```

### JavaScript

```js
RegisterCommand(commandName, handler, restricted);

// by hash
Citizen.invokeNative('0x5fa79b0f', commandName, handler, restricted);
```

### C#

```csharp
Function.Call((Hash)0x5fa79b0f, commandName, handler, restricted);
```

## Examples

*Source: Cfx.re native reference*

```lua
-- (server side script)
-- Registers a command named 'ping'.
RegisterCommand("ping", function(source, args, rawCommand)
    -- If the source is > 0, then that means it must be a player.
    if (source > 0) then
    
        -- result (using the default GTA:O chat theme) https://i.imgur.com/TaCnG09.png
        TriggerClientEvent("chat:addMessage", -1, {
            args = {
                GetPlayerName(source),
                "PONG!"
            },
            color = { 5, 255, 255 }
        })
    
    -- If it's not a player, then it must be RCON, a resource, or the server console directly.
    else
        print("This command was executed by the server console, RCON client, or a resource.")
    end
end, false --[[this command is not restricted, everyone can use this.]])
```

*Source: Cfx.re native reference*

```cs
RegisterCommand("ping", new Action<int, List<object>, string>((source, args, rawCommand) =>
{
    if (source > 0) // it's a player.
    {
        // Create a message object.
        dynamic messageObject = new ExpandoObject();
        // Set the message object args (message author, message content)
        messageObject.args = new string[] { GetPlayerName(source.ToString()), "PONG!" };
        // Set the message color (r, g, b)
        messageObject.color = new int[] { 5, 255, 255 };

        // Trigger the client event with the message object on all clients.
        TriggerClientEvent("chat:addMessage", messageObject);
    }
    // It's not a player, so it's the server console, a RCON client, or a resource.
    else
    {
        Debug.WriteLine("This command was executed by the server console, RCON client, or a resource.");
    }
}), false /*This command is also not restricted, anyone can use it.*/ );
```

*Sources: Cfx.re native reference.*