ExcellentShop

https://nightexpressdev.com/excellentshop/
Admin
ExcellentShop is a modern, lightweight 2-in-1 Minecraft shop plugin featuring intuitive admin GUI...
Tokens:13,776
Snippets:139
Trust Score:6
Update:1 month ago
Show doc for...
Tokens:
Raw
### Configure Sell GUI in settings.yml

Source: https://nightexpressdev.com/excellentshop/virtual/sell-features

Toggle and customize the Sell GUI feature under the Sell_Menu section. The GUI is assigned to the /sellgui command by default. If Simplified is enabled, the GUI will have no items defined in the Content section. GUI configuration is in /virtual_shop/sell.menu.yml.

```yaml
Sell_Menu:
  Enabled: true
  Simplified: true
  Commands: sellgui,sellmenu
```

--------------------------------

### Configure Shop_Shortcut in settings.yml

Source: https://nightexpressdev.com/excellentshop/virtual/shop-shortcuts

Enables the shop shortcut feature and defines the command aliases used to access shops.

```yaml
Shop_Shortcut:
  Enabled: true
  Commands: shop,myshop
```

--------------------------------

### Configure Sell All in settings.yml

Source: https://nightexpressdev.com/excellentshop/virtual/sell-features

Toggle and customize the Sell All feature under the Sell_All section. The command is assigned to /sellall by default.

```yaml
Sell_All:
  Enabled: true
  Commands: sellall
```

--------------------------------

### Configure currency settings in config.yml

Source: https://nightexpressdev.com/excellentshop/features/multi-currency

Defines default and enabled currencies for auction, chest_shop, and virtual_shop modules. Use '*' to enable all currencies.

```yaml
Module:
  auction:
    Currency:
      Default: vault
      Enabled:
      - '*' # All currencies enabled.
  chest_shop:
    Currency:
      Default: vault
      Enabled: [] # No currencies but the Default one are enabled.
  virtual_shop:
    Currency:
      Default: vault
      Enabled:
      - '*' # All currencies enabled.
```

--------------------------------

### Configure Sell Hand All in settings.yml

Source: https://nightexpressdev.com/excellentshop/virtual/sell-features

Toggle and customize the Sell Hand All feature under the Sell_Hand_All section. The command is assigned to /sellhandall by default.

```yaml
Sell_Hand_All:
  Enabled: true
  Commands: sellhandall
```

--------------------------------

### Add ExcellentShop Maven repository and dependency

Source: https://nightexpressdev.com/excellentshop/developer-api

Add the NightExpress repository and ExcellentShop Core dependency to your pom.xml. Replace {VERSION} with the latest version shown in the badge.

```xml
<repository>
  <id>nightexpress-releases</id>
  <url>https://repo.nightexpressdev.com/releases</url>
</repository>

<dependency>
  <groupId>su.nightexpress.excellentshop</groupId>
  <artifactId>Core</artifactId>
  <version>{VERSION}</version>
</dependency>
```

--------------------------------

### Enable currency permissions in config.yml

Source: https://nightexpressdev.com/excellentshop/features/multi-currency

Enables the requirement for players to have specific permissions to use currencies.

```yaml
Currency_Need_Permission: true
```

--------------------------------

### Enable Sell Containers in settings.yml

Source: https://nightexpressdev.com/excellentshop/virtual/sell-features

Toggle the Sell Containers feature under the SellFeatures -> Containers section. Set ContentIncluded to true to include items inside containers when selling. Note that items inside bundles are not supported.

```yaml
Containers:
  ContentIncluded: true
```

--------------------------------

### Configure Sell Hand in settings.yml

Source: https://nightexpressdev.com/excellentshop/virtual/sell-features

Toggle and customize the Sell Hand feature under the Sell_Hand section. The command is assigned to /sellhand by default.

```yaml
Sell_Hand:
  Enabled: true
  Commands: sellhand
```

--------------------------------

### Trusted Players menu buttons configuration

Source: https://nightexpressdev.com/excellentshop/releases/v5-0-1

Configuration for the Trusted Players menu buttons in shop_settings.yml. The first button opens the trusted players menu, the second is a placeholder shown when the player lacks permission. You may need to manually add these buttons to your shop_settings.yml.

```yaml
  # Actual button
  shop_trusted_players:
    Priority: 10
    Item:
      Material: minecraft:player_head
      Display_Name: <lorange><b>Trusted Players</b></lorange>
      Lore:
      - <gray>Trust your friends, so they</gray>
      - <gray>can restock and manage your shop!</gray>
      - ''
      - <lorange>→ <u>Click to open</u></lorange>
      SkinURL: 65e5223317a890a30351f6f78d0abf8dd76cbd08df6f918883934564d28e58e
      Hide_Components: true
    Slots: '34'
    Type: shop_trusted_players
  # Placeholder to display if player has no permission to manage trusted players.
  trusted_players:
    Priority: 1
    Item:
      Material: minecraft:red_stained_glass_pane
      Display_Name: <red><b>Trusted Players</b></red>
      Lore:
      - <gray>You don't have access to this menu.</gray>
      Hide_Components: true
    Slots: '34'
```

--------------------------------

### Rent configuration in settings.yml

Source: https://nightexpressdev.com/excellentshop/chest/shop-renting

Configuration block for the Rent feature in settings.yml. It enables renting, sets the maximum duration in days (60), and defines the maximum price for the vault currency (10000.0).

```yaml
Rent:
  Enabled: true
  MaxDuration: 60
  MaxPrice:
    vault: 10000.0
```

--------------------------------

### Sell_Multipliers configuration in settings.yml

Source: https://nightexpressdev.com/excellentshop/virtual/sell-multipliers

Configure sell multipliers by rank or permission. The Mode can be RANK or PERMISSION, with a permission prefix and default value. Values map rank names to multiplier values.

```yaml
  Sell_Multipliers:
    Mode: RANK
    Permission_Prefix: shop.sellboost.
    Default_Value: 1.0
    Values:
      vip: 1.5
      gold: 2.0
```

--------------------------------

### Disabled_In_Worlds configuration in settings.yml

Source: https://nightexpressdev.com/excellentshop/virtual/shop-requirements

Configure worlds where all virtual shops are disabled. This setting can be bypassed with the virtual shop permission.

```yaml
Disabled_In_Worlds:
- world_name
- example_world123
```

--------------------------------

### Disabled_In_Gamemodes configuration in settings.yml

Source: https://nightexpressdev.com/excellentshop/virtual/shop-requirements

Configure game modes where all virtual shops are disabled. This setting can be bypassed with the virtual shop permission.

```yaml
Disabled_In_Gamemodes:
- CREATIVE
```
Tokens:
Raw