🐛 Confirmed Bugs¶
These are broken in live testing. Fix these before working on new features.
Difficulty scale: 🟢 Easy (< 1 day) · 🟡 Medium (1–2 days) · 🔴 Hard (several days) · ⚫ Very Hard (week+)
~~Abilities Drain Mana When On Cooldown (rpg-core)~~ ✅ Fixed in rpg-core 1.10.15¶
Added isOnAbilityCooldown() pre-check in ItemAbilityListener that scans each binding for cooldown{} invocations before the pipeline starts. If any cooldown key is active the action-bar message is shown and the binding is skipped entirely — no mana is consumed. Root cause: example chains use mana_cost{} cooldown{} … ordering, so mana was deducted before the cooldown gate could block.
~~Armor Piece Stats Not Applying (rpg-core)~~ ✅ Fixed in rpg-core 1.10.15¶
Root cause: EquipmentListener.onArmorChange called recalc() immediately at MONITOR priority, but Paper fires PlayerArmorChangeEvent before the armor slot is updated — so collectEquipmentStats() read empty slots. Fixed by deferring onArmorChange one tick (matching ArmorSetListener's pattern). Also added PlayerRespawnEvent, InventoryDragEvent, and EntityPickupItemEvent handlers for previously uncovered equip paths, plus a 60-tick periodic resync safety net via startResyncTask().
~~Item/Set Detection Is Flaky — Gear Changes Sometimes Missed (rpg-core)~~ ✅ Fixed in rpg-core 1.10.15¶
Same root fix as above: onArmorChange timing corrected + three new event handlers (PlayerRespawnEvent, InventoryDragEvent, EntityPickupItemEvent) + 60-tick periodic startResyncTask that resyncs every online player as a catch-all safety net.
~~Dungeon Enter Does Nothing (rpg-dungeons)~~ ✅ Fixed in rpg-dungeons 0.0.3¶
TemplatePaster.run() lacked exception handling around dst.setBlockData(). In Paper 1.21.4, block writes to freshly-generated void-world chunks can throw (unloaded-chunk state). The exception escaped the while loop, was swallowed by Bukkit's repeating-task runner, and the task retried the same (x, y, z) coordinate on every tick forever — onDone was never called, player stuck at "Preparing dungeon...". Fixed by wrapping per-block ops in try/finally { advance(); } (failed blocks are skipped) and onDone.accept() in a try-catch (callback failures now log at SEVERE).
~~Potions Disappear + Drink Has No Effect (rpg-core / rpg-alchemy)~~ ✅ Fixed in rpg-alchemy 0.3.1¶
Two root causes:
1. Wrong interception point — PotionDrinkListener was handling PlayerInteractEvent. In Paper 1.21.4, the ServerboundUseItemPacket is already processed server-side before that event fires, so cancelling there did not reliably suppress vanilla. Handler moved to PlayerItemConsumeEvent: vanilla drives the animation, we intercept at consumption time.
2. Effect ID mismatch — potions/example.yml referenced strength_buff and heal_over_time, neither of which existed in the status-effects registry. CoreStatusEffectService.apply() silently no-ops on unknown IDs. Updated to strength_boost and regen.
~~Mining: Vanilla Break Still Visuals (rpg-mining)~~ ✅ Fixed in rpg-mining 0.2.1¶
Mining fatigue amplifier bumped from 1 (Fatigue II) to 255 — vanilla block breaking fully suppressed while holding an RPG gathering tool. Configurable via mining-fatigue.amplifier in plugins/rpg-mining/config.yml.
~~Miner's Pickaxe Can't Mine Red Gem Block (rpg-core)~~ ✅ Fixed in rpg-core 1.1.1¶
Root cause: Mining Fatigue amplifier 255 (applied by rpg-mining to all gathering tools) causes Paper to suppress per-tick BlockDamageEvent because the server-side break-progress-per-tick rounds to 0. BlockBreakHandler used a 400 ms lastClickMs heartbeat fed by BlockDamageEvent to detect "still mining" — with no per-tick events arriving, the timeout expired and cleared progress after the initial click. The BREAKING_POWER gate and tool-type check were both correct all along.
Fixed by:
1. Removing the lastClickMs field and 400 ms timeout entirely from BlockBreakProgress / tickAll(). Release detection now relies on BlockDamageAbortEvent (fired by the client's ABORT_DESTROY_BLOCK packet regardless of Mining Fatigue), getTargetBlockExact() look-away check, and existing PlayerItemHeldEvent / PlayerQuitEvent guards.
2. Adding a PlayerInteractEvent LEFT_CLICK_BLOCK handler as a secondary trigger so progress starts even if the initial BlockDamageEvent is also suppressed in edge cases.
~~Beam Wand: No Damage on Hit or Explosion (rpg-core / rpg-combat)~~ ✅ Fixed in rpg-core 1.0.7¶
Adding damage: 30 to beam_wand (so carriedDamage is non-zero) combined with the ExplodeEffect + DamageEffect PostDamageEvent wiring fixed both the direct hit and AoE explosion paths.
~~Iron Shortsword: Attack Cooldown Stuck at Infinite (rpg-core)~~ ✅ Fixed in rpg-core 1.0.3¶
CoreRpgItem.toItemStack() now removes vanilla attribute modifiers (ATTACK_SPEED, ATTACK_DAMAGE, ARMOR, etc.) from every custom item's ItemMeta. Previously HIDE_ATTRIBUTES only hid them from the tooltip — the modifiers still applied, causing setBaseValue(2.0) + vanilla(-2.4) = -0.4 (bar never filled).
~~Arrows: Weird Visual Behaviour on Hit (rpg-core / rpg-combat)~~ ✅ Fixed¶
Arrow hit visuals corrected; knockback stat added to example weapons and wands.
~~NPC Click Does Nothing — All Behaviors Broken (rpg-npcs)~~ ✅ Fixed in rpg-npcs 0.5.1¶
Three causes fixed:
1. Orphan sweep: NpcManager.loadAll() now sweeps all loaded worlds for rpg_npc_id-tagged entities before despawning and re-spawning. Persistent entities from previous sessions no longer stack up on each reload.
2. Entity type default: changed from VILLAGER → ZOMBIE. Paper's villager trade GUI can fire even when PlayerInteractEntityEvent is cancelled.
3. Handler priority: changed from LOW / ignoreCancelled = true → NORMAL / ignoreCancelled = false. NPC clicks now work even if a third-party listener pre-cancelled the event.
rpg.npcs.use was already default: true — no change needed.
~~Stats Shown in Lore That Do Nothing (rpg-core / rpg-combat)~~ ✅ Resolved¶
speed, ferocity, swing_range all implemented (rpg-core 1.1.0). magic_find wired into loot rolls. pristine, pet_luck, enchanting_luck deferred until their systems are built.
~~Mob Ability Deals No Damage (rpg-core)~~ ✅ Fixed as a side effect of earlier core work¶
The ability configured on testmob (and likely other mobs) fires and runs its animation/effects, but no damage is applied to the target player. The DamageEffect inside the ability pipeline is either not executing or resolving to 0. Check whether AbilityContext is correctly carrying the caster entity and whether DamageEffect falls back to a null or zero stat value when cast from a mob rather than a player.
~~Mob Abilities Damage Players in Creative Mode (rpg-core)~~ ✅ Fixed in rpg-core 1.1.1¶
Added a GameMode.CREATIVE guard in DamageEffect.apply() before the RpgServices.health().damage() call. Mob abilities (and player abilities) no longer damage creative-mode players.
~~Beam Wand: Damage Applied 3× + Health Display Doesn't Refresh (rpg-core)~~ ✅ Fixed¶
Triple-damage and hologram refresh issues both resolved.
~~Frost Golem: Permanent Slowness V (rpg-core)~~ ✅ Fixed in rpg-core 1.3.1¶
ZoneEffect.firePulse() was firing PostDamageEvent with the zone's owner mob as attacker. MobAbilityEventListener sees a non-null attacker and fires the mob's ~onHit abilities. The frost golem's ~onHit freeze{duration=80} therefore triggered on every zone pulse (every 20 ticks = 1 s), refreshing Slowness V to 4 s repeatedly — it never expired. Displayed as "00:00" because Minecraft shows sub-second remaining time as 00:00.
Fix: DamageContext in zone pulses now uses null attacker. Zone damage is environmental AoE, not a direct mob hit — ~onHit should not fire. The victim's ~on_hurt procs still fire correctly (driven by the victim field, not attacker).
~~Dual-Cast Wand: Solar Beam Deals No Damage (rpg-core)~~ ✅ Fixed in rpg-core 1.5.0¶
Appended damage{} to the right-click ability chain in items/example.yml. beam{} sets ctx.target and scales carriedDamage but never delivers damage on its own — a trailing damage{} is required.
~~Mob Ability Stuck Slowness — Permanent Speed Debuff With No Potion Icon (rpg-core)~~ ✅ Fixed in rpg-core 1.8.1¶
Symptom: Player receives permanent slowness from a mob ability that persists across server restarts with no visible potion effect icon. Only a /attribute reset or server-side intervention could clear it.
Root cause: Vanilla Speed/Slowness potion effects add a MULTIPLY_TOTAL AttributeModifier to MOVEMENT_SPEED. If the server stops while the effect is ticking, the modifier is saved to player NBT but the effect may expire during downtime — the modifier becomes orphaned, reducing speed permanently with no corresponding visible effect. This compounded with the freeze{} effect or zone-applied slow status.
Fix (two-part):
1. EquipmentListener.applyMovementSpeed() — when no vanilla Speed or Slowness potion is active, scrubs all MOVEMENT_SPEED modifiers before setting the RPG base value. This handles the restart-orphan case automatically on every gear-change or join recalc.
2. /rpg fix [player] command (permission rpg.core.fix, default: op) — immediately removes vanilla SLOWNESS, clears all MOVEMENT_SPEED modifiers, wipes in-memory RPG status effects, and forces a full attribute resync. Use this when a player reports permanent slowness.
~~Coin Drops Not Depositing to Player Economy (rpg-core)~~ ✅ Fixed in rpg-core 1.0.3¶
Added currency-rolls: section to the mob loot table schema. CoreLootTable.rollCurrency() returns per-player coin amounts; MobLootListener deposits them via RpgServices.economy() immediately on mob death instead of spawning item entities. Requires rpg-economy; silently no-ops if not loaded. Schema: currency-rolls: [{ chance: 80.0, min: 50, max: 150 }].