Null Attribute Remover

Minecraft 版本： 1.17 1.17.1 1.18 1.18.1 1.18.2 1.19 1.19.1 1.19.2 1.19.3 1.19.4 1.20 1.20.1 1.20.2 1.20.3 1.20.4 1.20.5 1.20.6 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10

平台： paper spigot

标签： game-mechanics optimization utility

NullAttributeRemover

A lightweight Bukkit/Spigot plugin that scans and removes broken or invalid attribute modifiers from players to prevent crashes and instability.
Originally created to fix java.lang.NullPointerException in corrupted player data.

? What It Does

This plugin scans player attributes for:

• ❌ null or duplicate UUIDs (even across attributes)
• ❌ NaN or Infinity values
• ❌ Invalid or missing operations
• ❌ null, blank, or UUID-looking modifier names
• ❌ Fully broken modifiers (null entries)

If any are found, they’re removed automatically.
The scan can be triggered manually or on events like teleport, respawn, world change, etc.

⚙️ How It Works

• Checks every attribute on a player (GENERIC_MAX_HEALTH, etc.)
• Inspects each modifier’s:
  • UUID validity and uniqueness
  • Name validity (including if it looks like a UUID)
  • Value sanity (no NaN, Infinity, or zero junk)
  • Operation type
• If any part is broken or suspicious, it’s removed
• If a modifier’s UUID is reused in multiple places, all duplicates are removed
• Optional logs and messages are configurable

? Configuration

# config.yml
silent: false                # Suppresses player chat messages
kickOnFailure: true          # Kick player if bad modifiers can’t be removed
log-to-console: true         # Show scan results in console
log-to-file: true            # Save scan logs to plugins/NullAttributeRemover/nar.log
logUUIDLikeNames: true       # Warn if modifier name looks like a UUID
log-invalid-uuid-names: true # If false, suppress logs like "Skipped bad UUID: armor.boots"
debugLogs: true              # Enable detailed internal debug logs

? Commands

The plugin uses tab completion for all commands.

? Compatibility

• Requires Java 17 or newer
• Works with Minecraft 1.17+
• Designed for Paper, may also work on Spigot and forks