
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 reloadto 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_shorthandsounds.roll: enabled, sound_key, volume, pitchupdates: enable/disable, startup check, interval, console/admin notify- Locales:
plugins/PocketDice/locale/en_US.yml(copy totr_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:
- Stop the server.
- Make sure your server is running Minecraft 26.1, 26.1.1, or 26.1.2.
- Make sure Java 25 is available.
- Replace the old PocketDice JAR with the correct
v0.4.0JAR for your platform. - 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.jsonandplugin.ymlmetadata 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:
- Stop the server.
- Make sure your server is running Minecraft 26.1, 26.1.1, or 26.1.2.
- Make sure Java 25 is available.
- Replace the old PocketDice JAR with the correct
v0.4.0JAR for your platform. - 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.jsonandplugin.ymlmetadata 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:
- Stop the server.
- Replace the old PocketDice JAR with the correct
v0.3.0JAR for your platform. - 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: falserate_limit.enabled: false
✨ New
Anti-Spam Guard
- Per-player cooldown (
cooldowns.seconds, default3). - Sliding-window rate limit (
rate_limit.window_seconds,rate_limit.max_rolls, defaults60s/12). - Localized feedback when blocked:
messages.roll.cooldown_activemessages.roll.rate_limited
- Bypass permissions for Paper:
pocketdice.cooldown.bypasspocketdice.ratelimit.bypass
- On Fabric, operators bypass by default.
- Per-player cooldown (
Additional roll modes
/groll [NdM]for global broadcast./proll [NdM]for private/self-only rolls.- Aliases added:
/dicefor/roll/gdicefor/groll/pdicefor/proll/pdfor/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
corelogic 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.0remains 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:
- Stop the server.
- Replace the old PocketDice JAR with the correct
v0.3.0JAR for your platform. - 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: falserate_limit.enabled: false
✨ New
Anti-Spam Guard
- Per-player cooldown (
cooldowns.seconds, default3). - Sliding-window rate limit (
rate_limit.window_seconds,rate_limit.max_rolls, defaults60s/12). - Localized feedback when blocked:
messages.roll.cooldown_activemessages.roll.rate_limited
- Bypass permissions for Paper:
pocketdice.cooldown.bypasspocketdice.ratelimit.bypass
- On Fabric, operators bypass by default.
- Per-player cooldown (
Additional roll modes
/groll [NdM]for global broadcast./proll [NdM]for private/self-only rolls.- Aliases added:
/dicefor/roll/gdicefor/groll/pdicefor/proll/pdfor/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
corelogic 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.0remains 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.ymlas 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 toen_US. /pocketdice reloadnow reloads both config and locale files.
- Added locale-based translation system using YAML files under
Config & locale update framework (for future versions)
- Introduced a
ConfigUpdaterthat tracksconfig-versionand can merge new keys into existingconfig.ymlwithout overwriting user values. - Added
LocaleUpdaterto 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.
- Introduced a
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.rollinconfig.yml:enabled,sound_key,volume,pitch.
- Invalid sound keys are detected and logged once, then skipped to avoid console spam.
- New optional “dice rattle” sound when a player successfully rolls
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 reloadnow sends localized success/failure feedback./rollstill supports shorthand (e.g./roll d20asd20) controlled byallow_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/PocketDicefolder. - Replace the JAR with v0.2.0.
- Start server to regenerate
config.ymlandlocalefolder, 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.
Комментарии
Загружаем…