Word Scrambler Config Management Update | 1.3.08-2025

WordScramblers Config Management Update | v1.3.08-2025

Highlights

• Standalone config generation: If plugins/WordScramblers/config.yml is missing, it’s created automatically with the full commented template.
• Config management command: New /wordscrambler-config with reload and a confirmation-based regenerate.

New

• Command: /wordscrambler-config
  • reload: Reloads config and restarts the plugin.
  • regenerate: Click-to-confirm; overwrites config.yml with the default template, then reloads.
  • Tab completion suggests reload and regenerate (permission-aware).
• Command: /wordscramblerreward (renamed from /WordRewardRegister)
  • Registers the item in your main hand as the reward.
• Command: /wordscramblerHelp (admin-only)
  • Shows admin command help.

Permissions

• wordscramblers.admin: Admin umbrella permission (includes both below).
• wordscramblers.config.reload: Use /wordscrambler-config reload.
• wordscramblers.config.regenerate: Use /wordscrambler-config regenerate.

Changes

• Renamed command: /WordRewardRegister → /wordscramblerreward.
• Removed “restart” alias; use reload.
• plugin.yml updated with new commands, permissions, and version.
• Added tab completion for /wordscrambler-config.

Fixes

• Resolved startup error when config.yml wasn’t found in the jar.
• Config is now generated programmatically (keeps comments and formatting exactly as provided).

Upgrade notes

• Update any docs/macros to use /wordscramblerreward instead of /WordRewardRegister.
• To regenerate a fresh default config:
  • Run /wordscrambler-config regenerate and click [YES], or
  • Delete plugins/WordScramblers/config.yml and restart the server.

Commands quick reference

/wordscrambler-config reload
/wordscrambler-config regenerate
/wordscramblerReward
/wordscramblerHelp

Sound Effect update

New Features & Improvements

Custom Sounds for Event Phases

Added customizable sounds for:

• Event Start (event_start_sound): Plays when the scrambling event begins.
• Event Win (event_end_win_sound): Plays when a player wins the event (for everyone) and (win_sound) for individual.
• Event End (No Winner) (event_end_nobody_sound): Plays when no one guesses the word.
  Configure these sounds in the config.yml (see example below).

Victory Title Screen:
Winners now receive a customizable title on their screen with:
A main title (win_title_main) and subtitle (win_title_sub).

Configurable fade-in, stay, and fade-out timings (win_title_fade_in, win_title_stay, win_title_fade_out).

Enhanced Win Feedback:
Winners also hear a dedicated win sound (win_sound) alongside the title.