[ABANDONED] CuffEm icon

[ABANDONED] CuffEm -----

Cuff a prisoner




This release avoids removing armor with the Curse of Binding enchantment (by default).

Users can opt for still removing such armor by changing the following config option:
Code (YAML):
remove-binded-armor : false # change to true if you wish to remove / drop armor with Curse of Binding

Thanks to @Gropinou for pointing out this oversight.
----------, Nov 7, 2023

Updating default config to work with older versions of MC out of the box.
----------, Feb 15, 2023

Due to the default cuffs in the default config having been populated a while ago (before 1.13), the server identified them as a legacy item.

And because of that, legacy material support was implemented on the server side. However, this was completely unnecessary.

Thanks to @Sohqil for the report!
----------, Feb 2, 2023


This change (when enabled, it is disabled by default) will allow players to craft and/or rename their items such that they are identified as cuffs by the plugin.

The new config entry:
Code (YAML):
allow-cuffs-without-tag : false # if set to true, players can simply craft and/or rename their items to match the cuffs
----------, Jun 10, 2022

Now showing an empty line (instead of the default English message) when a message is removed from the config.
----------, May 3, 2022

No longer allowing player A that is cuffed by player B to cuff player B as well.
This would previously introduce issues.

Thanks to @ElgerElg for bringing this to my attention.
----------, Feb 23, 2022

Thanks to @The_osher for the suggestion.

The feature can be enabled by setting the (new) config entry:
Code (YAML):
drop-item-target : STORE # GROUND or DESPAWN or STORE - default is GROUND
There are 3 modes:
  • GROUND
    • The items are dropped (like before)
  • DESPAWN
    • The items are despawned
  • STORE
    • The items in the inventory are stored on file
    • When the player is uncuffed, the items are given back to the player
When saving the inventory, slots corresponding to items is also stored.
For any of this to work, you'll obviously need drop-items-upon-cuff: true.

Alongside that, added a new command:
/cuffemclearstoredinv <player> - allows clearing the stored inventory of a player (i.e one can do so when they leave by using the cuffed-player-leave-commands commands).

There are also a number of new messages that go along this new feature.
Code (YAML):
[  items-dropped-on-uncuff-dragee : "&cNot all items fit in your inventory so &8{nr}&c of them were dropped"
  items-not-dropping-upon-cuff
: "&cItems are not set to drop upon cuffing"
  dropper-strategy-no-store
: "&cThe current dropper strategy does not allow storing of inventories"
  dropper-no-stored-inventory
: "&cThere does not seem to be an inventory for player &8{player}"
  dropper-cleared-stored-inventory
: "&cCleared the stored inventory of &8{player}"
 
----------, Feb 5, 2022

Showing a message when target is immune as well as when cuffing player does not have permission.

New message in config.yml:
Code (YAML):
 not-allowed-to-cuff : "&cYou do not have permission to use cuffs right now"
----------, Jan 17, 2022

Thanks to @Willyema to bringing the issue to my attention.
----------, Jan 15, 2022

Fixed config handling and reload issue.

Previously the config was overwritten way too often making it difficult to reload the actual contents of it.
----------, Sep 26, 2021

Added possibility of specifying console commands to be executed upon right clicking on a player in order to cuff them.
These commands can be specified here in the config as follows:
Code (YAML):
right-click-cuff-side-effect-commands : [ ]
Each command can parse {player} or {dragee} to the name of the player being dragged and {dragger} to the name of the playe doing the dragging.
You can specify as many commands as you wish.
----------, Aug 2, 2021

Now able to ignore Citizens NPCs when cuffing a player.
This behaviour can be changed with the config entry ( allow-cuff-NPCs: false).
----------, Jul 20, 2021

Now able to cuff a player without cuffs using the /cuff <target> command. Permission required: cuffem.cuffcommand (it's different from the cuff permission used with cuffs).
You can (optionally) limit this to within the same world or even within a certain radius.
New config section:
Code (YAML):
cuff-command-limitations:
  only-within-same-world
: false # if true, only allow /cuff command within same world
  within-radius
: -1 # negative mean no radius gap
New messages in config:
Code (YAML):
messages :
  # [--] old messages
  player-immune
: "&6Player &8{player}&6 is immune to cuffing"
  already-cuffing
: "&cYou have already cuffed &8{player}"
  cannot-cuff-self
: "&cYou cannot cuff yourself"
  target-in-wrong-world
: "&cYou cannot cuff somebody in a different world"
  target-too-far
: "&cThe target player is too far away"
Thanks to @_ItsLinus_ for the suggestion!
----------, Jul 20, 2021

Added command:
/setcuffitem - needs permissions cuffem.setcuffitem (default: OP) - sets the item in your main hand as the cuffs.

This also introduces a new config entry:
Code (YAML):
cuff-item:
  ==
: org.bukkit.inventory.ItemStack
  type
: BLAZE_ROD
  meta
:
    ==
: ItemMeta
    meta-type
: UNSPECIFIC
    display-name
: ' { "extra": [ { "bold":false, "italic":false, "underlined":false, "strikethrough":false, "obfuscated":false, "color": "light_purple", "text": "Them
"
}, { "bold":true, "italic":false, "color": "green", "text": "Cuffs!" } ], "text": "" }'
PS: The old config entries for cuff-type and cuff-name are still used if (and only if) nothing is specified for cuff-item.
----------, Mar 24, 2021

Added Bstats:
https://bstats.org/plugin/bukkit/CuffEm/10785

Added /cuffemreload command to reload the config (messages, as well as all other settings).

Fixed issue where the default item (in the new cuff-item section) would always overwrite the previously specified item type and name (issue introduced in 1.4.0).

Includes a new config entry whether or not to add bStats.
Incldues new message for reloading.
----------, Mar 24, 2021

New config entry:
Code (YAML):
stop-pvp-when-cuffed : false
New message:
Code (YAML):
messages :
  # other messages
  cuffed-cannot-pvp
: "&6You are currendly cuffed an thus cannot PvP right now"
  # other messages
Thanks to @MOLONxd for the wonderful suggestion.
----------, Feb 28, 2021

The uncuff sign system does not work on Minecraft versions before 1.14.1.
As such, I've now disabled it if a lower version of Minecraft is detected.
----------, Jan 31, 2021

Added uncuff signs.

These are signs which will uncuff all the players you have cuffed at the time.
Additionally (optional), commands ( uncuff-sign-commands in config) may be run by the cuffing player when the sign is clicked. These commands have the {cuffed} placeholder for the cuffed player.
If multiple players were cuffed, then the commands will be executed for each cuffed player.

One can set an uncuff sign using the /setuncuffsign command ( cuffem.setuncuffsign permission node, defaults to OP).
The data for this sign is saved within the sign. So removing/breaking the sign will remove this data.


Improvements to commands

Some internal changes and slight improvements to tab-completion.

You are now unable to uncuff players that were cuffed by somebody else (previously possible) unless you have the cuffem.uncuff.other permission node (defaults to OP).
----------, Jan 31, 2021

Now supports the Vehicles plugin.

Works similarly to the QAV support.
EDIT:
Since there's only ever (up to) 1 extra seat in vehicles within this plugin, only one dragged player can be put in the vehicle.

PS:
If anyone finds an issue, don't hesitate to let me know.
----------, Jan 30, 2021

Players with the following permission will not be able to be cuffed:
cuffem.immune
----------, Dec 13, 2020

New config entry:
Code (YAML):
stop-interact-when-cuffed : false
Defaults to false (previous behaviour).

New message:
Code (YAML):
cuffed-cannot-interact : "&6You are cuffed and thus cannot use your inventory right now"
Shoutout to @Cedric2205 for the suggestion.
----------, Sep 8, 2020

New config entry:
Code (Java):
stop -interact -when -cuffed : false
Defaults to false (previous behaviour).

Shoutout to @Cedric2205 for the suggestion.
----------, Sep 8, 2020

Added /uncuff command. You'll need the cuffem.uncuff perms (defaults to OP).
----------, May 21, 2020

  • Added support for 1.15.
  • Slight optimization
    • Avoiding the costly square rooting
  • Added config option to disable the bossbar
    • use-bossbar-when-cuffed (default: true)
----------, Apr 23, 2020

Added 1.14.3 support
----------, Jul 4, 2019

A fix for updated QualityArmoryVehicles
No other changes were made.

Thanks to @Francisc for help with testing.
----------, Jan 11, 2019

Not all messages were listed in the config and one was misnamed.
----------, Dec 15, 2018

Added a permission node that is needed for commands to be dispatched when "prisoner" leaves.
Permission node: cuffem.dccommand

Suggested by @LexionGVC
----------, Nov 30, 2018

Special thanks to @LexionGVC for the feature suggestion!

There is a new config entry that defaults as follows:
Code (Text):
cuffed-player-leave-commands:
- "bc &8{player}&6 left while being cuffed by {from}"
If you want to disable the feature, just use
Code (Text):
cuffed-player-leave-commands: [ ]
----------, Nov 12, 2018

Resource Information
Author:
----------
Total Downloads: 17,254
First Release: Oct 21, 2018
Last Update: Nov 7, 2023
Category: ---------------
All-Time Rating:
25 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings