Basic Usage

This page was last updated for version v1.2.1

Example Effect

effects.yml

effects:
  rainbow-circle:
    display-name: "%rainbow-circle%"
    color-animation: "rainbow"
    permission: "%rainbow-effects%"
    description:
      - "..."
      - "..."
      - "..."
    icon:
      material: paper
      custom-model-data: 1

Basics

effects:
  key:
    display-name: "NAME" # optional
    color-animation: "COLOR" # optional
    name-color-animation: "BOOLEAN" # default=false
    permission: "PERMISSION" # optional
    icon: # optional
      material: "MATERIAL" # see below
    only-elytra: "BOOLEAN" # optional, default=false 
    description: # optional
      - ..
      - ..

key

Description

key is unique to effect, it won't show up in-game except for the /trparticles select command.

display-name

Description

The name that shows up in-game for the effect. It could be any name, no need to use unique names.

Notes

• If you don't give your effect a display name, it will automatically display the effect's key name.

• You can select a display name from the translations file. Just put %% and type the key from the effects section. Example:

display-name: "%helix-rainbow%" # Result: <rainbow>Rainbow Helix (locale: en)

color-animation

Description

Determines the armor color for leather armor that will be used in GUI.

Static Armor Color

• Use hex color codes for static color.

• Color names like red, green, and blue are not supported.

Animated Armor Color

• Pick a color scheme from colors.yml.

• Or use rainbow for rainbow colors.

name-color-animation

Description

Gives the item name a color animation if enabled.

permission

Description

The permission needed for this effect.

Using Hardcoded Permission

effects:
  rainbow-circle:
    display-name: "Rainbow Circle"
    permission: "trparticles.rainbow-circle"

Pulling Permission From config.yml

effects:
  rainbow-circle:
    display-name: "Rainbow Circle"
    permission: "%rainbow-effects%" # It will be replaced with the permission "trparticles.effects.rainbow" that is defined in the permissions section in `config.yml`

icon

Description

The item that shows up in the GUIs for the effect.

Properties

• material (see Material)

• custom-model-data

• amount

• glow

• player-head-name (For player heads, use premium account usernames)

• player-head-texture (For player heads, use texture value)

Example

icon:
  material: paper
  custom-model-data: 1
  amount: 1
  glow: true

description

Description

The description message for the effect.

Pulling Descriptions From Translations

• Putting the translation keys in %% will replace it with the translation for that translation key. Example:

description:
  - "%seasonal-effect%"
  - "%christmas%"
# Result: (Locale: EN)
# <gray>Seasonal Effect
# <gradient:#A7C957:#F2E8CF:#BC4749>Shine with New Year's colors.

only-elytra

Description

If this option is set to true, Effect will only work when player is equipped Elytra.