GUI

This file controls the visual layout of the Night Market. You can define the title, size, and the position of all market items and decorative elements.

Parameter Breakdown

title

The title displayed at the top of the GUI inventory. Supports color codes.

rows

The number of rows in the GUI. Must be a number between 1 and 6.

market_item_slots

This section maps inventory slots to item keys from items.yml. This is how the plugin knows where to place the randomized items.

• slot-1: A unique key for this mapping entry. The name does not matter.

• inventory_slot: The numerical slot in the inventory (0-53). Slot 0 is the top-left corner.

• item_source_key_from_items_yml: This field is no longer used but is kept for legacy reasons. The plugin now pools all items from items.yml to fill these slots.

decorative_items

A list of static items used to decorate the GUI, such as borders, information panels, or buttons.

• border-glass: A unique key for this decorative item. The name does not matter.

• material: The material of the item.

• name: The display name of the item.

• lore: The lore of the item.

• slots: A list of inventory slots where this item should appear.

• custom_model_data (Optional): An integer value for a custom model data, used with resource packs.

confirmation_menu

Defines the layout of the sub-menu that appears when a player clicks to purchase an item.

• title: The title of the confirmation menu.

• rows: The number of rows (1-6).

• item_display_slot: The slot where the item being purchased is displayed.

• confirm_button, cancel_button, fill_item: These are decorative item configurations for the confirmation menu's buttons and background filler.

Full Example: gui.yml

# This file controls the layout and appearance of the Night Market GUI.

# Title of the main GUI. Supports color codes.
title: '&8&lNight Market'
# Number of rows in the GUI (1-6).
rows: 5

# Define which slots will contain randomized market items.
market_item_slots:
  slot-1:
    inventory_slot: 11
    item_source_key_from_items_yml: 'any' # This key is for reference; not strictly used.
  slot-2:
    inventory_slot: 13
    item_source_key_from_items_yml: 'any'
  slot-3:
    inventory_slot: 15
    item_source_key_from_items_yml: 'any'
  slot-4:
    inventory_slot: 29
    item_source_key_from_items_yml: 'any'
  slot-5:
    inventory_slot: 31
    item_source_key_from_items_yml: 'any'
  slot-6:
    inventory_slot: 33
    item_source_key_from_items_yml: 'any'

# Define static, decorative items for the GUI.
decorative_items:
  black-border:
    material: BLACK_STAINED_GLASS_PANE
    name: ' '
    slots: [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 17, 18, 26, 27, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44]
  info-panel:
    material: BOOK
    custom_model_data: 10001
    name: '&6&lInformation'
    lore:
      - '&7Click the glowing panes to reveal'
      - '&7a unique, random offer!'
      - ''
      - '&eMarket closes in: &f%nightmarket_time%'
    slots: [4]

# Configuration for the purchase confirmation menu.
confirmation_menu:
  title: '&8Confirm Purchase'
  rows: 3
  item_display_slot: 13
  confirm_button:
    material: LIME_DYE
    custom_model_data: 20001
    name: '&a&lConfirm Purchase'
    lore:
      - '&7Click to buy this item.'
    slots: [11]
  cancel_button:
    material: RED_DYE
    custom_model_data: 20002
    name: '&c&lCancel'
    lore:
      - '&7Click to return to the market.'
    slots: [15]
  fill_item:
    material: GRAY_STAINED_GLASS_PANE
    name: ' '
    slots: [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 12, 14, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26]