OpenInv/README.MD

4.7 KiB

About

OpenInv is a Bukkit plugin which allows users to open and edit anyone's inventory or ender chest - online or not!

Features

  • OpenInv: Open anyone's inventory, even if they're offline.
    • Read-only mode! No edits allowed! Don't grant the permission OpenInv.editinv
    • Cross-world support! Don't grant OpenInv.crossworld
    • No self-opening! Don't grant OpenInv.openself
    • Drop items as the player! Place items in the unused slots to the right of the armor to drop them
  • OpenEnder: Open anyone's inventory, even if they're offline.
    • Read-only mode! No edits allowed! Don't grant OpenInv.editender
    • Cross-world support! Don't grant OpenInv.crossworld
    • No self-opening! Don't grant OpenInv.openself
  • SilentChest: Open containers without displaying an animation or making sound.
  • AnyChest: Open containers, even if blocked by ocelots or blocks.

Commands

Command Aliases Description
/openinv [player] oi, inv, open Open a player's inventory. If unspecified, will select last player opened or own if none opened previously.
/openender [player] oe Open a player's ender chest. If unspecified, will select last player opened or own if none opened previously.
/searchinv <item> [minAmount] si Lists all online players that have a certain item in their inventory.
/searchender <item> [minAmount] se Lists all online players that have a certain item in their ender chest.
/anychest [check] ac Check or toggle the AnyChest function, allowing opening blocked containers.
/silentchest [check] sc Check or toggle the SilentChest function, allowing opening containers silently.

Permissions

Node Description
OpenInv.* Gives permission to use all of OpenInv.
OpenInv.openinv Required to use /openinv.
OpenInv.openself Required to open own inventory.
OpenInv.editinv Required to make changes to open inventories.
OpenInv.openender Required to use /openender.
OpenInv.editinv Required to make changes to open ender chests.
OpenInv.openenderall Allows users to open others' ender chests. Without it, users can only open their own.
OpenInv.exempt Prevents the player's inventory being opened by others.
OpenInv.override Allows bypassing of the exempt permission.
OpenInv.crossworld Allows cross-world usage of /openinv and /openender.
OpenInv.search Required to use /searchinv and /searchender.
OpenInv.anychest Required to use /anychest.
OpenInv.silent Required to use /silentchest.

For Developers

To compile, the relevant Craftbukkit/Spigot jars must be installed in your local repository using the install plugin.
Ex: mvn install:install-file -Dpackaging=jar -Dfile=spigot-1.11-R0.1-SNAPSHOT.jar -DgroupId=org.spigotmc -DartifactId=spigot -Dversion=1.11-R0.1-SNAPSHOT

Compiling OpenInv for a specific version is very easy - just compile the correct module.

Compiling for a set of versions is slightly more complex. You'll need to use a profile for the versions you want to compile. Provided profiles are latest, modern (versions 1.8+), and all. For more information, check out the official guide.

License

Copyright (C) 2011-2014 lishid.  All rights reserved.

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation,  version 3.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.