DUXPLIMA Documentation

Menu files

The keys of menus/glow.conf, the tile line, the tokens and the actions.

menus/glow.conf: the rows, the slots the sixteen colours are paged through, the material of every square, the sounds a click plays, where the buttons sit, and which block of the language file each tooltip reads. Nothing about the window is decided in the code.

The window

KeyMeaning
title@menu.title, or your own words
rows5
open-actionsA page-turn sound
placeholdersrole-free, role-worn, role-locked, role-glow-on, role-glow-off: the title colour of each state

The colours list

colours {
  slots = ["10-16", "19-25", "30", "32"]
  list {
    source = "glow:colours"
    template {
      material = "tinted:LEATHER_CHESTPLATE"
      name = " "
      lore = ["tile:%colour_role% @menu.colour.%colour_state% state"]
      decor { glow = "%colour_worn%" }
      click {
        left {
          requirements = ["glow:permitted"]
          click = ["glow:choose", "sound:BLOCK_NOTE_BLOCK_PLING 0.6 1.5"]
          deny  = ["glow:refuse", "sound:BLOCK_NOTE_BLOCK_BASS 0.6 0.9"]
        }
      }
    }
  }
}

A click with requirements runs click when they hold and deny when they do not.

Tokens

TokenValue
%colour%The colour's id
%colour_name%Its name
%colour_state%free, worn or locked
%colour_role%The window's role-<state>
%colour_worn%true for the worn colour
%glow_state%on or off
%glow_role%The window's role-glow-<state>

Actions and conditions

NameDoes
glow:coloursThe list source: the sixteen colours
glow:permittedA condition: the player holds this colour
glow:chooseGlows in this colour
glow:refuseSays error.colour-not-permitted
glow:clearTurns the glow off

tinted:<material> dyes a leather item with the square's colour; another material is drawn untinted. The tile line tile:<colour> @<block> <facts> draws the house tooltip from a block of the messages files, as in every UXM plugin.

Delete the file and the picker is gone: /glow answers menu.missing.

Related: Picker, Messages