Render Layers

Render layers are client-side definitions that render additional visuals on top of a player, things like suit textures, glowing eyes, capes, or fully custom 3D models. They are referenced by ID from items (via the palladium:render_layers data component) or from power renderers.

Render layer files are asset-side content, placed at:

assets/<namespace>/palladium/render_layers/<id>.json

---

Shared Properties

Every render layer type supports the following optional top-level fields, regardless of type.

Field	Type	Description
hidden_model_parts	String or List<String>	Player model parts to hide while this layer is active (e.g. "body.cape", "head").
conditions	Conditions	Controls when the layer is visible. See below.

Conditions

The conditions field controls under which circumstances the render layer is shown. In its simplest form it accepts a single Condition that applies in all perspectives:

"conditions": {
  "type": "palladium:ability_enabled",
  "ability": "mypack:flight"
}

To apply different conditions depending on whether the player is in first or third person, use the full object form:

Field	Type	Default	Description
main	Condition	—	Required. Applies in all perspectives.
third_person	Condition	always true	Additional condition applied only in third person.
first_person	Condition	always true	Additional condition applied only in first person.

"conditions": {
  "main": {
    "type": "palladium:ability_enabled",
    "ability": "mypack:flight"
  },
  "first_person": {
    "type": "palladium:false"
  }
}

---

Types

Below is a list of all render layer types provided by Palladium. In your local palladium/documentation/palladium folder you can find an auto-generated file that may include additional types added by other mods.

Block on Head

ID: palladium:block_on_head

Renders a block on the top of the entity's head.

Settings

Key	Type	Description	Required	Fallback
block	Block Tag	ID of the block/block state definition		/

Example

{
  "type": "palladium:block_on_head",
  "block": {
    "Name": "minecraft:glass"
  }
}

---

Compound Render Layer

ID: palladium:compound

A compound render layer that can contain multiple render layers.

Settings

Key	Type	Description	Required	Fallback
layers	Render Layers	The list of render layers this compound render layer contains.		/

---

Default Render Layer

ID: palladium:render_layer

Default render layer that renders a model with a texture.

Settings

Key	Type	Description	Required	Fallback
model_layer	Identifier	The model layer to render.		If not present, the model of the parent entity will be used.
texture	Identifier, Dynamic Texture, Texture Reference	The texture to render the model with.		/
render_type	minecraft:entity_translucent minecraft:entity_cutout	The render type to render the model with.		minecraft:entity_translucent
light_emission	(Dynamic) Value	The light emission of the model. Must be within 0 - 15		0

Example

{
  "type": "palladium:render_layer",
  "model_layer": {
    "wide": "example:wide_model",
    "slim": "example:slim_model"
  },
  "texture": {
    "wide": "example:wide_texture",
    "slim": "example:slim_texture"
  },
  "light_emission": 5
}

---

Geo Render Layer

ID: geckolib:render_layer

Uses GeckoLib to render a geo model, including animations

Settings

Key	Type	Description	Required	Fallback
texture	Identifier, Dynamic Texture, Texture Reference	The texture of the model		/
model	Identifier	The model to render		/
animations	Identifier	The animations to use		/
animation_controller	Animation Controller, Animation Controller[]	The animation controllers to control or trigger the animations.		/
light_emission	Integer	The light emission of the model. Must be within 0 - 15		0
bones	Map<Bone, String>	The bones of the model. You can specify here what the bones for each body part are called in your model file.		{HEAD=head, BODY=body, RIGHT_ARM=right_arm, LEFT_ARM=left_arm, RIGHT_LEG=right_leg, LEFT_LEG=left_leg}

---

Lightning Sparks

ID: palladium:lightning_sparks

Renders lightning sparks around the entity.

Settings

Key	Type	Description	Required	Fallback
frequency	Float	The frequency of the sparks.		0.5
amount	Integer	The amount of sparks to spawn during each occurence.		5
render_settings	Laser Renderer Settings	The render settings for the sparks.		/

Example

{
  "type": "palladium:lightning_sparks",
  "frequency": 0.2,
  "amount": 10,
  "render_settings": {
    "glow": "#0000ff",
    "bloom": 2,
    "size": 2
  }
}

---

Vibration

ID: palladium:vibration

Renders a vibration effect on the entity.

Settings

Key	Type	Description	Required	Fallback
intensity	Integer	The intensity of the vibration.		/
fade_ticks	Integer, Time String ("40s", "2m", etc.)	The time/ticks it needs for the vibration to fade in/out.		/

Example

{
  "type": "palladium:vibration",
  "intensity": 10
}

---