📋 Change Log - SMP Utilities

Bug Fix: Whitelist Precedence in Lock/Disable/Ban Systems

Problem

Players with individual item permissions (/idlock allow <player> item <id>) were still being blocked because the system checked global locks BEFORE checking player whitelist.

Fix

Reordered checks in checkItemStatusForPlayer() and checkBlockStatusForPlayer() methods:

Before:

if (lockedItems.contains(itemId)) return "LOCKED";  // ❌ Blocked whitelist
if (hasAllModsAllowed(playerUUID)) return "ALLOWED_FOR_PLAYER";

After:

// ✅ Player permissions checked FIRST
if (hasAllModsAllowed(playerUUID)) return "ALLOWED_FOR_PLAYER";
if (isWhitelisted(playerUUID, itemId)) return "ALLOWED_FOR_PLAYER";
// Then check global status
return checkItemStatus(itemId);

Files Changed

• IdLockData.java
• IdDisableData.java
• IdBanData.java

---

Enhancement: WaystoneSuppression Refactor

Goal

Match the robust event structure of IdDisable while keeping original behavior (triggered by potion effect, no whitelist, TOML config).

What Changed

Feature	Before	After
Armor slot checking	Basic	Full + prevents equipping
Curios support	Basic	Full + prevents equipping
Item usage blocking	Partial	Complete (right-click, attack, interact)
Block interaction	Basic	Complete (place, break, right-click)
Inventory items	Stay in inventory	Stay in inventory (CANNOT use)
Pickup from ground	Allowed	Allowed (unchanged)

New Events Added

• onRightClickItem - Prevents using items
• onAttackEntity - Prevents attacking with suppressed items
• onEntityInteract - Prevents entity interaction
• onHarvestCheck / onBreakSpeed - Prevents mining with suppressed items

Config Fix (TOML format)

Fixed missing quotes:

# Before (broken)
WaystoneSuppression = ["waystones:*", "balm:*", endermanoverhaul:*]

# After (fixed)
WaystoneSuppression = ["waystones:*", "balm:*", "endermanoverhaul:*"]
BannedItems = ["...", "relics:chorus_inhibitor", "relics:enders_hand"]

Files Changed

• WaystoneSuppressionHandler.java - Complete rewrite with IdDisable structure
• WaystoneSuppressionData.java - Fixed TOML quotes in default config

---

Testing Commands

IdLock/IdDisable/IdBan

/idlock disable item-block minecraft:dirt_path
/idlock allow Dev item-block minecraft:dirt_path
# Dev should use item normally ✅

WaystoneSuppression

/effect give @p smp_utilities:waystone_suppression 6000 0
# Suppressed item: shows message, stays in inventory, cannot use
# Suppressed armor: drops, cannot equip

---

Date: 2026-05-10