💚
Treasure Particles
  • Home Page
  • Discord Server
  • Download
    • 🧡BuiltByBit
  • Effects
    • Basic Usage
    • Creating Effect
      • Caching
      • Variables
      • Tick Handlers
        • Events
        • Mixer Options
      • Script Types
        • Variable
        • Variable Cycle
        • Particle
          • Single Particle
          • Circle Particle
            • Spread Particle
            • Targeted Circle Particle
          • Spiral Effects
            • Spiral Particle
            • Multi Spiral Particle
            • Full Spiral Particle
          • Targeted Particle
          • Sphere Particle
          • Text Particle
            • Animated Text Particle
          • Particles
          • Color Format
        • Parkour
        • Condition
        • Preset
        • Sound
        • Message
          • Chat Message
          • Action Bar Message
          • Title Message
        • Lightning
        • Others
    • Presets
    • Mixer
    • Static Effects
  • Colors
    • Adding New Color Scheme
    • Adding New Color Group
  • Configuration
    • General Options
    • Database
    • Permissions
    • GUI Config
      • Item Properties
  • Translations
Powered by GitBook
On this page
  • Example Effect
  • Basics
  1. Effects

Basic Usage

This page was last updated for version v1.4.1

Example Effect

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: "<STRING>" # 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 item color that will be used in GUI.

Supported Item Types:

  • Leather Armors

  • Tipped Arrows

  • Potions

  • Maps

Static Color

  • Use hex color codes for static color.

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

Animated 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.

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.

PreviousHome PageNextCreating Effect

Last updated 3 months ago

See Item Properties page for details.