Custom Commands 1.0.0

• Create unlimited custom commands with aliases
• Support chat commands, console commands, or both
• Display multiple response messages with rich text formatting
• Show random responses from predefined sets
• Use dynamic placeholders for player info and arguments
• Set per-command cooldowns with permission-based overrides
• Limit maximum uses per wipe or day with permission overrides
• Charge Economics currency, ServerRewards points, or require items
• Configure different costs for different permission groups
• Enforce usage conditions like safe zones, building blocked status, health requirements, swimming status
• Execute client console commands, server console commands, and chat commands
• Broadcast messages to all online players
• Control where responses appear: chat, console, or both
• Set custom chat avatars using Steam IDs
• Automatically reset cooldowns and usage counts on map wipe or daily
• Manage player cooldowns and usage counts with admin commands

• customcommands.admin -- Access to admin commands for resetting cooldowns and usage counts.

• customcommands.vip -- Example VIP permission for reduced cooldowns and costs
• customcommands.elite -- Example Elite permission for further reduced cooldowns
• customcommands.kit.nocooldown -- Bypass cooldown for kit command
• customcommands.kit.unlimited -- Unlimited kit usage
• customcommands.heal.nocooldown -- Bypass cooldown for heal command
• customcommands.heal.free -- Free heal command usage
• customcommands.buybase -- Permission to use buybase command
• customcommands.buybase.free -- Free base purchase

• /rules-- Display server rules.
  • Aliases: /r, /serverrules
• /discord-- Show Discord and community links.
  • Aliases: /dc, /community, /socials
• /kit <name>-- Claim a kit (executes kit plugin command).
  • Aliases: /getkit, /starterkit
  • <name> -- Kit name to claim (defaults to "starter" if not specified)
• /vote-- Display voting information and links.
  • Aliases: /votereward, /claimvote
• /tip-- Display a random server tip.
  • Aliases: /tips, /hint, /hints
• /pos-- Show your current position and grid location.
  • Aliases: /position, /loc, /location, /coords, /where
• /buybase-- Purchase a starter base (disabled by default, requires permission).
  • Alias: /purchasebase
  • Note: Requires customcommands.buybase permission
• /heal-- Heal to full health (disabled by default).
  • Aliases: /medic, /doctor
• /vipinfo-- Display VIP benefits information.
  • Aliases: /vip, /donate, /premium, /store
• /playtime-- Check playtime (disabled by default, requires compatible plugin).
  • Aliases: /played, /mytime
• /wipe-- Display wipe schedule information.
  • Aliases: /wipetime, /wipeinfo, /nextwipe
• /report-- Show how to report players.
  • Aliases: /reportplayer, /cheater
• /pm <player> <message>-- Send private message (disabled by default).
  • Aliases: /msg, /whisper, /tell, /w
  • <player> -- Target player name or ID
  • <message> -- Message to send
• craftinfo-- Display crafting information.
  • Aliases: craft, crafting

• /ccresetcooldowns [player]-- Reset cooldowns for all players or a specific player.
  • Requires customcommands.admin permission
  • [player] -- Optional player name to reset cooldowns for
• /ccresetuses [player]-- Reset usage counts for all players or a specific player.
  • Requires customcommands.admin permission
  • [player] -- Optional player name to reset usage counts for

• Reset Cooldowns On Map Wipe -- Automatically clears all cooldowns when a new map is generated.
• Reset Usage Counts On Map Wipe -- Automatically resets usage counts when a new map is generated.
• Reset Usage Counts Daily At Midnight -- Resets usage counts every day at midnight server time. Useful for daily limits instead of per-wipe limits.
• Chat Message Prefix -- Prefix added to chat messages. Supports Unity rich text formatting.
• Log Command Usage To Server Console -- Logs each command usage to the server console for tracking.

• Enabled -- Whether this command is active.
• Command Type -- Where the command can be used.
• Alternate Command Names -- Alternative names for the command.
• Required Permission -- Permission required to use the command. Empty string means no permission required.

• Response Messages -- Messages sent to the player when command is used. Supports rich text and placeholders.
• Random Response Sets -- Alternative to Response Messages. Each inner array is a possible set of messages. One set is randomly chosen if Pick Random Response is enabled.
• Pick Random Response -- If true and Random Response Sets is configured, picks one random set. If false, uses Response Messages.
• Broadcast To All Players -- If true, sends responses to all online players instead of just the command user.
• Response Location -- Where messages appear. Options: MatchWhereUsed (chat if used via chat, console if used via console), ChatOnly (always chat), ConsoleOnly (always F1 console), ChatAndConsole (both locations).
• Chat Avatar Steam ID -- Steam ID for the chat avatar image. Use 0 for server icon, or any Steam ID for custom avatars.

• Cooldown -- Default cooldown in seconds.
• Cooldown Overrides -- Permission-based cooldown reductions. Lower values take precedence. First matching permission is used.
• Cooldown Bypass Permission -- Permission that completely ignores cooldown.

• Maximum Uses Per Reset -- Maximum number of times command can be used per reset period (wipe or daily).
• Maximum Uses Overrides -- Permission-based usage limit increases. Higher values take precedence. First matching permission is used.
• Maximum Uses Bypass Permission -- Permission for unlimited uses.

• Economics Cost -- Cost in Economics plugin currency. Requires Economics plugin.
• Economics Cost Overrides -- Permission-based cost reductions for Economics. Lower values take precedence.
• Server Rewards Cost -- Cost in ServerRewards points. Requires ServerRewards plugin.
• Server Rewards Overrides-- Permission-based cost reductions for ServerRewards. Lower values take precedence.
• Required Items -- List of items consumed when using the command. Each entry has: Item Short Name, Amount Required, Skin ID, and Custom Display Name.
• Cost Bypass Permission -- Permission that bypasses ALL costs (Economics, ServerRewards, and items).

Note: All costs are checked before command execution. If player lacks any required resource, the command fails and nothing is consumed.

Click to expand...

• Client Console Commands -- Commands executed on the player's client. Supports placeholders.
• Server Console Commands -- Commands executed on the server console. Supports placeholders.
• Chat Commands -- Chat commands executed as if the player typed them. Supports placeholders.

Execution Order: Response messages are sent first, then client commands, server commands, and finally chat commands are executed in that order.

Click to expand...

• Must Have Permission-- Requires an additional permission beyond the base command permission.
  • Value field contains the permission string to check
• Block If Has Permission-- Prevents usage if player has a specific permission (useful for blocking certain groups).
  • Value field contains the permission string to check
• Must Not Be Building Blocked -- Player must NOT be in a building blocked area.
• Must Be Building Blocked -- Player MUST be in a building blocked area.
• Must Be In Safe Zone -- Player must be in a safe zone.
• Must Not Be In Safe Zone -- Player must NOT be in a safe zone.
• Minimum Health Required-- Player must have at least this much health. Use `{0}`in error message to show the required value.
  • Value field is numeric health amount
• Maximum Health Allowed-- Player must have less than this much health. Use `{0}`in error message to show the maximum value.
  • Value field is numeric health amount
• Must Be Alive -- Player must be alive (not dead/wounded).
• Must Be Swimming -- Player must be in water/swimming.
• Must Not Be Swimming -- Player must NOT be swimming.

Condition Checking: All enabled conditions are checked before command execution. If any condition fails, the command is blocked and the error message is shown.

Click to expand...

• {player.name} -- Player's display name
• {player.id} -- Player's Steam ID (UserIDString)
• {player.position} -- Player's 3D position (X, Y, Z)
• {player.grid} -- Player's grid location (e.g., "H10")
• {player.health} -- Player's current health (rounded to nearest integer)
• {player.maxhealth} -- Player's maximum health (rounded to nearest integer)

• {args} -- All arguments joined with spaces
• {arg0} -- First argument (index 0)
• {arg1} -- Second argument (index 1)
• {arg2} -- Third argument (index 2)
• etc.

• {arg0:defaultvalue} -- If arg0 doesn't exist, uses "defaultvalue"
• {arg1:starter} -- If arg1 doesn't exist, uses "starter"

{
  "Player Data": {
    "76561198000000000": {
      "Cooldowns": {
        "commandname": 1234567890.0
      },
      "Uses": {
        "commandname": 3
      }
    }
  }
}

• Cooldowns -- Dictionary of command cooldown expiry times (Unix timestamp in seconds)
• Uses -- Dictionary of command usage counts for the current reset period

• MatchWhereUsed -- Shows response where command was used (chat command shows in chat, console command shows in console)
• ChatOnly -- Always shows in chat (even if used from console)
• ConsoleOnly -- Always shows in F1 console (useful for long text that would spam chat)
• ChatAndConsole -- Shows in both locations simultaneously

• Chat command: /ccresetcooldowns <playername>
• Console command: customcommands.resetcooldowns <playername>

• Chat command: /ccresetcooldowns
• Console command: customcommands.resetcooldowns