# InvSee++ A bukkit plugin for manipulating player inventories. This plugin will still work when target players are offline, even when they have never been on the server. ## Features - View and edit other players' inventories and enderchests. - Includes players' armour contents and off-hand items. - Includers players' crafting/workbench/anvil/smithing table/stonecutter/grindstone/loom/enchanting table/merchant items. - Includes the item stack that players hold on their cursor. - Auto-reloading of spectator inventories when players relog. - Customisable inventory layouts and titles. - Simple yet extensive application programming interface. Works on CraftBukkit (and forks) as well as Glowstone. - Support for hybrid servers (Forge/Bukkit, Fabric/Bukkit) is [available](https://github.com/Jannyboy11/InvSee-plus-plus#supported-server-software). - Does not work on Folia ([#58]([https://github.com/Jannyboy11/InvSee-plus-plus/issues/58](https://github.com/Jannyboy11/InvSee-plus-plus/issues/58))). - (Optional) integration with PerWorldInventory. - [Addon] Give items to (offline) players via commands. - [Addon] Clear items out of (offline) players' inventories via commands. ### Running the plugin Just drop the InvSee++.jar file in your server's /plugins folder. ### Commands - `/invsee | [PWI{...}]` - spectates a player's inventory. - `/endersee | [PWI{...}]` - spectates a player's ender chest. Note that for integration with PerWorldInventory, `load-data-on-join` needs to be set to `true` in its config. - `invseeplusplusreload` - reloads the plugin's configuration. ### Permissions ###### Base permissions: - `invseeplusplus.invsee.view` allows access to `/invsee`. By default only for server operators. - `invseeplusplus.invsee.edit` allows the player to manipulate the target player's inventory. By default only for server operators. - `invseeplusplus.endersee.view` allows access to `/endersee`. By default only for server operators. - `invseeplusplus.endersee.edit` allows the player to manipulate the target player's enderchest. By default only for server operators. - `invseeplusplus.exempt.invsee` makes it impossible to spectate the inventory of the owner of this permission. - `invseeplusplus.exempt.endersee` makes it impossible to spectate the enderchest of the owner of this permission. - `invseeplusplus.bypass-exempt.invsee` ignore whether target players are exempted from having their inventory spectated - `invseeplusplus.bypass-exempt.endersee` ignore whether target players are exempted from having their enderchest spectated - `invseeplusplus.reload` allows access to `/invseeplusplusreload`. ###### Aggregate permissions: - `invseeplusplus.view` provides `invseeplusplus.invsee.view` and `invseeplusplus.endersee.view`. - `invseeplusplus.edit` provides `invseeplusplus.invsee.edit` and `invseeplusplus.endersee.edit`. - `invseeplusplus.exempt` provides `invseeplusplus.exempt.invsee` and `invseeplusplus.exempt.endersee`. - `invseeplusplus.bypass-exempt` provides `invseeplusplus.bypass-exempt.invsee` and `invseeplusplus.bypass-exempt.endersee`. - `invseeplusplus.tabcomplete` allows username tabcompletion in /invsee or /endersee commands. This permission is automatically provided by invseeplusplus.invsee.view and invseeplusplus.endersee.view - `invseeplusplus.reload` allows access to /invseeplusplusreload. - `invseeplusplus.*` provides all of the base permissions as well as all of the addon permissions. ## Addons #### InvSee++_Give ##### Commands: - `/invgive [] []` - `/endergive [] []` ###### Examples: On 1.20.4 an earlier: - `/invgive Notch diamond 1 {"foo":"bar"}` - `/endergive Jannyboy11 wool:14` On 1.20.5 and later: - `/invgive Jannyboy11 minecraft:emerald[minecraft:max_stack_size=99] 65` ##### Permissions: - `invseeplusplus.give.*` provides `invseeplusplus.give.inventory` and `invseeplusplus.give.enderchest`. - `invseeplusplus.give.inventory` allows access to `/invgive`. - `invseeplusplus.give.enderchest` allows access to `/endergive`. #### InvSee++_Clear ##### Commands: - `/invclear ? ?` - `/enderclear ? ?` ###### Examples: - `/invclear Notch diamond 1` - `/enderclear Jannyboy11 wool:14` ##### Permissions: - `invseeplusplus.clear.*` provides `invseeplusplus.clear.inventory` and `invseeplusplus.clear.enderchest`. - `invseeplusplus.clear.inventory` allows access to `/invclear`. - `invseeplusplus.clear.enderchest` allows access to `/enderclear`. ### Metrics This plugin collects anonymous metrics which are submitted to [bStats](https://bstats.org/plugin/bukkit/InvseePlusPlus/9309) and [FastStats](https://faststats.dev/project/invsee-plus-plus/invsee%2B%2B). They help me to see how the plugin is used and thus with future development. Collection of metrics can be disabled in the /plugins/bstats/config.yml and plugins/faststats/config.properties files. [![Servers & Players](https://faststats.dev/embed/2cfe5112-d8dc-4b71-8759-c0b0601d0076?w=800&h=300&theme=dark)](https://faststats.dev/project/invsee-plus-plus/invsee++) ### Contact Bugs & Feature requests: [GitHub issues](https://github.com/Jannyboy11/InvSee-plus-plus/issues) Anything else can be discussed via the [discussion thread on SpigotMC](https://www.spigotmc.org/threads/invsee.456148/) or via [Discord](https://discord.gg/Z8WCDHHcdJ). ### Developers API Documentation available on the [wiki](https://github.com/Jannyboy11/InvSee-plus-plus/wiki)! ### Credits Special thanks to Icodak for making the plugin's logo! You can find them on [Discord](https://discordapp.com/users/345308025331908619) and on [SpigotMC](https://www.spigotmc.org/members/icodak.473813/).