Customization

Colours, teleport effects and sounds are all defined in the config — add, remove or retune any of them. Here's what ships by default and how to extend it.

Colours

Two tabs in the picker. Dyes are flat colours; candles are gradients. 14 entries per page — extras paginate automatically.

Solid — 16 colours

White, Silver, Graphite, Onyx, Red, Orange, Yellow, Lime, Green, Cyan, Sky, Blue, Purple, Magenta, Pink, Cocoa.

colors:
  default: white
  solid:
    lime:   { material: LIME_DYE, name: "Lime", color: "#7BFB09" }
    purple: { material: PURPLE_DYE, name: "Purple", color: "#A855F7" }

Gradient — 16 fades

Fire, Ocean, Toxic, Sunset, Galaxy, Blood, Gold, Frost, Aurora, Ember, Void, Candy, Forest, Royal, Steel, and a full six-stop Rainbow. Add as many stops as you want:

  gradient:
    fire:    { material: ORANGE_CANDLE, name: "Fire", colors: [ "#FFE55C", "#FF7A00", "#D31027" ] }
    rainbow: { material: LIGHT_GRAY_CANDLE, name: "Rainbow", colors: [ "#FF0000", "#FF7F00", "#FFFF00", "#00FF00", "#0000FF", "#8B00FF" ] }

Teleport effects

Particles layer on top of each other. Twelve effects ship by default:

Effect	Shape	Feel
Inferno	SPIRAL	A twisting column of fire winds up around you
Wraith	BEAM	Soul fire erupts from the ground beneath you
Rift	VORTEX	A collapsing end portal pulls you through
Starfall	HELIX	Twin ribbons of light spiral around you
Blessed	BURST	A burst of undying energy surrounds you
Arcane	HALO	A halo of glyphs spins slowly overhead
Signature	SPIRAL	A dust spiral in your own custom colour
Dragonfire	RING	Dragon's breath pools around your feet
Blossom	AURA	Cherry petals drift gently around you
Sculk	VORTEX	The deep dark clings to you as you warp
Blizzard	RING	Snow and sparks whip around you
None	NONE	No effect at all

Building your own

Shapes: BURST RING SPIRAL HELIX BEAM VORTEX HALO AURA NONE

    signature:
      material: REDSTONE
      name: "Signature"
      description: "ᴀ ᴅᴜsᴛ sᴘɪʀᴀʟ ɪɴ ʏᴏᴜʀ|ᴏᴡɴ ᴄᴜsᴛᴏᴍ ᴄᴏʟᴏᴜʀ."
      shape: SPIRAL
      particles: [ DUST ]
      count: 3              # density multiplier
      radius: 0.7           # how wide the shape is
      speed: 0.0            # particle "extra" value
      dust-colour: "#7BFB09"
      dust-size: 1.2

The | in a description is a line break.

Particle data keys

Some particles demand extra data, and which ones changes between Minecraft versions. DexHomes reads that requirement off the server at runtime and feeds it from these optional keys:

Key	Used for	Default
`data`	Float / Integer particles — ENCHANT on 1.21.5+, SCULK_CHARGE, SHRIEK	`0`
`dust-colour`	DUST / ENTITY_EFFECT — hex	`"#7BFB09"`
`dust-size`	DUST	`1.0`

◆

Particle names are alias-resolved — both the modern and pre-1.20.5 names work (ENCHANT / ENCHANTMENT_TABLE, DUST / REDSTONE). A name that doesn't exist on your version simply drops that layer and logs it. Never a crash.

Teleport sounds

Eleven by default: Ender, Level Up, Beacon, Chime, Mirror, Amethyst, Pling, Conduit, Firework, Portal, Silent. Clicking one previews it instantly.

    beacon:
      material: BEACON
      name: "Beacon"
      description: "ᴀ ᴅᴇᴇᴘ ʜᴜᴍᴍɪɴɢ ᴀᴄᴛɪᴠᴀᴛɪᴏɴ."
      sound: "block.beacon.activate"
      volume: 0.6
      pitch: 1.4

▲

sound must be a vanilla sound key — what /playsound tab-completes — not the old ENUM_STYLE name. Use none for silence.

Sign input

Renaming and item search both read from a sign. input-line picks which of the four lines the value comes from (0 = top).

sign-input:
  rename:
    input-line: 0
    lines:
      - ""
      - "&0^^^^^^^^^^^^^"
      - "&0Enter the Name"
      - "&0^^^^^^^^^^^^^"

◆

Minecraft always drops the cursor on the top line when the sign editor opens, so line 0 is the input by default — the player can just type. Want the prompt on top instead? Set input-line: 2 — but the player then has to press Tab twice to reach the input.

Plugin sounds

Separate from the per-home teleport sound — these are the UI sounds:

sounds:
  success: "entity.experience_orb.pickup"
  error: "entity.villager.no"
  click: "ui.button.click"
  page: "item.book.page_turn"
  teleport-tick: "block.note_block.hat"