Effect Customisation

TextEffect lets you tune the appearance of its built-in effects before a resource pack is generated.

Use this when you want an effect to match your server brand, a season, a rank palette or a specific menu theme without editing shader files by hand.

Configuration file

Open:

plugins/TextEffect/effect-customisation.yml

The file includes every built-in effect with its current visual values. You can edit only the sections you need.

Change colours

Most effects use named colour values. Keep each colour in quotes and use a six-digit hex value:

effects:
  fire:
    colours:
      ember: "#D91D00"
      flame: "#FFD23F"

The colour keys are effect-specific. Keep the existing key names and change only the hex values.

Change animation and movement

You can apply defaults to every effect:

defaults:
  animation-speed: 0.85
  motion-strength: 0.90

Or override one effect:

effects:
  wave:
    animation-speed: 0.70
    motion-strength: 1.20

animation-speed accepts values from 0.0 to 3.0.

motion-strength accepts values from 0.0 to 2.0. Effects with no vertex movement ignore this setting.

Dynamic colour effects

Rainbow and confetti use dynamic HSV colour controls rather than a fixed palette:

effects:
  rainbow:
    colour-controls:
      hue-offset: 0.15
      saturation: 0.75
      brightness: 1.0

hue-offset accepts values from -1.0 to 1.0. saturation and brightness accept values from 0.0 to 1.0.

Apply your changes

A customisation is written into newly generated shader files, so rebuilding the pack is required.

1. Edit effect-customisation.yml.
2. Run /texteffect reload.
3. Run /texteffect validate.
4. Build a new pack with /texteffect zip or /texteffect zip merge.
5. Replace the pack your players receive.

Existing packs do not change until you rebuild and redistribute them.