ChangeLog 0.2.4 -> 0.2.5-BETA

Please read this!

This is only a pre-release beta version. Please report any errors, bugs, glitches, etc., on the developer’s Discord server! These features are still being tested and are not yet fully implemented for release!

Updates

Conditions in Effects

The plugin includes a built-in system of conditions that allows certain actions to be performed only when specific conditions are met.

New [condition] effect

# This effect does not support the short form; there are checks in place for that

- type: condition
  if: “%player_health% < 10.0”
  do:
    - “[potion] [player] give REGENERATION 10s 2”
    - “[message] [player] &aHealth restored!”
  else:
    - “[message] [player] &cYou already have enough health.”

Examples:

- if: ‘200 == 200’
- if: ‘has super.permission’ # if the player has the permission
- if: ‘!has super.permission’ # if the player does not have the permission
- if: ‘string has str’ # the string contains
- if: ‘string !has str’ # the string does not contain
- if: ‘string HAS str’ # the string contains (case-insensitive)
- if: ‘string !HAS str’ # the string does not contain (case-insensitive)
- if: ‘string == string’ # the string is equal to
- if: ‘string != string’ # the string is not equal to
- if: ‘nearby world 10 10 10 100’ # condition that the player is within a 100-block radius of coordinates 10 10 10 in the world

- if: ‘{COOLDOWN_STATUS} == true’
  do:
    - eco: ‘player take 1000’
  else:
    - ‘&fCooldown in effect! Please wait <red>{time:detail}</red>!’

New Effects:

BossBar

Create/update/delete a boss bar by its unique identifier

Types:

- [bossbar] [target] [create] <id bar> <color> <style> <progress> <title>
- bossbar: '[target] [update] <id bar> <color> <style> <progress> <title>'
- bossbar: „[remove] <id bar>“

- type: bossbar
  target: player
  actions: «create» # create/update/remove
  id: my_bossbar
  color: RED # PINK, BLUE, RED, GREEN, YELLOW, PURPLE, WHITE
  style: SOLID # SOLID, SEGMENTED_6, SEGMENTED_10, SEGMENTED_12, SEGMENTED_20
  progress: 100 # As a percentage or from 0.0 to 1.0
  title: “<red>Attention!</red>”

Set on Fire

Set the target object on fire

Types:

- [burn] [target] give <time> [deal damage (true/false)]
- [burn] clear <time> [deal damage (true/false)]

- type: burn
  target: player
  action: “give/clear”
  time: 5s
  damage: false

Economy

Managing the plugin’s economy

Types:

- "[eco] [target] [give] <value>"
- eco: „[take] <value>“
- eco: „reset“

- type: eco
  target: player
  action: „give“ # give/take/reset/set
  amount: 1000

Delay

Plugin Economy Management

Types:

- '[delay] [time] [“<cmd1>”, “<cmd2>”, “<cmd3>”, “...”, “<cmdN>”]'
- delay: 
    time: 5s
    effects:
      - ‘console msg The effect triggered!’
- delay: ‘2s [“[console] [msg] The effect triggered!”]’

- type: delay
  target: player
  time: 5s
  effects:
    - ‘<...>’

New [potion] Effect Type

The [potion] effect now supports applying multiple effects at once (each with its own configurable drop chance in percent)

Examples:

- potion: 'give {<effect id>: <chance>; <effect id>: <chance>} <time> <level> [fall (true/false)]'
- potion: ‘give {SPEED: 100; JUMP_BOOST: 50} 200 1’ # Grant the player either SPEED with a 100% chance or JUMP_BOOST with a 50% chance for 10 seconds (200 ticks)

- type: potion
  target: player
  mode: “give”
  effects:
    SPEED: 100.0 # Effect: chance of being granted (100%)
    JUMP_BOOST: 50.0 # Effect: chance of being granted (50%)
  level: “1”
  duration: 10s
  fall: false # Should the slow-fall effect be granted after the duration ends?

API and Addons

A powerful API for developers, LastItemsAPI, has been added to the plugin. Now you don’t have to wait for new plugin updates to get a new effect or trigger!

You can load addons using the command /lastitems addon <load/unload/reload/list>.

Developers can now:

• Create their own effects: Register custom actions in the configuration via the EffectRegistry.register(...) API. For example, you can create a [spawn_mob] effect, and players will be able to use it in their config.
• Create their own target entities: Add new types of targets (e.g., [nearby_players], [damager]) via the TargetRegistry.register(...) API.
• Create custom triggers: Register triggers that will respond to custom events (using TriggerRegistry.register(...)). Triggers will also be read dynamically from the configuration.

New Triggers

Three new triggers have been added to the plugin.

• on_item_slot:[time] - A trigger that allows effects to be executed cyclically (every N time units) while an item is held in the hand or equipped as armor. If the [time] argument is not specified, the default effects will be triggered every 20 ticks (1 second).
• on_shift_right_click - Triggers when the player holds down SHIFT and clicks the right mouse button.
• on_shift_left_click - Triggers when the player holds down SHIFT and clicks the left mouse button.

New Local Placeholders

Several new placeholders have been added to the plugin that work within the plugin itself.

• {COOLDOWN_STATUS} - Returns true/false depending on whether the item has a cooldown
• {COOLDOWN_TIME} - Displays the cooldown time in seconds
• {COOLDOWN} - Same as {COOLDOWN_TIME}
• {COOLDOWN_TIME:<format time>} - Displays the cooldown time in the specified time format

Plugin Economy Integration

You can now use effects to manage the economy of a plugin defined in config.yml

economy:
  enable: true
  provider: Vault # Vault, VaultUnlocked, PlayerPoints

Fixes

• Fixed a bug where right-clicking with a sword or tools caused effects to either not trigger or trigger incorrectly.
• Fixed an error where the plugin displayed “Item is delayed” even though there was actually no delay.
• Removed unnecessary debug messages such as '[Debug] Action conditions not met...'