Components

Components are the elements inside a layout: text, buttons, images, item icons, the player model, and so on. Each entry in a layout's components list is an object with a type field and the type's own settings:

{
  "type": "palladium:text",
  "text": "Hello!",
  "properties": {
    "alignment": "center",
    "y": -20
  }
}

---

Common Properties

Every component accepts an optional properties object with the same set of fields:

Field	Type	Required	Fallback	Description
alignment	Alignment	No	top_left	Which point of the layout the component is anchored to. See Positioning.
x	Integer	No	0	Horizontal offset from the anchor point. Can be negative.
y	Integer	No	0	Vertical offset from the anchor point. Can be negative.
width	Integer	No	per type	Width of the component. Most types default to 50, square types (icon, item) to 16.
height	Integer	No	per type	Height of the component. Most types default to 18, square types (icon, item) to 16.
action	Action	No	/	Action to run on click. Only used by button components. See Click Actions.
tooltip	Text Component	No	/	Tooltip shown while hovering the component.
visibility	Condition(s)	No	always	The component is only shown while the condition is true. Re-checked every tick.

Positioning

Components are not laid out automatically; each one is positioned on its own. The alignment anchors the component to one of nine points of the layout's padded area, and x/y shift it from there:

top_left      top_center      top_right
middle_left   center          middle_right
bottom_left   bottom_center   bottom_right

For centered alignments the component's own size is taken into account, so "alignment": "center" with no offsets puts the component exactly in the middle. Offsets always move the component right (x) and down (y); use negative values for the other direction. A back button in the bottom right corner, 4 pixels off the edge, would be:

"properties": {
  "alignment": "bottom_right",
  "x": -4,
  "y": -4,
  "width": 60,
  "height": 20
}

Click Actions

The action property makes buttons do something when pressed. It uses the vanilla dialog action format, so everything vanilla supports works here: minecraft:run_command, minecraft:open_url, minecraft:suggest_command, minecraft:show_dialog, minecraft:copy_to_clipboard, and the dynamic variants.

Palladium adds two more action types:

• palladium:open_screen opens another Palladium screen (field screen, the screen ID). This is how you link screens together into multi-page menus.
• palladium:open_customization_screen opens the player customization screen (optional field category to jump to a category).

{
  "type": "palladium:button",
  "text": "Choose your side",
  "close_on_press": true,
  "properties": {
    "action": {
      "type": "minecraft:run_command",
      "command": "function mypack:choose_side"
    }
  }
}

Only the two button components (palladium:button and palladium:flat_button) execute actions; on all other components the action property is ignored. Commands run through actions are executed by the player, with their permission level, exactly like the vanilla dialog system.

Visibility

The visibility property takes the same conditions used everywhere else in Palladium, tested against the viewing player. Since it is re-evaluated every tick while the screen is open, you can build screens that react to the player's state, for example showing a button only once a power is unlocked:

"properties": {
  "visibility": {
    "type": "palladium:has_power",
    "power": "mypack:super_strength"
  }
}

---

Component Types

Blit

ID: palladium:blit

Renders a simple (piece of a) texture

Settings

Key	Type	Description	Required	Fallback
texture	Texture Reference	Texture path/dynamic texture		/
u	Integer (>= 0)	U-position on the texture where to start drawing from		0
v	Integer (>= 0)	V-position on the texture where to start drawing from		0
texture_width	Integer (>= 0)	Total width of the texture file		256
texture_height	Integer (>= 0)	Total height of the texture file		256
properties	UI Properties	Properties of this component		{}

---

Button

ID: palladium:button

Adds a button.

Settings

Key	Type	Description	Required	Fallback
text	Text Component	Text of the button		/
close_on_press	Boolean	Whether or not the screen will be closed when pressing the button.		/
properties	UI Properties	Properties of this component		{}

---

Colored Rectangle

ID: palladium:colored_rectangle

Renders a colored rectangle.

Settings

Key	Type	Description	Required	Fallback
color	Color	The color for the rectangle.		/
properties	UI Properties	Properties of this component		{}

---

Flat Button

ID: palladium:flat_button

Adds a flat button.

Settings

Key	Type	Description	Required	Fallback
text	Text Component	Text of the button		/
close_on_press	Boolean	Whether or not the screen will be closed when pressing the button.		/
properties	UI Properties	Properties of this component		{}

---

Gradient Rectangle

ID: palladium:gradient_rectangle

Renders a gradient rectangle.

Settings

Key	Type	Description	Required	Fallback
color_from	Color	The color for the start of the gradient.		/
color_to	Color	The color for the end of the gradient.		/
properties	UI Properties	Properties of this component		{}

---

Icon

ID: palladium:icon

Renders an icon

Settings

Key	Type	Description	Required	Fallback
icon	Icon definition	The icon to be rendered		/
properties	UI Properties	Properties of this component		{}

---

Item

ID: palladium:item

Renders an item

Settings

Key	Type	Description	Required	Fallback
item	Item / ItemStack	The item stack to be rendered		/
decorations	Boolean	Whether or not item stack "decorations" should be drawn (count, damage, etc.).		true
tooltip	Boolean	Whether or not the default tooltip for the item information should be rendered. If enabled, this will override the tooltip of the properties.		true
properties	UI Properties	Properties of this component		{}

---

Player Display

ID: palladium:player_display

Renders your player on the screen

Settings

Key	Type	Description	Required	Fallback
scale	Float (>= 0.0)	Scale of the player.		30
follow_mouse	Boolean	When enabled the player will follow the mouse cursor.		false
mimic_player	Boolean	When enabled the player will copy all of the actual player's properties. Equipment, animation, render layers, etc.		true
rotation	Vector 3D	The rotation that is applied to the player. If 'follow_mouse' is active, the rotation will be ignored.		/
render_layers	Identifier, Identifier[]	List of/single render layer ID that will be attached to the rendered player.		/
apply_customization_category_preview	Customization Category ID(s)	ID(s) of customization category that should be previewed		/
properties	UI Properties	Properties of this component		{}

---

Power Name

ID: palladium:power_name

Renders the name of a power.

Settings

Key	Type	Description	Required	Fallback
power	Power ID	The power that will be displayed. If none is specified, it will use the from the current power screen (if this component is used in one).		/
color	Color	Color of this text		"#404040"
shadow	Boolean	Whether or not this text has a shadow		false
alignment	left center right	Alignment of this text		left
overflow	clamped scrolling	How to behave if the text is longer than the component width		clamped
properties	UI Properties	Properties of this component		{}

---

Power Tree

ID: palladium:power_tree

Renders an interactable tree for a power of a power

Settings

Key	Type	Description	Required	Fallback
power	Power ID	The power that will be displayed. If none is specified, it will use the from the current power screen (if this component is used in one).		/
background	UI Background	The background that is drawn for the power tree.		"minecraft:textures/block/red_wool.png"
properties	UI Properties	Properties of this component		{}

---

Text

ID: palladium:text

Renders a text component

Settings

Key	Type	Description	Required	Fallback
text	Text Component	The text to be drawn		/
color	Color	Color of this text		"#404040"
shadow	Boolean	Whether or not this text has a shadow		false
alignment	left center right	Alignment of this text		left
overflow	clamped scrolling	How to behave if the text is longer than the component width		clamped
properties	UI Properties	Properties of this component		{}

---

Text Box

ID: palladium:text_box

Renders a scrollable text box

Settings

Key	Type	Description	Required	Fallback
text	Text Component	The text to be drawn		/
properties	UI Properties	Properties of this component		{}

---