?
Host a serverModrinth App
Sign in
ModsResource PacksData PacksShadersModpacksPluginsServers
Settings
Simple Items Perms

Simple Items Perms

Simple Items Perms is a powerful and intuitive plugin that allows you to assign specific permissions

136downloads
1follower
136downloads
1follower

Links

Join Discord server
Donate on PayPal

Tags

Creators

Details

Licensed MIT
Published 11 months ago
Updated 11 months ago
All versions

1.1.0

Release
Simple Items Perms 1.1.011 months ago 32
Download

Compatibility

Minecraft: Java Edition
1.21–1.21.10
Platforms
Paper
Purpur
Spigot

Changes

SimpleItemsPerms

Version Minecraft

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