TDXDevelopment
TDX VotePlusConfiguration

effects

Sound + particle effects played on every vote.

effects.yml controls the sound and the particle burst played for a player when their vote is counted. It is pure feel. The plugin works without it, but a chime and some sparkles make a vote feel like something happened.

The whole file

plugins/TDXVotePlus/effects.yml
sound:
  enabled: true
  name: ENTITY_PLAYER_LEVELUP
  volume: 1.0
  pitch: 1.2

particle:
  enabled: true
  name: HAPPY_VILLAGER
  count: 30
  offset: 0.5

The two blocks are independent. Switch either one off with its own enabled key.

Reference

sound

KeyTypeDefaultNotes
enabledbooleantrue
namestringENTITY_PLAYER_LEVELUPBukkit sound name. entity.player.levelup style ids work too.
volumenumber1.01.0 is normal loudness. Higher values carry further.
pitchnumber1.20.5 to 2.0.

Good alternatives: ENTITY_EXPERIENCE_ORB_PICKUP (subtle ping), BLOCK_NOTE_BLOCK_PLING (bell), UI_TOAST_CHALLENGE_COMPLETE (achievement fanfare).

particle

KeyTypeDefaultNotes
enabledbooleantrue
namestringHAPPY_VILLAGERBukkit particle name.
countint30Particles spawned per vote.
offsetnumber0.5Spread around the player in blocks, the same on all three axes.

Good alternatives: TOTEM_OF_UNDYING, END_ROD, FIREWORK. Pick a particle that needs no extra data. Ones that do, such as DUST or BLOCK, cannot be configured here and will not show.

A sound or particle name the server does not know is skipped without an error, so if nothing plays, check the spelling first.

Offline votes

The effects play when the vote is counted, and only for an online player. A queued offline vote plays them when it is claimed, so a player claiming five votes on join gets five bursts in a row.