NahumInventoryStuff

📦 nahum-Inventory-Stuff

A powerful Minecraft Paper plugin for managing player inventories and ender chests.

📋 Description

nahum-Inventory-Stuff is a comprehensive inventory management plugin for Paper 1.21+ servers. It provides administrators and trusted players with tools to view, transfer, and clear player inventories and ender chests with ease.

👤 Author

Nahum Naranjo

📌 Version

1.0.1

✨ Features

• 🔍 View Player Inventories - See any online player's inventory
• 📦 View Ender Chests - Browse any online player's ender chest
• 🔄 Transfer Inventories - Copy one player's inventory to another
• 🧹 Clear Inventories - Clear specific or all storage types
• 🛡️ Read-Only Viewing - Safe viewing without risk of modifying original items
• ⚡ Fast & Efficient - Optimized for performance with online-only operations

📥 Commands

/echesttools <option> <username>

Manage ender chests.

Examples:

/echesttools see Notch
/echesttools transfer Herobrine Steve
/echesttools clear Alex

/inventorytools <option> <username>

Manage player inventories.

Examples:

/inventorytools see Notch
/inventorytools transfer Herobrine Steve
/inventorytools clear Alex

/inventoryclean <option> <username>

Quickly clear player storage.

Examples:

/inventoryclean all Notch
/inventoryclean echest Steve
/inventoryclean inventory Alex

🔧 Permissions

🚀 Installation

1. Download the nahum-Inventory-Stuff-VERSION.jar or nahum-Inventory-Stuff-VERSION-reobf.jarfile
2. Place it in your server's plugins folder
3. Restart your server or use a plugin manager to load it
4. Configure permissions as needed
5. Enjoy!

💻 Requirements

• Server: Paper 1.21 or higher
• Java: Java 17 or higher
• Dependencies: None (standalone plugin)

⚠️ Important Notes

• Online Players Only - Most commands only work with players who are currently online
• Read-Only Viewing - The see command creates a copy of the inventory, so you cannot accidentally modify items
• No Offline Support - This plugin does not support offline players for security and performance reasons
• Permission Required - All commands require the appropriate permissions

🛠️ Building from Source

1. Clone the repository:

   git clone https://github.com/NahumNaranjo/nahum-Inventory-stuff
   

2. Build with Maven:

   cd nahum-Inventory-Stuff
   mvn clean package
   

3. Find the JAR in the target/ folder

📝 Configuration

This plugin does not require a configuration file. All settings are managed through permissions.

🐛 Reporting Issues

If you encounter any issues, please report them with:

• Server version
• Plugin version
• Steps to reproduce the issue
• Error logs

📄 License

This project is open-source and available for use on Minecraft servers.

🙏 Acknowledgements

• Built for the PaperMC 1.21.11 server software
• Uses the Bukkit/Spigot/Paper API

📞 Support

For support, questions, or feature requests, please contact:

• Author: Nahum Naranjo at his email
• Issues: GitHub Issues

🔄 Version History

v1.0.0

• Initial release
• View, transfer, and clear inventories
• View, transfer, and clear ender chests
• Permission system
• Online-only operation

v1.0.1

• Offline capabilites added to enderchest tools

📊 Example Usage Scenarios

🎮 Staff Moderation

# Check if a player is hacking by viewing their inventory
/inventorytools see suspected_hacker

# Clear a player's inventory as punishment
/inventoryclean all rule_breaker

🏗️ Server Management

# Transfer a builder's inventory to a new player
/inventorytools transfer new_builder master_builder

# Check a player's ender chest for contraband
/echesttools see suspicious_player

🎯 Events & Giveaways

# Clear all players before an event
/inventoryclean all event_participant

# Transfer a prize inventory to a winner
/inventorytools transfer winner prize_account

⚡ Performance

This plugin is optimized for performance:

• ✅ No async operations
• ✅ Direct player lookups
• ✅ Minimal memory usage
• ✅ Fast command execution

Made with ❤️ by Nahum Naranjo