🔥 HOTFIX v1.1.1

CRITICAL BUGFIX — UPDATE REQUIRED

Release Date: November 23, 2025

⚠️ What Was Fixed

A critical issue involving permission-based lore visibility has been resolved.

❗ The Problem

When assigning a permission to an item, the plugin showed the lore:

✘ You don't have permission to use this

However, even players who DID have the required permission were still able to see this warning.
The lore was not being correctly hidden.

🛑 Why It Happened

The plugin compared the lore text using an exact string match, including all color codes.
This caused mismatches whenever:

an item was created with a specific lore message
later, that message was changed inside the language file

Because of this, the check failed:

savedLore ≠ updatedLore

✔️ What’s Fixed

✓ Dynamic lore system now functions correctly
✓ Lore automatically hides for players who have the required permission
✓ Fully compatible with items created in v1.0.0 and v1.1.0
✓ Comparison now ignores color formatting
✓ The hide-for-permitted-players option now works as intended
✓ Updating the lore text in language files no longer breaks the system

📦 Recommended Update

This hotfix addresses a core logic flaw affecting player experience and permission consistency.
Updating is strongly recommended for all servers.

SimpleItemsPerms

The Ultimate Permission System for Minecraft Items

SimpleItemsPerms v1.1.0

Release Date: November 22, 2025

This is a major update that brings multi-language support, advanced item management, and numerous improvements!

✨ New Features

🌍 Complete Multi-Language System

Added full English and Italian translations
Language files system in plugins/SimpleItemsPerms/lang/
All GUI elements, commands, and messages are now translatable
Dynamic language switching with /sip reload - no restart needed!
Zero hardcoded strings - everything is customizable

📊 Item Registry & Management System

Global Item Registry - Track all items with permissions across the server
Item List GUI (/sip list) - Browse all registered items with pagination
Item Details GUI - View detailed information about each registered item
- See creator, creation date, and usage statistics
- View enchantments and custom lore
- Delete items from registry with one click
Statistics tracking for how many times each item has been given

📈 bStats Integration

Added bStats metrics for anonymous usage statistics
Custom chart tracking total number of items with permissions
Embedded version to prevent conflicts with other plugins
Fully privacy-compliant and can be disabled

🔧 Improvements

🛠️ Core System Enhancements

Fixed items without ItemMeta - Vanilla items (pickaxes, swords, etc.) without metadata now work correctly
Improved NBT data handling with better null-safety checks
Enhanced permission system with more robust validation
Optimized event listeners for better performance

🎨 GUI Improvements

All GUI titles and buttons now use language files
Button names and lore are fully translatable
Improved visual feedback with better color coding
More intuitive navigation between different GUIs

💬 Chat System Overhaul

All chat prompts now support translations
Interactive click components are language-aware
Improved error messages with more context
Better permission denial feedback

⚙️ Configuration Updates

Simplified config.yml structure
Lore text moved to language files for better translation support
Added comments explaining all configuration options
Language file auto-extraction on first startup

🐛 Bug Fixes

✅ Fixed: Items without ItemMeta (vanilla items) causing errors
✅ Fixed: bStats initialization conflicts with other plugins
✅ Fixed: Language files not being created on first run
✅ Fixed: GUI button labels remaining in default language
✅ Fixed: Lore text not updating when changing language
✅ Fixed: Permission validation accepting invalid characters
✅ Fixed: Memory leak in item registry system

📦 Technical Details

Added Files

lang/messages_en_US.yml - English language file
lang/messages_it_IT.yml - Italian language file
it/alessiogta/simpleItemsPerms/metrics/Metrics.java - Embedded bStats
it/alessiogta/simpleItemsPerms/gui/ItemsListGUI.java - Items list interface
it/alessiogta/simpleItemsPerms/gui/ItemDetailsGUI.java - Item details interface

Changed Files

SimpleItemsPerms.java - Added language file extraction and bStats initialization
MessageManager.java - Added support for language files and lists
ConfigManager.java - Updated to use MessageManager for translatable text
PermissionGUI.java - Fully integrated with language system
All listener classes updated for better error handling

Dependencies

No external dependencies required
bStats is embedded (no separate download needed)
Compatible with all permission plugins (LuckPerms, PermissionsEx, etc.)

🎯 Compatibility

✅ Minecraft: 1.21, 1.21.1, 1.21.3+
✅ Server Software: Spigot, Paper, Purpur, Pufferfish
✅ Java Version: Java 21+
✅ API Version: 1.21+

📊 Statistics

Lines of Code Added: ~2,500
Translation Keys: 100+ (50+ per language)
New Commands: 1 (/sip list)
New GUI Screens: 2 (List & Details)
Bug Fixes: 7 major issues resolved

🔄 Migration Notes

Updating from v1.0.0

Backup your data - Always backup before updating!
Stop your server
Replace the JAR - Delete old version, add new version
Start the server - Language files will be created automatically
Review config.yml - Some options have been moved to language files
Test permissions - Existing items will continue to work without changes

Configuration Changes

The lore.no-permission-text option has been moved from config.yml to language files:

Before: config.yml → lore.no-permission-text
After: lang/messages_XX_XX.yml → lore-no-permission

Your old items will continue to work! Only new items will use the updated lore.

🌟 What's Next?

Planned for v1.2.0

🔔 Update Checker - Automatic notification when new versions are available
🎨 Custom GUI Themes - Predefined color schemes
📝 Permission Templates - Save and reuse permission configurations
🔄 Bulk Operations - Assign permissions to multiple items at once
🌐 More Languages - Community-contributed translations

💝 Credits

Developer: AlessioGTAII
Testing: Community testers
Translations:
- 🇬🇧 English: AlessioGTAII
- 🇮🇹 Italian: AlessioGTAII
Special Thanks: All users who provided feedback!

Thank you for using SimpleItemsPerms! ❤️

Developed with ❤️ by AlessioGTAII

Simple Items Perms

Simple Items Perms 1.1.1