OpenInv Plugin

Overview

OpenInv is a comprehensive Minecraft server plugin that allows administrators to view, modify, and manage player inventories. Version 0.3 introduces enhanced functionality including ender chest management, improved inventory handling, and robust configuration options.

Core Features

Inventory Management

• View Player Inventories: Admins can open and view any player's inventory with /openinv check <player>
• Real-time Editing: Changes made to the inventory GUI are synchronized in real-time with the target player
• Inventory History: The plugin maintains a history of inventory states, allowing for rollbacks
• Armor & Offhand Support: Full support for viewing and modifying armor slots and offhand items

Ender Chest Management

• View & Edit Ender Chests: Admins can access any player's ender chest with /openinv echeck <player>
• Synchronized Updates: Changes to ender chest contents are immediately applied to the target player
• Permission Control: Separate permission node (openinv.enderchest) for ender chest access

Inventory Control

• Freeze Functionality: Prevent players from modifying their inventory with /openinv freeze <player>
• Unfreeze Command: Re-enable inventory modifications with /openinv unfreeze <player>
• Drop/Pickup Prevention: Frozen players cannot drop or pick up items
• Anti-Spam Protection: Cooldown system for messages when players attempt prohibited actions

Search Capabilities

• Item Search: Find specific items in a player's inventory with /openinv search <item> <player>
• Tab Completion: Intelligent tab completion for item names and player names
• Error Handling: Robust error handling for invalid searches

User Interface

• Custom GUI: Well-designed inventory interface with separate sections for main inventory, armor, and offhand
• Decorative Elements: Black stained glass panes as filler items for better visual organization
• Action Buttons: Clear inventory and close buttons for quick actions
• Configurable Layout: GUI layout can be customized through configuration files

Admin Tools

• Rollback System: Revert inventory changes with /openinv rollback <player>
• Welcome Message: Informative welcome message for OP players showing available commands
• Help Command: Comprehensive help system with /openinv help
• Tab Completion: Intelligent command completion for all plugin commands

Technical Features

Configuration System

• config.yml: Customizable messages, GUI layouts, and plugin settings
• data.yml: Storage for player-specific data and action logs

Logging System

• Comprehensive Logging: Records all admin actions with timestamps
• Multiple Destinations: Configurable logging to console and/or file
• Custom Format: Customizable log format through configuration

Performance Optimizations

• Cooldown Mechanisms: Prevents excessive updates and message spam
• Synchronized Operations: Thread-safe inventory modifications
• Resource Cleanup: Proper cleanup when players disconnect
• Error Handling: Robust exception handling throughout the plugin

Security Features

• Permission System: Fine-grained permission control for all commands
• Armor Validation: Prevents invalid items in armor slots
• Atomic Updates: Ensures inventory integrity during modifications

Permissions

• openinv.command: Base permission for using the plugin
• openinv.enderchest: Permission to access player ender chests

Commands

• /openinv check <player>: View and edit a player's inventory
• /openinv echeck <player>: View and edit a player's ender chest
• /openinv search <item> <player>: Search for items in a player's inventory
• /openinv freeze <player>: Prevent a player from modifying their inventory
• /openinv unfreeze <player>: Allow a player to modify their inventory again
• /openinv rollback <player>: Roll back a player's inventory to the previous state
• /openinv help: Display help information about available commands

This plugin is ideal for server administrators who need powerful tools to manage player inventories, investigate item-related issues, and maintain server integrity.