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

1. Backup your data - Always backup before updating!
2. Stop your server
3. Replace the JAR - Delete old version, add new version
4. Start the server - Language files will be created automatically
5. Review config.yml - Some options have been moved to language files
6. 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