Are you tired of ugly sign above your doors ? But you still need to lock them right ? With PassLock, you won't need Lockette or LWC anymore !
It enables you to lock your door and your chest by a item based code. You can set and enter your code thanks to a smooth interface and
give it to your friends !
Whereas other protection plugins, Passlock uses an inventory as an interface to enter your password. Chat-commands haters you are welcomed !
Installation : Simply put the .jar file into your plugins directory and install Vault I recommend to always do a backup of config/data/locks files before updating !
Tutorial :
1. Grab a wooden door, a trapdoor or a chest or whatever you want.
2. Type /lock as a chat command.
3. Right click your door / chest. 4. Set the password by clicking the blocks. 5. Confirm 6. Have fun, you're now safe !
To remove the lock, all you have to do is to type "/unlock" and right click your door.
How to modify messages : 1. You can find different locales in the plugins/PassLock/locales directory 2. You can edit the text of the locale file and change the locale in the config.yml
Configuration : - locale : The name of the locale file
- ownerNeedCode : Determines if the owner of the locked block needs to enter the code to open it - itemMaxAmount : Determines the maximum amount of a type of item for the code (max 64) - lockingLimitEnabled : Toggle the locking limit on/off. - defaultDoorClosingTimeSeconds : The number of seconds after which the opened doors closes (0 for no automatic closing). - ownerAlterted : If on, the owner of a lock will be texted every-time someone fail to open the lock. - useEconomy : Enable the economy system - unlockingPaysBack : If true, the player gets its money back when unlocking If you are experimenting NullPointerExceptions, try to delete your config file and let the plugin create a new one or use /reset
How to set the price : Add to the player/group the permission : passlock.lockprice.*formula* The formula can be a constant or use "n" to make it depends on the number of locks. I'm using EvalEx (https://github.com/uklimaschewski/EvalEx) to evaluate the expression. Example :
passlock.lockprice.10*n : The first one will cost 10, then 20, then 30, ...
passlock.lockprice.42+e^n : It's possible but don't ask me why you would need something like that ^^
Look at the EvalEx github page to see all possible operations.
How to add and remove blocks : 1. Use /setlockable to add a block. 2. Use /unsetlockable to remove a block. 3. Have fun
How to limit the number of locks : Just add passlock.lockinglimit.*thenumberyouwant* to the player/group to limit the number of their locks. You can also toggle this feature in the config.
By default you can lock : All types of doors, fence gates, chests and trapped chests, furnaces and trapdoors.
These are the default lockable block but you can set any block as lockable !
How to change locking window : 1. Use /changeLockingInventory 2. A window popup, put the items in 3. Close the inventory and it's done !
If you want to cancel, just leave a blank and close the inventory.
Videos : Big thank you to LtJim007 who did a video on the plugin (old version) !
Permissions :
passlock.open : To open locked blocks
passlock.lock : To lock blocks
passlock.unlock : To unlock locked blocks (they own)
passlock.setLockable : To allow people to add blocks to the lockable list
passlock.unsetLockable : To allow people to remove blocks from the lockable list
passlock.changeLockingInventory : To allow people to modify locking window
passlock.unlockEveryLocks : To allow people to unlock any locked block
passlock.lockinglimit.*number* : To restraint people's locks number
passlock.resetConfig : To allow people to reset the config file (only admin must have access to this one)
passlock.reload : To allow people to reload the plugin (only admin must have access to this one)
passlock.lockprice.*expression* : Set the price of a player's lock (see How to set the price)
passlock.watch : Allow a player to watch inside locked chests without being able to move items
Known Issues This plugin can stomp LWC locks, sadly I have no way to fix that because I can't verify if a chest is locked with LWC.
If you encounter bugs after updating, try to remove config file or simply use the /reset command /!\ Original config will be lost ! Make sure to save it somewhere else !
If you have any trouble, you can create a ticket on the github :
https://github.com/StealthyKamereon/passlock Also if you see a bug / crash or whatever, please contact me I'll reply as soon as possible.
Thank you for using PassLock I hope you have as much fun with it as I do when coding and if you have any suggestion / idea post a comment