PocketDice

Highlights

* Minecraft 26.2 support for Paper/Purpur/Folia and Fabric/Quilt. * Dedicated Paper and Fabric builds continue in this release. * Dice shorthand such as /roll d8 is now always enabled. * Removed the allow_shorthand and legacy allow_shorthand_d configuration switches. * Java 25 remains required. *

Platform & artifact selection (IMPORTANT)

v0.5.0 publishes two JARs for Minecraft 26.2: * PocketDice-0.5.0-Paper.jar — Use this for Paper / Purpur / Folia servers. * PocketDice-0.5.0-Fabric.jar — Use this for Fabric servers (also compatible with Quilt loader). Notes: * Do not use the Paper JAR on Fabric/Quilt or the Fabric JAR on Paper/Purpur/Folia. * Fabric requires Fabric Loader 0.19.5 or newer and Fabric API for Minecraft 26.2. * Spigot/plain Bukkit remains unsupported for v0.2.0+. *

Upgrade note from v0.4.0

1. Stop the server and back up your PocketDice configuration. 2. Update the server to Minecraft 26.2 and make sure Java 25 is available. 3. On Fabric/Quilt, update the loader and Fabric API for Minecraft 26.2. 4. Replace the old PocketDice JAR with the correct v0.5.0 JAR for your platform. 5. Start the server. Config behavior: * No config reset is required. * Paper updates config-version to 7 and removes both obsolete shorthand keys. * Fabric stops reading and writing the shorthand setting. * Shorthand is available even if it was previously disabled. * Existing locale files remain usable, including custom messages using {or_d}. *

New

* Minecraft 26.2 compatibility across both platform builds. * Always-enabled shorthand for /roll, /groll, and /proll; d8 means 1d8. *

Improvements & internals

* Fabric/Quilt builds against Fabric API 0.154.0+26.2. * Paper/Purpur/Folia builds against Paper API 26.2.build.48-alpha. * Updated invalid-notation messages to include shorthand examples. * Paper update checks filter out Fabric-only Modrinth releases. * Added a Minecraft 26.2 build profile that generates matching version and platform metadata. *

Summary for upgraders

* Use Minecraft 26.2, Java 25, and the correct platform artifact. * Keep your existing PocketDice configuration and locale files. * Remove shorthand toggles from custom configuration templates; shorthand is always available. * For Minecraft 26.3, use PocketDice v0.6.0.

Highlights

* Minecraft 26.1.x support: PocketDice now targets Minecraft 26.1, 26.1.1, and 26.1.2. * Multi-platform release continues with dedicated builds for Paper-family and Fabric/Quilt servers. * Fabric/Quilt build updated for Fabric Loader 0.19.2 and Fabric API 0.150.0+26.1.2. * Paper/Purpur/Folia build updated against Paper API 26.1.2 stable. * Java 25 is now required. *

Platform & artifact selection (IMPORTANT)

v0.4.0 publishes two JARs: * PocketDice-0.4.0-Paper.jar Use this for Paper / Purpur / Folia servers. * PocketDice-0.4.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.3.0

Upgrading from v0.3.0 → v0.4.0 should be straightforward: 1. Stop the server. 2. Make sure your server is running Minecraft 26.1, 26.1.1, or 26.1.2. 3. Make sure Java 25 is available. 4. Replace the old PocketDice JAR with the correct v0.4.0 JAR for your platform. 5. Start the server. Config behavior: * No config reset is required. * Existing config and locale files should continue to work. * Existing anti-spam, sound, locale, and update-check settings are preserved. *

New

* Minecraft 26.1.x compatibility * Added support for Minecraft 26.1. * Added support for Minecraft 26.1.1. * Added support for Minecraft 26.1.2. * Updated platform targets * Fabric/Quilt now targets the 26.1.2 Fabric toolchain. * Paper/Purpur/Folia now compiles against the 26.1.2 stable Paper API. * Both release artifacts are prepared for the same 26.1.x Modrinth version set. *

Improvements & internals

* Updated build configuration for the 26.1.x release line. * Migrated Fabric-side Minecraft API usage for the current 26.1.x server mappings. * Updated fabric.mod.json and plugin.yml metadata for the new supported game versions. * Updated GitHub Actions to build the release artifacts with Java 25. * Updated README, changelog, and release documentation for the new release. *

Summary for upgraders

* Pick the correct platform artifact: Paper/Purpur/Folia vs Fabric/Quilt. * Use Minecraft 26.1, 26.1.1, or 26.1.2. * Use Java 25. * No config folder deletion or migration reset should be necessary when upgrading from v0.3.0.

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.