Highlights

• 🚀 Multi-platform release: PocketDice now ships dedicated builds for Paper-family and Fabric/Quilt servers.
• 🛡️ New Anti-Spam Guard with per-player cooldowns and sliding-window rate limits.
• 🎲 New roll modes: /groll (global) and /proll (private), plus command aliases.
• ⚙️ Config schema bumped to config-version: 6 with automatic key injection for new anti-spam settings.

⚠️ Platform & artifact selection (IMPORTANT)

v0.3.0 publishes two JARs:

• PocketDice-0.3.0-Paper.jar
  Use this for Paper / Purpur / Folia servers.
• PocketDice-0.3.0-Fabric.jar
  Use this for Fabric servers (also compatible with Quilt loader).

Notes:

• Do not use the Paper JAR on Fabric/Quilt.
• Do not use the Fabric JAR on Paper/Purpur/Folia.
• Spigot/plain Bukkit remains unsupported for v0.2.0+.

⚠️ Upgrade note from v0.2.0

Upgrading from v0.2.0 → v0.3.0 should be straightforward:

1. Stop the server.
2. Replace the old PocketDice JAR with the correct v0.3.0 JAR for your platform.
3. Start the server.

Config behavior:

• The updater moves config to version 6.
• New anti-spam keys are added automatically when missing:
  • cooldowns.*
  • rate_limit.*
• Existing values are preserved where possible.

If you want anti-spam disabled, set:

• cooldowns.enabled: false
• rate_limit.enabled: false

✨ New

• Anti-Spam Guard

  • Per-player cooldown (cooldowns.seconds, default 3).
  • Sliding-window rate limit (rate_limit.window_seconds, rate_limit.max_rolls, defaults 60s / 12).
  • Localized feedback when blocked:
    • messages.roll.cooldown_active
    • messages.roll.rate_limited
  • Bypass permissions for Paper:
    • pocketdice.cooldown.bypass
    • pocketdice.ratelimit.bypass
  • On Fabric, operators bypass by default.

• Additional roll modes

  • /groll [NdM] for global broadcast.
  • /proll [NdM] for private/self-only rolls.
  • Aliases added:
    • /dice for /roll
    • /gdice for /groll
    • /pdice for /proll
    • /pd for /pocketdice

• Fabric/Quilt distribution

  • Dedicated Fabric build with locale, config, update-check, and anti-spam behavior aligned with Paper features.
  • Update-check filtering includes Fabric + Quilt loader compatibility.

🛠 Improvements & internals

• Introduced shared core logic used by platform modules.
• Added robust anti-spam service and tests around parser/anti-spam logic.
• Documentation updated to clarify platform support and command set.

🔄 Summary for upgraders

• Pick the correct platform artifact (Paper vs Fabric/Quilt).
• Review the new anti-spam settings in your config.
• Existing localization/update-check behavior from v0.2.0 remains in place.

Highlights

• 🚀 Multi-platform release: PocketDice now ships dedicated builds for Paper-family and Fabric/Quilt servers.
• 🛡️ New Anti-Spam Guard with per-player cooldowns and sliding-window rate limits.
• 🎲 New roll modes: /groll (global) and /proll (private), plus command aliases.
• ⚙️ Config schema bumped to config-version: 6 with automatic key injection for new anti-spam settings.

⚠️ Platform & artifact selection (IMPORTANT)

v0.3.0 publishes two JARs:

• PocketDice-0.3.0-Paper.jar
  Use this for Paper / Purpur / Folia servers.
• PocketDice-0.3.0-Fabric.jar
  Use this for Fabric servers (also compatible with Quilt loader).

Notes:

• Do not use the Paper JAR on Fabric/Quilt.
• Do not use the Fabric JAR on Paper/Purpur/Folia.
• Spigot/plain Bukkit remains unsupported for v0.2.0+.

⚠️ Upgrade note from v0.2.0

Upgrading from v0.2.0 → v0.3.0 should be straightforward:

1. Stop the server.
2. Replace the old PocketDice JAR with the correct v0.3.0 JAR for your platform.
3. Start the server.

Config behavior:

• The updater moves config to version 6.
• New anti-spam keys are added automatically when missing:
  • cooldowns.*
  • rate_limit.*
• Existing values are preserved where possible.

If you want anti-spam disabled, set:

• cooldowns.enabled: false
• rate_limit.enabled: false

✨ New

• Anti-Spam Guard

  • Per-player cooldown (cooldowns.seconds, default 3).
  • Sliding-window rate limit (rate_limit.window_seconds, rate_limit.max_rolls, defaults 60s / 12).
  • Localized feedback when blocked:
    • messages.roll.cooldown_active
    • messages.roll.rate_limited
  • Bypass permissions for Paper:
    • pocketdice.cooldown.bypass
    • pocketdice.ratelimit.bypass
  • On Fabric, operators bypass by default.

• Additional roll modes

  • /groll [NdM] for global broadcast.
  • /proll [NdM] for private/self-only rolls.
  • Aliases added:
    • /dice for /roll
    • /gdice for /groll
    • /pdice for /proll
    • /pd for /pocketdice

• Fabric/Quilt distribution

  • Dedicated Fabric build with locale, config, update-check, and anti-spam behavior aligned with Paper features.
  • Update-check filtering includes Fabric + Quilt loader compatibility.

🛠 Improvements & internals

• Introduced shared core logic used by platform modules.
• Added robust anti-spam service and tests around parser/anti-spam logic.
• Documentation updated to clarify platform support and command set.

🔄 Summary for upgraders

• Pick the correct platform artifact (Paper vs Fabric/Quilt).
• Review the new anti-spam settings in your config.
• Existing localization/update-check behavior from v0.2.0 remains in place.

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.

Initial release with proximity /roll and caps rejection.