The Social Network is a plug-in that attempts to add a social environment to your server by allowing players to be placed into different types of social groups.
Uses Metrics for sending completely anonymous data to http://mcstats.org for usage tracking.
CraftBukkit 1.4.7-R1.0
The current version of Social Network appears to be working correctly on CB 1.4.7-R1.0. If you run into specific problems, please report it to me.
What are the social groups ?
There are multiple types of "social groups" you can belong to:
- Friends
- Relationships
- Affairs
- Children
- Engagements
- Marriages
- Divorces
Along with those, we also have:
- Divorce Lawyers
- Priests
- Admin commands
Optionally you can choose to use these to be the only way people can get married or divorced. By default players will be able to marry and divorce each other using their own commands.
What do we get for being in a social group ?
Social Perks
Each social group is also given what we call "Perks". Each of these Perks can be assigned in any particular manner to each group as you see fit.
Currently the following Perks are available:
- Sending private messages to each other while online
- Sending a "sticky" to a player via message system.
- Teleporting to/from each other. Also, choosing a "home" teleport.
- Sending cash or item gifts to each other via message system.
- Stopping players from being damaged by others in their group.
3rd Party Integration Perks:
- World Guard integration. Allows access to regions for members of social groups.
- LWC integration. Allows access to protected items for members of social groups.
NEW
- Earn extra xp when killing monsters with others.
- Regain: Regain health at a higher (or lower!) rate when near others in your groups.
- Share food gains when someone in your groups eats while near you.
To learn more about the Perks themselves, visit our Wiki Perk Library.
Permission Groups
Each social group can be assigned a permissions group allowing you to add/remove other plug-in features when they change into various social groups. These are additive-only and will not replace or remove existing groups for a person.
These are not the permissions of this plug-in, instead, these allow you to match permissions from other plug-ins to social groups.
For more details, visit our Configuration page.
Any other features ?
Yep, there are still more !
The following optional features are also available:
- Costs related to joining a group.
- Costs for using Perks.
- Cooldowns when using Perks.
- Control how many people are in a persons group.
- Global announcement when a marriage happens.
- Localization. Although I currently only have English, you can edit our resources file to use whatever languages you wish.
- Player can set a "status message" that will show up in their profile and gets announced to all the people in your groups.
- Players are notified when people in their groups log in and out.
- Find out when someone in your groups last logged in.
- Ability to turn off status, gender and login notifications should you not want to see them.
- Ability to "pause" all incoming chat so you can better review our pages.
- You can accept all pending group requests at once, or choose to accept each one individually.
- Gender choices.
- If turned on, when members first use /social join, they'll be requested to choose a gender.
- OPTIONAL. Players can be stopped from moving until a Gender is chosen.
- OPTIONAL. Player will be reminded to choose a Gender upon login.
- Gender can only be chosen once by a player. Admin command available to change if needed.
- Auto-Join / Manual Join.
- DEFAULT. All players on the server are automatically part of the network.
- OPTIONAL. You can make it so players are required to join manually instead.
- Players can use /social quit to leave the network and not receive any further notices from it.
- Players can use /social join to join back onto the network again if they choose.
- Player profile's. You can now read details about a player:
- Name
- Gender if turned on
- join date (to the network, not the game)
- last login
- Number of Friends
- Number of Relationships
- Number of Children
- Engaged/Married/Divorced
- Status Message (self set)
Weddings !
Yes, you can have Weddings on your server !
By using Priest's, you can create a small Wedding ceremony for your players.
Some screenshots on what the ceremony looks like.
Dependencies
Please note the following:
Social Network requires plug-in Vault for managing the connections to your existing permissions and economy plug-ins. See the Vault site for supported permission & economy plug-ins.
Commands Preview
This is just a quick preview of some of the available commands.
For full details visit our Wiki Commands page.
Main Commands
All users have access to the following commands:
| Command | Description |
| /social join | Join the network. Used to join the network should you not have auto-join on. Also used to re-join if the player had previously quit. |
| /social quit | Quit the network. This will delete you from all groups and make it so you no longer receive any communication from the network. You will also not be auto-joined again should that be active. |
| /social gender | Choose a Gender for your character. |
| /social online | See who's online in all the groups you belong to. |
| /social lastlogin <player> | Check the last time a player in your groups has logged in. |
| /social status | Set a status message to be displayed in your profile. |
| /social profile [player] | Displays your own or the player details. |
| /social pausechat | Temporarily block all incoming & outgoing chat. |
| /social mute <login|status|gender> | Stop chosen notification from being displayed to you. |
| /social requests | See any pending requests for you to accept or reject. |
| /social alerts | Read any alerts (usually system) currently available. |
| /social help | Run the help pages. |
| /social ignore <player> | Ignores a player. Blocks request and any perk commands. |
Group Commands
Most groups use the following commands:
| Command | Description |
| /social <group> request <player> | Send a group request to a player. |
| /social <group> accept <player> | Accepts a group request from a player. |
| /social <group> reject <player> | Rejects a group request from a player and tells them. |
| /social <group> ignore <player> | Rejects a group request from a player and does not tell them. |
| /social <group> acceptall | Accepts all current requests from everyone in that group. |
| /social <group> rejectall | Rejects all requests from everyone in that group and tells them. |
| /social <group> ignoreall | Rejects all requests from everyone in that group and does not tell them. |
| /social <group> remove <player> | Removes the player from the group. |
| /social <group> list | Lists all the players in the group. |
Custom Commands !
Want to personalize Social Network even more by creating your own set of commands? You can do that to !
You are able to re-map any of the commands to anything you like.
For example, you can change "/social friend request <player>" to simply be "/social fradd <player>".
See configuration for more details on how to configure custom commands.
Permissions & Configuration
For details on permissions, visit the Permissions section of our Wiki.
The default configuration file provided to you upon first loading the plug-in contains some basic information.
You can review the default configuration here.
For advanced configurations, please see our Wiki.
Wiki/Source
For more details on this plug-in, please visit our Wiki.
Source code can be found on github.
Issues, Suggestions and Idea's
If you wish to provide feedback, issues or idea's, please use the Tickets system found up top or leave a message below.
I check this page at least once a day and everything will be taken into consideration, you just have to ask !
If submitting an error, please try to provide as much details as you can. Example: (but not limited to)
- Commands run
- Configuration information
- Detailed steps to reproduce (should it not be just the commands)
- Storage files (from the DataFiles folder) of player affected.
Any or all of the above will go a long way in helping me resolve your problem quickly and efficiently. All tickets will be looked at, but those that are written best will take priority.
For submitting suggestions or idea's, please check to see if someone else has suggested something similar and if so, add a comment to that ticket instead.
With that said, if you have any normal comments or questions, feel free to post them below.
Change Log
The change log for the latest release is too long to list here. Please visit the change log on GitHub:
https://github.com/Netprogs/SocialNetwork/wiki/Change-Log
Future Updates
A few idea's so far have been tossed around for future updates:
- Private chat channels for groups
- Custom groups (might not be possible, but considering trying it)
- "Likes" (similar to forums) for players
- Inventory Sharing Perk.
As always, open to new idea's, fire away and I'll see what I can do.