Skip to main content

Configuration

After installing the plugin, you will be pretty much ready to go. However, you can customize the plugin using the configuration file.

config.yml​

NexusAuctionHousePlus​

Can be found in /plugins/NexusAuctionHousePlus/config.yml

tax:
  sell-tax: 5 #Percentage of the sell price that players will have to pay in order to put their items in auction. Set to 0 to disable
  buy-tax: 5 #Percentage of the buy price that players will have to pay to buy an item. Set to 0 to disable
expiry:
  enable: true #If set to true, items not bought within the time set below will be unlisted.
  time: 7d
date-format: yyyy-MM-dd HH:mm:ss #Make sure to respect the formatting when editing this (caps etc.)
price-limits:
  min: 0
  max: 0 #Set to 0 for no limit
lang: en # Allows you to customize the plugin's language. If you want to make your own, set this to 'custom'.
translate-guis: true #If set to false, makes you able to edit all texts in the guis. Otherwise, it will be defined by the language above.
currencies: #Currencies that can be used in the auction house
  vault: #Exact name of the currency
    symbol: '$'
    permission: "npah.currency.vault"
  #stars: - example
  #symbol: '☆'
  #permission: 'npah.currency.stars'
default-type: "BIN" #Can be BIN or BID
#Set the below to 0 to disable the related feature
next-bid-percent: 5 #Example: in a bid auction, will give the option to the player to directly bid X% above the highest bid without having to manually enter the value
max-digits-price: 1 #Maximum number of digits in a price. Will be rounded if more.
leaderboard:
  empty-head-texture: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvNDEzZTk2ZGY2ZWQ0YjcwYTVhNzBmYzI5ZGNkZTkzMTRkYmU5NzY2OTY0NzRmMTIwZTBiMzBlYTVkN2I5NmIzYSJ9fX0=" #Texture given to the head if a slot is empty. Find this texture on any skin/head website
use-small-caps: false #Replace all possible text with small caps. See example at https://lingojam.com/smallcapstextgenerator

Taxes​

See #taxes.

Expiry​

If no one buys an item from a BIN auction in the specified period, it will disappear from the auction house (the seller will be refunded through the /ah stash command (see Commands & permissions).

For BID auctions, it defines the duration of the auction. At the end of this timer, the highest bidder will win the auction. Works even if enabled is set to false.

Date-format​

See #date-format

Price-limit​

See #price-limits

Lang​

See #lang

Translate-guis​

If set to true, uses the translations from #lang for GUI titles and item names. Otherwise, lets you customize these fields

Currencies​

If you use ExcellentEconomy

Add any currency you have configured in ExcellentEconomy. Only the name has to match, the symbol can be customized. Make sure to delete all auctions using old currencies before editing this.

If you don't use ExcellentEconomy

You can only customize the symbol that will be used and cannot set up more than one currency.

Default-type​

Auction type set by default on the /ah sell menu. Can be BIN or BID

Next-bid-percent​

In BID auctions, players can either bid the amount they wish or X% above the highest bid, X being the value set in this field.

Max-digits-price​

Self-explanatory: maximum number of digits in a price.

Leaderboard.empty-head-texture:​

Head texture used as placeholder for empty leaderboard slots.

Use-small-caps​

Replace all possible text with sᴍᴀʟʟ ᴄᴀᴘs.

Webhook.yml​

Can be found at /plugins/NexusAuctionHousePlus/webhook.yml

enabled: false
url: "https://discord.com/api/webhooks/00000000000000000000/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
alerts:
  new-listing: true
  listing-bought: true
  listing-expired: true
  listing-edited: true
  ah-toggle: true
  auction-ended: true
webhook-titles:
  new-listing: "New auction listed!"
  listing-bought: "An auction was bought!"
  listing-expired: "An auction has expired!"
  listing-edited: "An auction was edited!"
  ah-toggle: "The auction house has been toggled!"
  auction-ended: "An auction has ended!"
webhook-descriptions:
  new-listing: "%s1% just listed an item for $%s2%"
  listing-bought: "%s1% just bought an item from %s2% for $%s3%"
  listing-expired: "An auction listed by %s1% has expired!"
  listing-edited: "An auction was edited by %s1%!"
  ah-toggle: "The auction house has been toggled %s1%!"
  auction-ended: "%s1% just won an auction from %s2%!"
  on: "On"
  off: "Off"

For each alert selected, will send a message to the specified webhook.

sorts.json​

See Item sorts