Skip to content

Audits player inventories for illegal items.

License

Notifications You must be signed in to change notification settings

alx-mp4/InvAudit

Repository files navigation

🎒 InvAudit

Audits player inventories for illegal items. Automatically removes any illegal items and prevents players from opening containers while possessing them. Players are also unable to pick up illegal items from the ground or drop them.


🤝 Contributions, Suggestions, and Issues

Consider helping InvAudit become even more versatile and robust.

It is highly recommended to visit the CONTRIBUTING guide for details on how to get started and where to focus your efforts.

For any issues with the plugin, or suggestions, please submit them here.


⬇️ Download

Latest releases of InvAudit can be found here on GitHub.

The plugin is fully open-source and transparent.
If you'd like additional peace of mind, you're welcome to scan the .jar file using VirusTotal.


📋 Requirements

Your server must be running one of the following software: CB1060, Project Poseidon or UberBukkit.


🚀 Usage

By default, only OPs have permission.

Use PermissionsEx or similar plugins to grant groups the permission, enabling the commands.

Commands:

Command Permission Description
/ia None View InvAudit commands.
/ia about None About InvAudit.
/ia reload invaudit.config Reload InvAudit configuration.
/ia toggle invaudit.config Toggle InvAudit plugin.
/ia timer <ticks> invaudit.config Alter clear timer for illegal items.
/ia audit <ID|ID:Data> invaudit.config Add/remove illegal items.

Permissions:

Permission Description
invaudit.* Wildcard permission that grants all permissions.
invaudit.bypass Allows player to bypass the InvAudit protection.
invaudit.config Allows player to reload and modify the InvAudit configuration.

⚙️ Configuration

InvAudit generates a configuration file with the default settings.

Config config.yml:

enabled: true           # Toggles the automatic clear task of InvAudit on/off
clear-timer-ticks: 100  # Ticks between each automatic clear task (20 ticks is 1 second)
audit-items: []         # List of IDs of items that are considered illegal

📊 Project Statistics

Statistics