PocketDice

Full changelog: https://github.com/Semarina/PocketDice/releases/tag/v0.2.0

• Platform & compatibility

  • Dropped Spigot/Bukkit support.
  • PocketDice is now a dedicated plugin for Paper, Purpur, and Folia only.
  • Support and bug reports from v0.2.0+ are only provided for Paper-family servers.

• Localization

  • Added locale-based translation system using YAML files under plugins/PocketDice/locale/.
  • Bundled default en_US.yml as the main plugin language.
  • Plugin automatically detects each player’s Minecraft language (e.g. tr_TR) and uses the matching locale file when available, otherwise falls back to en_US.
  • /pocketdice reload now reloads both config and locale files.

• Config & locale update framework (for future versions)

  • Introduced a ConfigUpdater that tracks config-version and can merge new keys into existing config.yml without overwriting user values.
  • Added LocaleUpdater to merge new default strings into existing locale files while preserving custom translations.
  • These systems are primarily for future upgrades (v0.2.0 → later), since v0.1.0 did not support auto-updating.

• Update checker

  • Added Modrinth-based update checker.
  • Checks for new PocketDice releases on startup and optionally on a configurable interval (updates.check_interval_hours).
  • Localized console output and in-game admin notifications.
  • New permission: pocketdice.update.notify (default: op) for join-time update messages.
  • Can be disabled via updates.enabled: false.

• Roll sound

  • New optional “dice rattle” sound when a player successfully rolls /roll.
  • Configurable under sounds.roll in config.yml:
    • enabled, sound_key, volume, pitch.
  • Invalid sound keys are detected and logged once, then skipped to avoid console spam.

• Message & UX improvements

  • All player messages migrated to Adventure Components with MiniMessage formatting.
  • Consistent styled output for roll results, update notifications, and admin messages.
  • /pocketdice reload now sends localized success/failure feedback.
  • /roll still supports shorthand (e.g. /roll d20 as d20) controlled by allow_shorthand.

• Upgrade notes from v0.1.0

  • v0.1.0 did not have locale or auto-config update support.
  • To upgrade safely:
    • Stop server.
    • Backup plugins/PocketDice/config.yml.
    • Delete the entire plugins/PocketDice folder.
    • Replace the JAR with v0.2.0.
    • Start server to regenerate config.yml and locale folder, then re-apply custom config changes.