Перейти к содержимому
Mineforgian

PocketDice

Dungeons & Dragons (D&D) dice (/roll) with proximity radius. Configurable XdY, color-formatted messages, and anti-spam limits. Supports all 1.21.x. Works on Paper/Folia.

Загрузки
438
Подписчики
5
Обновлён
29 мая 2026 г.
Лицензия
MIT

Опубликован 10 ноября 2025 г.

PocketDice — Proximity /roll for Minecraft 1.21.x

Dungeons & Dragons (D&D) dice rolls for Paper/Folia 1.21.x. Players roll dice with /roll (default 1d100) and results are announced only to nearby players. Fully localized (MiniMessage), configurable caps, and optional Modrinth update checks.

Features

  • /roll [NdM] with shorthand (d8) support and configurable defaults/limits.
  • Proximity broadcasts (same world, configurable radius).
  • Per-player locale detection with MiniMessage styling; easy to add translations.
  • Optional roller-only sound effect (configurable sound/volume/pitch).
  • Admin command /pocketdice reload to refresh config/locales.
  • Modrinth update checker with console/admin notifications.

Requirements

  • Paper (OR) Folia (MC 1.21.x)
  • Java 21

Configuration (high level)

  • radius, default_notation, max_dice, max_faces, allow_shorthand
  • sounds.roll: enabled, sound_key, volume, pitch
  • updates: enable/disable, startup check, interval, console/admin notify
  • Locales: plugins/PocketDice/locale/en_US.yml (copy to tr_TR.yml, etc.)

Permissions

  • pocketdice.roll (default: true)
  • pocketdice.reload (default: op)
  • pocketdice.update.notify (default: op)

Ченджлог

0.4.0Бета26.1, 26.1.1, 26.1.2 · 29 мая 2026 г.

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.
0.4.0Бета26.1, 26.1.1, 26.1.2 · 29 мая 2026 г.

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.
0.3.0Бета1.21.9, 1.21.10, 1.21.11 · 8 марта 2026 г.

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.
0.3.0Бета1.21.9, 1.21.10, 1.21.11 · 8 марта 2026 г.

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.
0.2.0Бета1.21.8, 1.21.9, 1.21.10 · 25 ноября 2025 г.

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.
0.1.0Бета1.21.8, 1.21.9, 1.21.10 · 10 ноября 2025 г.

Initial release with proximity /roll and caps rejection.

Комментарии

Загружаем…