Default customcommands.yml

Shipped defaults from SoapsAdmin 1.7.7. After first run, this file lives in plugins/SoapsAdmin/.

Updating the jar does not overwrite your live copy. Use this page to compare or reset.

See also: Config Reference · Custom Commands

# Custom commands: action | message | alias | override
# override without commands: = wrap · with commands: = replace
# Placeholders: {player} {uuid} {world} {online} {args} {arg0}…
# /sa customcommand · /sa reload customcommands · more samples: wiki Custom Commands

settings:
  enabled: true
  # Register every /sa subcommand as top-level (/home, /ban, …)
  register-all-commands: false

disabled-commands: []

blocked-server-commands:
  plugins:
    enabled: true
    message: "<red>Plugin list is restricted. Contact staff if you need help.</red>"
    bypass-permission: soapsadmin.bypass.blockedcommands
  pl:
    enabled: true
    message: "<red>Plugin list is restricted.</red>"
    bypass-permission: soapsadmin.bypass.blockedcommands
  bukkit:
    enabled: true
    message: "<red>That command is disabled.</red>"
    bypass-permission: soapsadmin.bypass.blockedcommands
  version:
    enabled: false
    message: "<gray>Server version: {server_version}</gray>"

custom-commands:

  # Thin wrap — rule text lives in rules.yml / RulesManager
  rules:
    type: override
    description: Server rules
    permission: soapsadmin.rules

  godheal:
    type: action
    description: Heal, feed, and clear effects
    permission: soapsadmin.custom.godheal
    showInHelp: true
    showInTab: true
    commands:
      - sa heal {player}
      - sa feed {player}
      - sa cleareffects {player}
    message: "<green>You have been fully restored.</green>"
    sound-success: entity.player.levelup 1.0 1.0
    aliases:
      - gh
      - fullheal

  lobby:
    type: action
    description: Teleport to the lobby
    permission: soapsadmin.custom.lobby
    commands:
      - sa warp lobby
    warmup: 3
    worlds-blacklist:
      - world_the_end
    message: "<yellow>Teleporting to lobby...</yellow>"
    message-denied: "<red>Lobby teleport is disabled in this world.</red>"
    actionbar: "<yellow>Stay still. Teleporting in 3 seconds...</yellow>"
    sound-success: entity.enderman.teleport 1.0 1.0
    aliases:
      - hub

  staff-setup:
    type: action
    description: Quick staff mode with vanish
    permission: soapsadmin.custom.staffsetup
    commands:
      - sa staffmode
      - sa vanish
    message: "<aqua>Staff mode enabled with vanish.</aqua>"
    sound-success: block.note_block.pling 1.0 1.0

  # Built-in wraps (omit commands: = keep native; add aliases / extras)

  spawn:
    type: override
    description: Teleport to the spawn location
    warmup: 3
    message: "<green>You have been teleported to spawn.</green>"
    sound-success: entity.enderman.teleport 1.0 1.0
    aliases:
      - spn

  gamemode:
    type: override
    description: Change your gamemode
    sound-success: block.note_block.pling 1.0 1.0
    aliases:
      - gm

  heal:
    type: override
    description: Heal yourself
    cooldown: 60
    cooldown-group: restore
    message: "<green>You have been healed. (60s cooldown)</green>"
    sound-success: entity.player.levelup 1.2 1.0

  feed:
    type: override
    description: Feed yourself
    cooldown: 60
    cooldown-group: restore
    message: "<green>You have been fed. (60s cooldown)</green>"
    sound-success: entity.player.burp 1.0 1.0

  home:
    type: override
    description: Teleport to your home
    aliases:
      - h

  sethome:
    type: override
    description: Set a home location
    aliases:
      - sethm

  delhome:
    type: override
    description: Delete a home
    aliases:
      - delhm

  homes:
    type: override
    description: List homes
    aliases:
      - hm

  warp:
    type: override
    description: Teleport to a warp
    aliases:
      - w

  setwarp:
    type: override
    description: Set a warp
    aliases:
      - setw

  delwarp:
    type: override
    description: Delete a warp
    aliases:
      - delw

  warps:
    type: override
    description: List warps
    aliases:
      - ws

  tpto:
    type: override
    description: Teleport to a player
    aliases:
      - tp

  tptoggle:
    type: override
    description: Toggle teleport requests

  spawnmob:
    type: override
    description: Spawn mobs at your location
    aliases:
      - summon
      - smob
      - sm

  staffmode:
    type: override
    description: Toggle staff mode
    aliases:
      - smode
      - staff

  vanish:
    type: override
    description: Toggle vanish
    aliases:
      - v

  staffchat:
    type: override
    description: Staff chat
    aliases:
      - sc

  stafflist:
    type: override
    description: View staff online
    permission: soapsadmin.stafflist

  invsee:
    type: override
    description: View a player's inventory
    aliases:
      - inv

  endersee:
    type: override
    description: View a player's ender chest
    aliases:
      - ender

  spectate:
    type: override
    description: Spectate a player
    aliases:
      - spec

  invsnapshot:
    type: override
    description: Manage inventory snapshots
    aliases:
      - invs

  pluginmonitor:
    type: override
    description: Monitor plugins
    aliases:
      - pm

  customcommand:
    type: override
    description: Manage custom commands
    aliases:
      - customcmd

  report:
    type: override
    description: Report a player
    aliases:
      - rep

  reports:
    type: override
    description: View reports
    aliases:
      - reps

  clearchat:
    type: override
    description: Clear the chat
    aliases:
      - cc

  clearground:
    type: override
    description: Clear ground items
    aliases:
      - cg

  clearinv:
    type: override
    description: Clear a player's inventory

  cleareffects:
    type: override
    description: Clear potion effects
    aliases:
      - ce

  broadcast:
    type: override
    description: Broadcast a message
    aliases:
      - bc

  trash:
    type: override
    description: Open trash GUI

  doubledoors:
    type: override
    description: Double-door sync, iron right-click, auto-close
    showInHelp: false
    showInTab: false
    aliases:
      - ddoors
      - dd

  playtime:
    type: override
    description: Playtime stats and leaderboard
    showInHelp: false
    showInTab: false
    aliases:
      - mytime
      - playtimetop

  deathcoords:
    type: override
    description: Death location reminders after respawn
    showInHelp: false
    showInTab: false
    aliases:
      - dcoords
      - deathloc

  seekitem:
    type: override
    description: Scan nearby containers for items
    showInHelp: false
    showInTab: false
    aliases:
      - finditem
      - scanitem

  balance:
    type: override
    description: Check your balance
    aliases:
      - bal
      - money

  economy:
    type: override
    description: Economy
    aliases:
      - eco

  shop:
    type: override
    description: Open the shop

  sell:
    type: override
    description: Sell items

  worth:
    type: override
    description: Check item worth

  value:
    type: override
    description: Check inventory value

  daily:
    type: override
    description: Claim daily reward

  itemfilter:
    type: override
    description: Manage item pickup filter
    permission: soapsadmin.itemfilter

  autopickup:
    type: override
    description: Toggle autopickup
    permission: soapsadmin.autopickup

  autosell:
    type: override
    description: Manage autosell list
    permission: soapsadmin.autosell

  paytoggle:
    type: override
    description: Toggle incoming payments
    permission: soapsadmin.paytoggle

  msgtoggle:
    type: override
    description: Toggle incoming private messages
    permission: soapsadmin.msgtoggle

  tradetoggle:
    type: override
    description: Toggle incoming trade requests
    permission: soapsadmin.tradetoggle

  trade:
    type: override
    description: Trade with another player
    permission: soapsadmin.trade

  vault:
    type: override
    description: Open player vaults
    permission: soapsadmin.vault
    aliases:
      - pv
      - playervault
      - playervaults

  vaultadmin:
    type: override
    description: Manage other players' vaults
    permission: soapsadmin.vaultadmin
    aliases:
      - pva
      - playervaultadmin

  # Item / economy / messaging (top-level; give/take displace vanilla when claimed)

  give:
    type: override
    description: Give items (SoapsAdmin / Mythic)
    permission: soapsadmin.give

  take:
    type: override
    description: Take items from a player
    permission: soapsadmin.take

  pay:
    type: override
    description: Pay another player
    permission: soapsadmin.economy.pay
    aliases:
      - p

  baltop:
    type: override
    description: Balance leaderboard
    aliases:
      - balancetop

  cheque:
    type: override
    description: Withdraw or deposit cheques

  buy:
    type: override
    description: Buy from the shop

  sellall:
    type: override
    description: Sell matching inventory items

  msg:
    type: override
    description: Private message
    permission: soapsadmin.msg
    aliases:
      - whisper
      - tell
      - m

  reply:
    type: override
    description: Reply to last private message
    permission: soapsadmin.msg
    aliases:
      - r

  ignore:
    type: override
    description: Ignore a player's messages
    permission: soapsadmin.ignore

  mail:
    type: override
    description: Player mail
    aliases:
      - inbox

  friend:
    type: override
    description: Friends list and requests
    permission: soapsadmin.friend
    aliases:
      - friends

  nick:
    type: override
    description: Set your nickname
    permission: soapsadmin.nickname
    aliases:
      - nickname

  realname:
    type: override
    description: Resolve a nickname
    permission: soapsadmin.realname

  seen:
    type: override
    description: Last seen
    permission: soapsadmin.seen

  # Teleport / travel

  back:
    type: override
    description: Return to previous location

  tpa:
    type: override
    description: Request teleport to a player

  tpahere:
    type: override
    description: Request a player to teleport to you

  tpaccept:
    type: override
    description: Accept a teleport request
    aliases:
      - tpyes

  tpdeny:
    type: override
    description: Deny a teleport request
    aliases:
      - tpno

  tpacancel:
    type: override
    description: Cancel your teleport request

  tpauto:
    type: override
    description: Auto-accept teleport requests

  tphere:
    type: override
    description: Teleport a player to you
    aliases:
      - bring

  rtp:
    type: override
    description: Random teleport
    aliases:
      - wild
      - randomtp

  waypoint:
    type: override
    description: Waypoints
    aliases:
      - wp
      - waypoints

  # Kits / utilities

  kit:
    type: override
    description: Claim a kit
    aliases:
      - kits

  fly:
    type: override
    description: Toggle flight

  god:
    type: override
    description: Toggle god mode

  repair:
    type: override
    description: Repair items
    aliases:
      - fix

  enchant:
    type: override
    description: Enchant the held item

  hat:
    type: override
    description: Wear the held item as a hat

  ping:
    type: override
    description: Check ping

  near:
    type: override
    description: List nearby players

  top:
    type: override
    description: Teleport to the highest block

  jump:
    type: override
    description: Jump to target block

  workbench:
    type: override
    description: Open a crafting table
    aliases:
      - craft
      - wb

  anvil:
    type: override
    description: Open an anvil

  chatroom:
    type: override
    description: Chat rooms
    permission: soapsadmin.chatroom
    aliases:
      - cr

  # Common moderation shortcuts (still require SoapsAdmin perms)

  kick:
    type: override
    description: Kick a player

  ban:
    type: override
    description: Ban a player

  tempban:
    type: override
    description: Temporarily ban a player

  unban:
    type: override
    description: Unban a player

  banip:
    type: override
    description: Ban an IP

  tempipban:
    type: override
    description: Temporarily ban an IP

  unbanip:
    type: override
    description: Unban an IP

  mute:
    type: override
    description: Mute a player

  tempmute:
    type: override
    description: Temporarily mute a player

  unmute:
    type: override
    description: Unmute a player

  warn:
    type: override
    description: Warn a player

  freeze:
    type: override
    description: Freeze a player

  unfreeze:
    type: override
    description: Unfreeze a player

  jail:
    type: override
    description: Jail a player

  unjail:
    type: override
    description: Unjail a player

  weather:
    type: override
    description: Change weather

  time:
    type: override
    description: Change time

  flyspeed:
    type: override
    description: Set fly speed

  walkspeed:
    type: override
    description: Set walk speed

  nightvision:
    type: override
    description: Toggle night vision
    aliases:
      - nv