SmartSpawner - Version 1.5.4

🐛 Bug Fixes

UI & Display

• Fixed %time% placeholder flickering when clicking sell/claim exp on the info button in the spawner menu
• Improved hologram stability - Holograms now properly clean up after server restarts and chunk reloads, preventing ghost holograms from accumulating

Chunk Limit System

• Fixed initialization bug that could affect spawner chunk limits

Third-Party Compatibility

• Updated SuperiorSkyblock2 integration to use better API methods
• Added Residence plugin support for region protection compatibility

✨ New Features

📊 Comprehensive Logging System

A powerful new logging system to track all spawner activities and player interactions:

Core Features:

• Zero Performance Impact - Fully asynchronous with automatic batch writing every 2 seconds
• Flexible Storage - Choose between JSON or human-readable formats with automatic file rotation
• Granular Control - Enable/disable specific events from 21 different event types
• Discord Integration - Beautiful rich embeds with color-coded events and player avatars

What Gets Logged:

• Spawner lifecycle (place, break, explode)
• Stacking operations (hand, GUI, destack)
• GUI interactions (main menu, storage, stacker)
• Economy actions (XP claims, selling items)
• Storage management (take all, drop, sort, filters)
• Commands (player, console, RCON - captures ALL admin actions)
• Entity type changes

Log Output Examples

Human-Readable: (.log)

[2025-10-12 18:30:45] Spawner placed | Player: Steve | Location: world (100, 64, 200) | Entity: ZOMBIE | quantity=1
[2025-10-12 18:31:20] Command executed by player | Player: Admin | command=give full_command=/ss give Steve zombie 5
[2025-10-12 18:32:10] All items taken from storage | Player: Steve | items_taken=64 items_left=0

JSON: (.json)

{"timestamp":"2025-10-12 18:30:45","event_type":"SPAWNER_PLACE","player":"Steve","player_uuid":"069a79f4-44e9-4726-a5be-fca90e38aaf5","location":{"world":"world","x":100,"y":64,"z":200},"entity_type":"ZOMBIE","metadata":{"quantity":1}}
{"timestamp":"2025-10-12 18:31:20","event_type":"COMMAND_EXECUTE_PLAYER","player":"Admin","player_uuid":"069a79f4-44e9-4726-a5be-fca90e38aaf6","metadata":{"command":"give","full_command":"/ss give Steve zombie 5"}}
{"timestamp":"2025-10-12 18:32:10","event_type":"SPAWNER_ITEM_TAKE_ALL","player":"Steve","player_uuid":"069a79f4-44e9-4726-a5be-fca90e38aaf5","location":{"world":"world","x":100,"y":64,"z":200},"entity_type":"ZOMBIE","metadata":{"items_taken":64,"items_left":0}}

Discord Webhook Features:

• 🎨 Color-coded embeds organized by event category
• 👤 Player skin/head thumbnails via https://mc-heads.net/
• ⚙️ Fully customizable titles, descriptions, and fields
• 🛡️ Rate limiting protection (Discord API compliant)
• 🔄 20+ placeholder variables for custom formatting

and more...

Hologram Placeholders

Two new percentage-based placeholders are now available for hologram customization:

• %percentage_storage%% - Displays storage capacity as a percentage (e.g., 75.5%)
• %percentage_exp%% - Displays experience capacity as a percentage (e.g., 50.0%)

New Commands

/ss clear holograms

• Kill all text display holograms from the server
• Useful for cleaning up hologram displays after configuration changes or when holograms get stuck
• Permission: smartspawner.command.clear

/ss clear ghost_spawners

• Automatically detects and removes broken spawners without physical blocks
• Runs asynchronously to prevent server lag
• Provides detailed feedback on the number of spawners cleaned
• Permission: smartspawner.command.clear

Permission Updates

All command permissions now use a consistent .command prefix:

• smartspawner.command.use - Main command access (replaces smartspawner.admin)
• smartspawner.command.reload - Reload configuration
• smartspawner.command.give - Give spawners to players
• smartspawner.command.list - Access spawner list admin
• smartspawner.command.hologram - Toggle holograms
• smartspawner.command.prices - View spawner prices
• smartspawner.command.clear - Clear holograms and ghost spawners

Configuration Updates

• Updated mob_drops.yml - All mob drop rates have been corrected based on official Minecraft Wiki data. We recommend updating your configuration file to benefit from these accuracy improvements.

⚡ Performance Improvements

This update includes significant performance optimizations:

• Improved spawner range checking - Now runs most calculations efficiently and asynchronously
• Reduced server load - Optimized entity spawning process to use fewer resources
• Better memory usage - Spawners now handle entity creation more efficiently, reducing memory allocation
• Faster chunk operations - Optimized how the plugin interacts with world data

These changes should result in smoother gameplay, especially on servers with many spawners.

---

Important: If you're upgrading from an older version, please review the permission changes and update your permission plugin accordingly. The new logging system is enabled by default but can be disabled in the configuration.