NahumInventoryStuff

[h1] nahum-Inventory-Stuff [/h1]
A powerful Minecraft Paper plugin for managing player inventories and ender chests.

[hr=3][/hr]
[hr=3][/hr]

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.

[hr=3][/hr]
[hr=3][/hr]

Author

Nahum Naranjo

[hr=3][/hr]
[hr=3][/hr]

Version

1.1.0

[hr=3][/hr]
[hr=3][/hr]

✨ 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

[hr=3][/hr]
[hr=3][/hr]

Commands

[icode]/echesttools <option> <username> [/icode]

Manage ender chests.

| Option | Description | Usage |
|[hr=3][/hr]
[hr=3][/hr]|[hr=3][/hr]
[hr=3][/hr]|[hr=3][/hr]
[hr=3][/hr]|
| see | View a player's ender chest | /echesttools see <player> |
| transfer | Copy one player's ender chest to another | /echesttools transfer <recipient> <giver> |
| clear | Clear a player's ender chest | /echesttools clear <player> |

Examples:
`bash
/echesttools see Notch
/echesttools transfer Herobrine Steve
/echesttools clear Alex
`

[hr=3][/hr]
[hr=3][/hr]

[icode]/inventorytools <option> <username> [/icode]

Manage player inventories.

| Option | Description | Usage |
|[hr=3][/hr]
[hr=3][/hr]|[hr=3][/hr]
[hr=3][/hr]|[hr=3][/hr]
[hr=3][/hr]|
| see | View a player's inventory | /inventorytools see <player> |
| transfer | Copy one player's inventory to another | /inventorytools transfer <recipient> <giver> |
| clear | Clear a player's inventory | /inventorytools clear <player> |

Examples:
`bash
/inventorytools see Notch
/inventorytools transfer Herobrine Steve
/inventorytools clear Alex
`

[hr=3][/hr]
[hr=3][/hr]

[icode]/inventoryclean <option> <username> [/icode]

Quickly clear player storage.

| Option | Description | Usage |
|[hr=3][/hr]
[hr=3][/hr]|[hr=3][/hr]
[hr=3][/hr]|[hr=3][/hr]
[hr=3][/hr]|
| all | Clear both inventory and ender chest | /inventoryclean all <player> |
| echest | Clear only ender chest | /inventoryclean echest <player> |
| inventory | Clear only inventory | /inventoryclean inventory <player> |

Examples:
`bash
/inventoryclean all Notch
/inventoryclean echest Steve
/inventoryclean inventory Alex
`

[hr=3][/hr]
[hr=3][/hr]

Permissions

| Permission | Description |
|[hr=3][/hr]
[hr=3][/hr]|[hr=3][/hr]
[hr=3][/hr]|
| nahum.echesttools | Access to /echesttools commands |
| nahum.inventorytools | Access to /inventorytools commands |
| nahum.inventoryclean | Access to /inventoryclean commands |

[hr=3][/hr]
[hr=3][/hr]

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!

[hr=3][/hr]
[hr=3][/hr]

Requirements

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

[hr=3][/hr]
[hr=3][/hr]

⚠️ Important Notes

- Full Offline Support - This plugin access the server's internal files so it can have offline support
- 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

[hr=3][/hr]
[hr=3][/hr]

️ Building from Source

1. Clone the repository:
`bash
git clone https://github.com/NahumNaranjo/nahum-Inventory-stuff
`

2. Build with Maven:
`bash
cd nahum-Inventory-Stuff
mvn clean package
`

3. Find the JAR in the target/ folder

[hr=3][/hr]
[hr=3][/hr]

Configuration

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

[hr=3][/hr]
[hr=3][/hr]

Reporting Issues

If you encounter any issues, please report them with:
- Server version
- Plugin version
- Steps to reproduce the issue
- Error logs

[hr=3][/hr]
[hr=3][/hr]

License

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

[hr=3][/hr]
[hr=3][/hr]

Acknowledgements

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

[hr=3][/hr]
[hr=3][/hr]

Support

For support, questions, or feature requests, please contact:
- Author: Nahum Naranjo at [his email](mailto: [email protected])
- Issues: [GitHub Issues]( https://github.com/NahumNaranjo/nahum-Inventory-stuff/issues)

[hr=3][/hr]
[hr=3][/hr]

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

v1.1.0

- Offline support added to all tools
- Technical improvements to readability and maintenance

[hr=3][/hr]
[hr=3][/hr]

Example Usage Scenarios

Staff Moderation

`bash
[h1]Check if a player is hacking by viewing their inventory[/h1]
/inventorytools see suspected_hacker

[h1]Clear a player's inventory as punishment[/h1]
/inventoryclean all rule_breaker
`

️ Server Management

`bash
[h1]Transfer a builder's inventory to a new player[/h1]
/inventorytools transfer new_builder master_builder

[h1]Check a player's ender chest for contraband[/h1]
/echesttools see suspicious_player
`

Events & Giveaways

`bash
[h1]Clear all players before an event[/h1]
/inventoryclean all event_participant

[h1]Transfer a prize inventory to a winner[/h1]
/inventorytools transfer winner prize_account
`

[hr=3][/hr]
[hr=3][/hr]

⚡ Performance

This plugin is optimized for performance:
- ✅ No async operations
- ✅ Direct player lookups
- ✅ Minimal memory usage
- ✅ Fast command execution

[hr=3][/hr]
[hr=3][/hr]

Made with ❤️ by Nahum Naranjo