Effects and sounds

Fireworks, knockback, the rainbow carpet, the glow, and every sound the plugin plays.

The bits that make a party feel like a party.

Fireworks

When the piñata breaks, a run of fireworks goes off where it was standing.

config.yml

fireworks:
  enabled: true
  amount: 5
  power: 2
  delay: 5
  effects:
    - "BALL_LARGE,LIME,true,false"
    - "STAR,RED,true,true"
    - "BURST,AQUA,false,true"

Key	What it does
`enabled`	Master switch for the whole finale.
`amount`	How many fireworks are launched in total.
`power`	Flight time. `0` is instant, `3` is about as high as is sensible. Each step is roughly half a second.
`delay`	Server ticks between launches. 20 ticks is one second.
`effects`	The look of each firework. One entry is picked at random per launch.

Writing an effect

A firework effect line split into its four parts, shape, color, flicker and trail, with the five shape types drawn beneath

Each entry is four values separated by commas:

TYPE,COLOR,flicker,trail

Part	Values
`TYPE`	`BALL`, `BALL_LARGE`, `STAR`, `BURST`, `CREEPER`
`COLOR`	A Bukkit color name (`RED`, `LIME`, `AQUA`, `FUCHSIA`, `ORANGE`, ...), a dye color name (`MAGENTA`, `LIGHT_BLUE`, `PINK`, `CYAN`, `BROWN`, ...), or a hex value like `#FF8800`
`flicker`	`true` or `false`. Adds a twinkle. Can be left off.
`trail`	`true` or `false`. Adds a particle trail. Can be left off.

effects:
  - "BURST,#FF8800,true,true"
  - "CREEPER,LIME,false,false"

An entry that does not parse is skipped with one line in the console telling you which one. If none of them parse you get a plain lime ball, so the finale never fails outright.

Fireworks from the plugin cannot hurt anyone. Damage from them is cancelled, so nobody dies to the celebration.

Knockback

Two separate things use the same numbers: the shove on a normal hit, and the shove everyone gets when the piñata breaks.

config.yml

pinata:
  knockback:
    chance: 50.0
    strength: 0.8
    upward-strength: 0.5
    sound: "ENTITY_ZOMBIE_ATTACK_WOODEN_DOOR"
    particle:
      enabled: true
      type: "EXPLOSION_NORMAL"
      count: 10

Key	What it does
`chance`	Chance out of 100 that a landed hit shoves the player. `0` turns hit knockback off.
`strength`	How far they are flung. Around `0.3` to `1.5` is the useful range.
`upward-strength`	How high. `0` keeps it flat.
`sound`	Played to the player who is shoved. Leave empty for none.
`particle.enabled`	Whether a particle burst goes with it.
`particle.type`	Any Bukkit particle name. Common ones are `EXPLOSION_NORMAL`, `CRIT`, `FLAME`, `HEART`, `CLOUD`.
`particle.count`	How many particles per burst.

When the piñata breaks, everyone within 25 blocks is shoved away from it using strength and upward-strength. That one always happens and is not affected by chance.

The rainbow carpet

A llama piñata wears a carpet on its back that flashes through a list of colors.

config.yml

pinata:
  carpet:
    enabled: true
    colors:
      - RED_CARPET
      - ORANGE_CARPET
      - YELLOW_CARPET
      - LIME_CARPET
      - LIGHT_BLUE_CARPET
      - BLUE_CARPET
      - PURPLE_CARPET
      - MAGENTA_CARPET
    interval: 8

Key	What it does
`enabled`	Whether the carpet cycles at all.
`colors`	The colors it steps through, in order, looping back to the first. Any material ending in `_CARPET`.
`interval`	Ticks between color changes. Lower is faster. Minimum 1.

This only works when pinata.type is LLAMA. No other mob can wear a carpet, so it is silently ignored for anything else.

Entries that are not real carpets are skipped with a console warning, so a typo costs you one color rather than the whole effect.

Glow

config.yml

pinata:
  glow: true

Puts an outline around the piñata that players can see through blocks. Handy in a big arena, or turn it off if you want people to have to hunt for it.

Sounds

A left to right timeline of one party marking which sound plays at each moment and whether everyone online or only players nearby can hear it

Every value must be a Bukkit sound name. Leave one empty to turn it off.

config.yml

sounds:
  spawn: "ENTITY_LLAMA_AMBIENT"
  hit: "ENTITY_ARROW_HIT_PLAYER"
  death: "ENTITY_GENERIC_EXPLODE"
  end: "UI_TOAST_CHALLENGE_COMPLETE"
  countdown: "BLOCK_NOTE_BLOCK_PLING"

Key	When it plays	Who hears it
`spawn`	The piñata appears	Players near the spawn point
`hit`	A hit lands	The player who hit
`death`	The piñata breaks	Players near the piñata
`end`	After the finale	Everyone online
`countdown`	Each second of the countdown	Everyone online
`pinata.knockback.sound`	A hit shoves the player	The player who was shoved

A name the server does not recognise is skipped with a single console warning rather than breaking the party. Check the console if a sound is not playing.

Fireworks

Writing an effect

Knockback

The rainbow carpet

Glow

Sounds

On this page