Perks
Home | Commands | Permissions Configuration | Perks | Back to Bukkit
The bread and butter of the Social Network. Perks allow us to give little bonuses to each player based on the social groups they belong to. Below is a list of each Perk that is available and the settings that are required for it.
For more details on Perk configurations, see Perk Settings.
- Teleport Teleport to/from other players. Also to a chosen "home".
- Tell Send private messages to players.
- Sticky Send sticky notes to other players and allow them to read them later.
- Gift Send gifts of either cash or items to other players.
- Player Damage Stop players from being able to damage each other.
- Bonus Experience Gain bonus xp killing creatures with others.
- Health Regen Regain health faster or slower when near others.
- Food Share Food eaten is shared with others when near them.
- World Guard Allows players access to each others' World Guard regions as members.
- LWC Allows players access to each others' LWC protected blocks/items.
This Perk allows you to choose to teleport to a friend or have them teleported to you. You can also set a "home" and be able to teleport yourself to that at any time.
| Command | Description |
|---|---|
| /social sethome | Sets your "home" location for /social teleport. |
| /social teleport | Teleport yourself to your "home". |
| /social ty <player> | Teleports the caller to the given player. |
| /social tm <player> | Teleports the given player to the caller. |
| social.teleport | Allows the usage of all the teleport commands. |
{
"type": "com.netprogs.minecraft.plugins.social.config.settings.perk.TeleportSettings",
"data": {
"name": "teleport",
"coolDownPeriod": 0,
"perUseCost": 0.0
}
}
| type | The classpath to the Perk class that we want to load. Generally you won't need to edit this beyond what's given from the default above. |
| name | The name of the perk used in the social group perks list. This value and the one used in the group settings must match. This can be changed to anything you want, just make note of it so you can use it during group configuration. |
| coolDownPeriod | The period of time (in seconds) that must pass before a player can teleport again. |
| perUseCost | The price to charge a player each time they teleport. |
This Perk allows you to send private messages to anyone in their related social group. The receiver must be online or the tell will not be sent.
| Command | Description |
|---|---|
| /social tell <player> <message> | Sends the player a private message. |
| social.tell | Allows the usage of all the tell command. |
{
"type": "com.netprogs.minecraft.plugins.social.config.settings.perk.TellSettings",
"data": {
"name": "tell",
"coolDownPeriod": 0,
"perUseCost": 0.0
}
}
| type | The classpath to the Perk class that we want to load. Generally you won't need to edit this beyond what's given from the default above. |
| name | The name of the perk used in the social group perks list. This value and the one used in the group settings must match. This can be changed to anything you want, just make note of it so you can use it during group configuration. |
| coolDownPeriod | The period of time (in seconds) that must pass before a player can send another tell. |
| perUseCost | The price to charge a player each time they send a tell. |
This Perk allows you to send a sticky note to anyone in their related social group. The receiver does not need to be online. The message is stored until the player requests to read it.
| Command | Description |
|---|---|
| /social sticky <player> <message> | Sends a "sticky note" to another player. These are stored and can be read later. |
| /social sticky list | Lists all available stickies, number by player. |
| /social sticky read | Reads all the stickies from the player. |
| /social sticky delete | Deletes the stickies from the player. |
| social.sticky | Allows the usage of all the sticky commands. |
{
"type": "com.netprogs.minecraft.plugins.social.config.settings.perk.StickySettings",
"data": {
"name": "sticky",
"coolDownPeriod": 0,
"perUseCost": 0.0,
"maximumNumber": 10
}
}
| type | The classpath to the Perk class that we want to load. Generally you won't need to edit this beyond what's given from the default above. |
| name | The name of the perk used in the social group perks list. This value and the one used in the group settings must match. This can be changed to anything you want, just make note of it so you can use it during group configuration. |
| maximumNumber | The maximum number of stickies a single player can send another before they are opened. |
| coolDownPeriod | The period of time (in seconds) that must pass before a player can send another sticky. |
| perUseCost | The price to charge a player each time they send a sticky. |
This Perk allows you to send gifts to another player that is in your related social group. You can choose to send cash or an item (or stack) you're holding in your hand.
| Command | Description |
|---|---|
| /social gift cash <amount> <player> | Sends the player the cash amount. |
| /social gift hand <player> | Give the player the item in your hand. |
| /social gift yes | Accept the gift being sent. |
| /social gift no | Don't accept the gift being sent. |
| /social gift list | List all the gifts available to you. Number, by player. |
| /social gift open <player> | Open all the gifts from the player. Will delete after opening. |
| social.gift | Allows the usage of all the gift commands. |
{
"type": "com.netprogs.minecraft.plugins.social.config.settings.perk.GiftSettings",
"data": {
"name": "gift",
"coolDownPeriod": 0,
"perUseCost": 0.0,
"maximumNumber": 10
}
}
| type | The classpath to the Perk class that we want to load. Generally you won't need to edit this beyond what's given from the default above. |
| name | The name of the perk used in the social group perks list. This value and the one used in the group settings must match. This can be changed to anything you want, just make note of it so you can use it during group configuration. |
| maximumNumber | The maximum number of gifts a single player can send another before they are opened. |
| coolDownPeriod | The period of time (in seconds) that must pass before a player can send another gift. |
| perUseCost | The price to charge a player each time they send a gift (over and above the gift itself). |
This Perk blocks players from taking damage from each other while in related social groups. This Perk is a listener perk (Events) and does not have any commands or permissions related to it.
When a player drops out of their related social group, the coolDownPeriod is applied continuing their protection for that amount of time. Once that is over, they are then able to be damaged by the other player.
{
"type": "com.netprogs.minecraft.plugins.social.config.settings.perk.PlayerDamageSettings",
"data": {
"damageAllowedFromPlayer": false,
"damageAllowedFromProjectile": false,
"damageAllowedFromTameable": false,
"name": "damage",
"coolDownPeriod": 60
}
}
| type | The classpath to the Perk class that we want to load. Generally you won't need to edit this beyond what's given from the default above. |
| name | The name of the perk used in the social group perks list. This value and the one used in the group settings must match. This can be changed to anything you want, just make note of it so you can use it during group configuration. |
| coolDownPeriod | The period of time (in seconds) that must pass before a player can damage the other once they're no longer related through social groups. |
| damageAllowedFromPlayer | If you still want players to be able to damage each other through direct means (hand to hand), then set this to true. |
| damageAllowedFromProjectile | If you still want players to be able to damage each other through ranged damage, then set this to true. |
| damageAllowedFromTameable | If you still want players to be able to damage each other through tameable creature damage, then set this to true. |
This Perk allows players to gain bonus experience when they kill monsters together.
This Perk is a listener perk (Events) and does not have any commands or permissions related to it.
{
"type": "com.netprogs.minecraft.plugins.social.config.settings.perk.BonusExperienceSettings",
"data": {
"name": "bonusxp",
"proximity": 20,
"flatBonus": 20,
"percentBonus": 50
}
}
| type | The classpath to the Perk class that we want to load. Generally you won't need to edit this beyond what's given from the default above. |
| name | The name of the perk used in the social group perks list. This value and the one used in the group settings must match. This can be changed to anything you want, just make note of it so you can use it during group configuration. |
| proximity | The distance, in blocks, that the players must be near each other in order to gain this bonus. |
| flatBonus | The direct bonus experience to add to the amount normally gained from the kill. |
| percentBonus | The percentage bonus to add to the amount normally gained from the kill. This is applied before the flat bonus above. |
This Perk allows players to gain health back at a faster or slower rate when close to others of their groups.
This Perk is a listener perk (Events) and does not have any commands or permissions related to it.
{
"type": "HealthRegenSettings",
"data": {
"name": "fastHealthRegen",
"proximity": 20,
"heartsPerkTick": 1
}
}
| type | The classpath to the Perk class that we want to load. Generally you won't need to edit this beyond what's given from the default above. |
| name | The name of the perk used in the social group perks list. This value and the one used in the group settings must match. This can be changed to anything you want, just make note of it so you can use it during group configuration. |
| proximity | The distance, in blocks, that the players must be near each other in order to gain this bonus. |
| heartsPerkTick | This is the number of hearts to gain per server "tick". Each number represents a half heart increment. This can be a negative number also to create a "no regen" or "negative regen" effect for wanted cases. If a negative is given, we do not allow it to reduce them below 1 heart to avoid death. |
This Perk allows players to share eaten food with others that are near them at the time the food is eaten.
This Perk is a listener perk (Events) and does not have any commands or permissions related to it.
{
"type": "FoodShareSettings",
"data": {
"name": "foodShare",
"proximity": 20
}
}
| type | The classpath to the Perk class that we want to load. Generally you won't need to edit this beyond what's given from the default above. |
| name | The name of the perk used in the social group perks list. This value and the one used in the group settings must match. This can be changed to anything you want, just make note of it so you can use it during group configuration. |
| proximity | The distance, in blocks, that the players must be near each other in order to gain this bonus. |
This Perk allows players access to each others' regions by adding them as members to their owned regions. When they are no longer in any social groups together that use this Perk, they're removed as members.
This Perk is a listener perk (Events) and does not have any commands or permissions related to it.
{
"type": "com.netprogs.minecraft.plugins.social.config.settings.perk.WorldGuardSettings",
"data": {
"name": "worldguard",
}
}
| type | The classpath to the Perk class that we want to load. Generally you won't need to edit this beyond what's given from the default above. |
| name | The name of the perk used in the social group perks list. This value and the one used in the group settings must match. This can be changed to anything you want, just make note of it so you can use it during group configuration. |
This Perk allows players access to each others' LWC protected area's by giving them permissions to use them. When they are no longer in any social groups together that use this Perk, their permissions are revoked.
This Perk is a listener perk (Events) and does not have any commands or permissions related to it.
{
"type": "com.netprogs.minecraft.plugins.social.config.settings.perk.LWCSettings",
"data": {
"name": "lwc",
}
}
| type | The classpath to the Perk class that we want to load. Generally you won't need to edit this beyond what's given from the default above. |
| name | The name of the perk used in the social group perks list. This value and the one used in the group settings must match. This can be changed to anything you want, just make note of it so you can use it during group configuration. |