Function newCustomAreaCategory

newCustomAreaCategory(
    sourceEntitya:
        | Entity
        | Player
        | Globals.modules.cmds.executeCommandPlayerW,
): Promise<0 | 1>
Creates a new custom area category for protected areas.
Parameters
- sourceEntitya: Entity | Player | Globals.modules.cmds.executeCommandPlayerW
  The source entity, which can be an instance of executeCommandPlayerW, Entity, or Player.
Returns Promise<0 | 1>
A promise that resolves to a number indicating the result of the operation.
Throws
If the number of arguments is incorrect or if the provided entity is not a valid Player.

The function performs the following steps:
1. Validates the number of arguments and the type of the source entity.
2. Checks if the player has the necessary permissions to create a custom protected area category.
3. Displays a form to the player to input the category ID and icon path.
4. Validates the uniqueness of the category ID and prompts the player to overwrite if a duplicate is found.
5. Saves the new category.
6. Calls editCustomAreaCategory to allow further editing of the newly created category.
- Defined in modules/spawn_protection/functions/newCustomAreaCategory.ts:39