Bug Fixes
❤️ Fixed update checker

Added
❤️ New effect: Rainbow Circle v3
❥ Particle size will be bigger when accelerated

❤️ New script types: break, break-handler
❥ You can see detailed information on Wiki

❤️ New pre-defined variables
❥ TIMES: Returns the times value of the tick handler
❥ velocityX, velocityY, velocityZ, velocityLength: Returns player's velocity

❤️ New dynamic script argument types
❥ Added Integer, Float, Boolean, Vector, and Range arguments
❥ What this means is, for example, you can now change particle size by the player's gliding speed (with new pre-defined variables)
❥ You can see detailed information on Wiki

❤️ New aliases for variable script: var
❤️ Toggle option for colored error logs (console)
❤️ Option for change rainbow colors size

Changed
❤️ Particle location argument now requires vector argument
❥ Old versions: ❥ New version: ❤️ Improved variable script reader
❥ If the variable is not defined, it will give an error message

❤️ Tweaked error logs
❤️ Improved validations
❤️ Improved */trelytra locale* command

Bug Fixes
❤️ Fixed issues related to players' data
❤️ Fixed concurrency issues

Removed
❤️ In-game changelog

Added
❤️ 1.19.3 Support

❤️ PlaceholderAPI Support
❥ %trelytra_current_effect% - Current effect's parsed (stylized) display name
❥ %trelytra_current_effect_raw% - Current effect's raw display name
❥ %trelytra_effects_visibility% - Enabled/Disabled
❥ %trelytra_notifications% - Enabled/Disabled
❥ %trelytra_in_use% - true/false
❤️ New aliases for particle configuration
❥ colorScheme: color
❥ direction: directional

❤️ New effects
❥ Reverse Pulse
❥ Christmas Exclusive: Snow, Christmas / Circle, Christmas / Line

❤️ New pre-defined variables
❥ lastBoostMillis (LBM): Last elytra boost time in milliseconds ( Paper 1.17+ is required)
❥ currentTimeMillis (CTM): Current time in milliseconds

❤️ Permission for effects visibility
❥ Default: Disabled
❥ Default Permission: trelytra.can_see_effects ( see config.yml)
❤️ More customization options for Effects GUI
❥ Animations interval ( Default: 2 ticks)
❥ Animations color cycle speed ( Default: 0.85)
❥ Modify GUI items with more options: Custom Model Data, Amount, Glow
❥ Sounds for some actions: Select Effect, Next Page, Previous Page, Reset Effect

❤️ Option for enable/disable auto configuration update
❤️ New command to change locale in-game ( /trelytra locale [LOCALE])
❤️ New particle origin type world (x=0, y=0, z=0 in player's world)
❤️ Update Checker
❤️ Translations for German and Spanish

Changed
❤️ Improved directional value in particle configuration
❥ Optimized vector rotation algorithm
❥ directional will apply to offset value
❤️ Better Rocket effect
❥ It will now display colored redstone particles instead of glow_squid_ink
❥ Its size will change when the player boosts elytra

❤️ Renaming
❥ Renamed messages folder to translations
❥ Renamed messages files to translations_LOCALE.yml
❥ Renamed some effects' name translations to be more accurate
❥ Renamed color schemes to be more accurate

❤️ Translations
❥ Prefixes are now applied with <prefix> tag ( You can now remove prefix from translations)
❥ Notification message is now translatable
❥ Changed message prefix
❥ Changed GUI title message

❤️ Optimized effects task
❤️ Support for single color when spawning colorable particles
❤️ Bumped configurations' versions to 1.3.0

Bug Fixes
❤️ Fixed an issue related to /trelytra notification command
❤️ Fixed config.yml doesn't generate when reloading
❤️ Fixed effects.yml reloading before colors.yml

Removed
❤️ Timings Support

[!] Conditions

• Added mathematical equation support for conditions
  • Example:
    Code (Text):

    conditional ({TIMER}%20==0) ? preset reset-things : return

[!] Bug Fixes

• Fixed the issues related to command responses

[!] Changes

• Added translations for commands
• Updated messages version to 1.2.3 (command translations)
• Updated config version to 1.2.3 (permission for notifications)

[!] Effects GUI

• You can now change the item types and slots in the effects GUI
• Added "Current Effect: EFFECT" lore for the Reset Effects button

[!] Effects

• Added support for `sculk_charge` and `shriek` particles
  • You can define "roll" value for sculk charge effect
  • You can define "delay" value for the shriek effect
• Added icon and description options for effects
• Updated effects version to 1.2.2 (new `sonic` effect for 1.19)

[!] Bug Fixes

• Fixed an issue related to "/trelytra reset" respond message
• Fixed an issue related to the effects GUI

[!] Changes

• Added page argument (optional) for base command "/trelytra [page]"
• Added player argument for reset effect command "/trelytra reset [player]" (admin command)
• Updated messages version to 1.2.2 (new translations)
• Updated config version to 1.2.2 (gui options)

[!] Changes

• 1.19 Support

IMPORTANT NOTE
I've re-coded the effect reading system and you cannot use your current effects.yml file with the new version, you must update your effects by the new scheme or if you haven't changed anything yet, just delete the file and let the plugin create a new version of it.

[NEW] API Support

• TreasureElytra now provides an API for you to add your custom script types
• You can check out the Wiki page for detailed information

[!] Effects

• Added version for effects.yml file (1.2.0)
• Added new effects (current effect size: 28)
• Added support for block_marker and item_crack particles
• Added support for note particles (rainbow & random-note color options)
• Added support for dust_color_transition particle (color transitions)
• You can now define multiple tick handler
  
  Code (YAML):

  onTick:
    preTick:
      times : 3
      scripts :
        - "sound [name=entity.arrow.hit_player,volume=0.1]"
    tick:
      scripts :
        - "variable x=-(cos(({step} / 120) * ({PI} * 2) + ((({PI} * 2) / 3) * 2)))"
        - "variable z=-(sin(({step} / 120) * ({PI} * 2) + ((({PI} * 2) / 3) * 2)))"
        - "particle [effect=redstone,amount=10,direction=true,x={x},y={z},from=feet,colorScheme={name=rainbow;revertWhenDone=true;speed=1}]"
    postTick:
      scripts :
        - "variable step=({step} + 1) % 120"

[!] Bug Fixes

• Fixed an issue related to database
• Fixed the issues with the caching system

[!] Changes

• Added detailed log messages for errors and warnings
• Added "/trelytra reset" and "/trelytra notifications" commands
• Added version for config.yml file (1.2.0)
• Added version for colors.yml file (1.2.0)
• Updated messages version to 1.2.0 (new message translations)

[!] Permissions

• You can define your permissions in config.yml now and use them in your effects
  • In config.yml, put your permission into the `permissions` section with a unique key
  • Then, in effects.yml, set the `permission` value to "%key"
  • Example config.yml
    
    Code (YAML):

    locale : EN
    permissions:
      menu : "trelytra.menu"
      admin : "trelytra.admin"
      rainbow : "trelytra.rainbow"
  • Example effects.yml
    
    Code (YAML):

    effects:
      circle:
        displayName : "%rainbow-circle"
        armorColor : "rainbow"
        permission : "%rainbow" # Defined in config.yml (trelytra.rainbow)
        variables : [ 'r', 'x', 'y' ]
        enableCaching : true
        onTick:
          interval : 1
          times : 32
          do :
           - ...
            - ...
      circleline:
        displayName : "%rainbow-line"
        armorColor : "rainbow"
        permission : "%rainbow" # Defined in config.yml (trelytra.rainbow)
        onTick:
          interval : 1
          times : 8
          do :
           - ...
      spiral:
        displayName : "%rainbow-spiral"
        armorColor : "rainbow"
        permission : "%rainbow" # Defined in config.yml (trelytra.rainbow)
        variables : [ 'x','z','step' ]
        onTick:
          interval : 1
          do :
           - ...
            - ...
          doPost :
           - ...

[!] Script Types

• Added new script types "actionbar <message>", "chat <message>", "title title=<title> &&& subtitle=<subtitle> &&& fadeIn=<fadeIn> &&& stay=<stay> &&& fadeOut=<fadeOut>"
  • MiniMessage Support (do not use color chars like &,§)
  • If you put your variables in {}, they will automatically be replaced with their values
  • Examples:
  • Code (Text):

    actionbar(or chat) <green><b>DEBUG:</b> x={x} y={y}, z={z}
  • Code (Text):

    title title=Active Effect &&& subtitle=<rainbow><b>Rainbow Circle &&& stay=20
• Added new script type "return"
  • When "return" is executed, further lines won't be executed

[!] Bug Fixes

• Fixed an issue related to conditions
• Fixed an issue related to quad helix effect (rotation correction)
• Fixed an issue related to effect reader

[!] Changes

• Removed debug screen (debug mode is still available but has no feature)
• Added disable option for GUI animations to `config.yml`
  • If disabled, GUI won't be animated (no color animations)
• Added tab completion for `/trelytra select <effect-key>` command
• Added permission for debug mode (`trelytra.debug`)
• Added notification system
  • Required permission: `trelytra.notifications`
  • You can now see changelog in-game
  • You will get a notification message every time you join the server, and this can be disabled in `config.yml`
• Optimized login listener

[NEW] Script Types

• Added brand new script types
• conditional [EXPERIMENTAL]
  • Format:
    Code (Text):

    conditional (CONDITION) ? EXECUTE_IF_CONDITION_IS_TRUE : EXECUTE_IF_CONDITION_IS_FALSE
  • Example:
    Code (Text):

    conditional (timer>=20) ? variable timer=0 : variable timer+=1
  • You can define multiple conditions at once (but adding too many conditions is not recommended)
    
  • Example Multiple Conditions:
    Code (Text):

    conditional (reverse==1 && x>90) ? variable reverse=0 : none
    Code (Text):

    conditional ((reverse==1 && x>90) || (reverse==0 && x<0)) ? preset play-sound : none
  • && = AND, || = OR
  • You can't define a boolean variable but you can simulate your variables like boolean by defining them as 0 or 1.
• none
  • Example:
    Code (Text):

    conditional x==50 ? sound [name=entity.arrow.hit_player] : none
  • If x is not equal to 50, nothing gonna happen
• preset
  • Added new file named "presets.yml"
    
  • You can define your presets in this file
    
  • Example (Single Line):
    Code (YAML):

    play-sound : sound [name=entity.arrow.hit_player ]
  • Example (Multiple Lines):
    
    Code (YAML):

    play-sounds :
      - "sound [name=entity.arrow.hit_player]"
      - "sound [name=entity.arrow.hit_player]"
      - ...

[NEW] Permissions

• Added permission for admin commands (trelytra.admin)
  • There was already a hardcoded permission for the admin command, but you can change it whatever you want now
• Added permission for base command (trelytra.menu)
  • You must give base command permission to your players to let them can see the menu

[NEW] Effects

• Added new effects: Helix, Rain, Rocket

[!] Effects

• Changed message files directory to ../TrElytra/Messages/
  
• Added version for message files (current version: 1.1.0)
  
• MiniMessage Support
  
  • From now on, color chars (&,§) chars cannot be used in messages
    
  • MiniMessage Format: https://docs.adventure.kyori.net/minimessage/format.html

[!] Bug Fixes

• Fixed an issue related to cache system
  
• Fixed an issue related to regex patterns
  
• Fixed the reload command is not reloading messages

[!] Changes

• Changed native version to 1.16
  
• Optimized variable evaluations
  
• Removed "speed" option from colors.yml
  
• Added detailed logs for errors
  
• Added option for effects visibility
  
  • Players can toggle effects visibility by using "/trelytra toggle" command
• Added {RANDOM} variable
  
• Added abs(x) support (Absolute value) for mathematical equations
  
• Added debug mode option (to enable, create a file named dev in the TrElytra folder)
  
  • When the debug mode is enabled, you can watch variables and their values
    
  • Debug mode is not optimized for now, only use when there are no players online and needed

[UPDATED] Wiki Page

• https://github.com/ItsZypec/Treasure-Elytra/wiki/

Changes:

• 1.18.2 Support

Changes:

• Fixed an issue related to locale files.
• Added bStats support.

Changes:

• Fixed an issue related to planor effect. No more warnings on the console!
• Added language support.
• Added English translations.
• Added language support to effects.yml. You can select the effect's display name from messages.yml.
• Added all effects' translation (including English) for displayName in messages.yml. You can delete the effects.yml file if you haven't changed anything yet, plugin will automatically create the updated version (English support).

Changes:

• Fixed an issue related to MiniMessage.