PocketDice

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.