Skip to content

Latest commit

 

History

History
135 lines (104 loc) · 8.22 KB

README.md

File metadata and controls

135 lines (104 loc) · 8.22 KB
Raw

InvSee++

A bukkit plugin for manipulating player inventories.

Logo

This plugin will still work when target players are offline, even when they have never been on the server.

Do you like this plugin? Then please leave a rating and a review on SpigotMC!

Running the plugin

Just drop the InvSee++.jar file in your server's /plugins folder.

See also: What Server Software does InvSee++ support?

Commands

  • /invsee <userName>|<uniqueId> [PWI{...}]
  • /endersee <userName>|<uniequeId> [PWI{...}] Note that for integration with PerWorldInventory, load-data-on-join needs to be set to true in its config.

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
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.* provides all eight of the base permissions as well as all of the addon permissions.

Addons

InvSee++_Give

Commands:
  • /invgive <target player> <item type> [<amount>] [<nbt tag>]
  • /endergive <target player> <item type> [<amount>] [<nbt tag>]
Examples:

On 1.20.4 and 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 <player> <item type>? <amount>?
  • /enderclear <player> <item type>? <amount>?
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.

Contact

Bugs & Feature requests: GitHub issues Anything else can be discussed via the discussion thread on SpigotMC or via Discord.

Compiling

Prerequisites: JDK-21 or newer, BuildTools and Maven.
  1. Install CraftBukkit into your local repository first by running BuildTools with
    • java -jar BuildTools.jar --rev 1.8.8 --compile craftbukkit
    • java -jar BuildTools.jar --rev 1.12.2 --compile craftbukkit
    • java -jar BuildTools.jar --rev 1.16.5 --compile craftbukkit
    • java -jar BuildTools.jar --rev 1.17.1 --compile craftbukkit --remapped
    • java -jar BuildTools.jar --rev 1.18.2 --compile craftbukkit --remapped
    • java -jar BuildTools.jar --rev 1.19.4 --compile craftbukkit --remapped
    • java -jar BuildTools.jar --rev 1.20.1 --compile craftbukkit --remapped
    • java -jar BuildTools.jar --rev 1.20.4 --compile craftbukkit --remapped
    • java -jar BuildTools.jar --rev 1.20.6 --compile craftbukkit --remapped
    • java -jar BuildTools.jar --rev 1.21 --compile craftbukkit --remapped
    • java -jar BuildTools.jar --rev 1.21.1 --compile craftbukkit --remapped
    • java -jar BuildTools.jar --rev 1.21.3 --compile craftbukkit --remapped
  2. In the root directory of this project run mvn clean package. You can find the plugin jar at InvSee++_plugin/target/InvSee++.jar.

Developers API

Documentation available on the wiki!

License

LGPLv2.1. See the LICENSE.txt file.

Credits

Special thanks to Icodak (Discord) (SpigotMC) for creating the logo!

Supported server software

InvSee++ supports servers implementing the Bukkit api which is currently maintained by SpigotMC. There are two types of support, Tier 1 support and Tier 2 support.

  • Tier 1 support: I regularly test new versions of InvSee++ on this server software to make sure that it runs smooth.
  • Tier 2 support: I don't test InvSee++ regularly on this server software, but will make an effort to fix bugs encountered when running on this server software when an issue is reported.

In general I support the latest patch release of popularly used Minecraft version, as well as multiple recent versions of the latest major release.

Server support matrix:

Server Software 1.8.8 1.12.2 1.16.5 1.17.1 1.18.2 1.19.4 1.20.1 1.20.4 1.20.6 1.21.1 1.21.3
CraftBukkit Tier 2 Tier 2 Tier 2 Tier 2 Tier 2 Tier 2 Tier 2 Tier 2 Tier 2 Tier 2 Tier 1
Paper Tier 2 Tier 2 Tier 2 Tier 2 Tier 2 Tier 2 Tier 2 Tier 2 Tier 2 Tier 2 Tier 2
Folia n/a n/a n/a n/a n/a planned - - planned - planned
Other forks of CraftBukkit Tier 2 Tier 2 Tier 2 Tier 2 Tier 2 Tier 2 Tier 2 Tier 2 Tier 2 Tier 2 Tier 2
(Neo)Forge/Bukkit hybrids Tier 2 Tier 2 Tier 2* Tier 2 Tier 2 Tier 2 Tier 2 Tier 2 Tier 2 Tier 2 Tier 2
Fabric/Bukkit hybrids Tier 2 Tier 2 Tier 2* Tier 2 Tier 2 Tier 2 Tier 2 Tier 2 Tier 2 Tier 2 Tier 2
Glowstone Tier 2 Tier 2 n/a n/a n/a n/a n/a n/a n/a n/a n/a

*The modding frameworks that these servers are based on were released at a time when Minecraft's minimum supported version was Java 8 (or lower), and there is a good chance they won't be able to load mods and plugins compiled for newer Java versions.

Is there any server that implements the Bukkit api that I'm missing? Don't hesitate to create an issue and request support!

Supported Java versions

Minecraft version: 1.8.x 1.12.x 1.16.x 1.17.x 1.18.x 1.19.x 1.20.[0-4] 1.20.[5-6] 1.21.x
Java version: 8 or newer 8 or newer 11 or newer 16 or newer 17 or newer 17 or newer 17 or newer 21 or newer 21 or newer