Moderation & Bans

Features

Moderation & Bans

Banning Scammers

Auction bans let staff punish players who abuse the marketplace by blocking them from the auction house. Bans work on offline players and propagate across your whole network.

/ah ban <player> <duration|def> [reason]
/ah unban <player>

Examples:

# Ban for 7 days with a reason
/ah ban Steve 7d Scamming in trades

# Permanent ban (def = definitive)
/ah ban Steve def Repeated scam attempts

# Lift a ban
/ah unban Steve

Duration uses the standard format — s, m, h, d, w, M, y — or def / perm for a permanent ban. If no reason is given, the configured bans.default-reason is used.

  • Both commands require the ah.admin permission.
  • By default a banned player's active listings are removed automatically (items returned if they are online).
  • Staff with ah.admin cannot be banned (configurable).
  • Bans are synchronized across all servers via XCore, and expired bans are cleaned up automatically.

Bans can also be managed from the Bans page of the XCore web dashboard — list, ban, and unban players from the browser.

Ban Configuration

Configure exactly what a ban blocks in config.yml. Each action can be toggled independently, so you can (for example) stop a player from selling while still letting them collect items they already bought.

bans:
  default-reason: "Scam"          # reason used when none is provided
  exempt-admins: true             # ah.admin players cannot be banned
  cancel-listings-on-ban: true    # remove the banned player's active listings
  block-sell: true                # /ah sell and /ah auction
  block-buy: true                 # buying fixed-price listings
  block-bid: true                 # bidding on auctions
  block-open: false               # opening the auction house at all
OptionEffect
block-sellPrevents listing items with /ah sell and /ah auction.
block-buyPrevents buying fixed-price listings.
block-bidPrevents bidding on auctions.
block-openPrevents opening the auction house entirely. Left false by default so banned players can still claim items they already own.

A blocked player sees a message explaining they are banned, with the reason and remaining time (or "permanent").

Still need help?

Ask our team on Discord or browse the source.