EQ2EMu/EQ2/source/WorldServer/PlayerGroups.h

/*
EQ2Emulator:  Everquest II Server Emulator
Copyright (C) 2007  EQ2EMulator Development Team (http://www.eq2emulator.net)

This file is part of EQ2Emulator.

EQ2Emulator 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, either version 3 of the License, or
(at your option) any later version.

EQ2Emulator 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 EQ2Emulator.  If not, see <http://www.gnu.org/licenses/>.
*/

#ifndef __PLAYERGROUPS_H__
#define __PLAYERGROUPS_H__

#include <deque>
#include <map>
#include <mutex>
#include <shared_mutex>
#include "Spells.h"

#include "../common/types.h"
#include "Entity.h"

using namespace std;

// GroupOptions isn't used yet
struct GroupOptions {
	int8	loot_method;
	int8	loot_items_rarity;
	int8	auto_split;
	int8	default_yell;
	int8	group_lock_method;
	int8	group_autolock;
	int8	solo_autolock;
	int8	auto_loot_method;
	int8	last_looted_index;
};

/// <summary>All the generic info for the group window, plus a client pointer for players</summary>
struct GroupMemberInfo {
	int32	group_id;
	string	name;
	string	zone;
	sint32	hp_current;
	sint32	hp_max;
	sint32	power_current;
	sint32	power_max;
	int16	level_current;
	int16	level_max;
	int8	race_id;
	int8	class_id;
	bool	leader;
	Client* client;
	Entity* member;
	int32	mentor_target_char_id;
	bool	is_client;
	int32	zone_id;
	int32	instance_id;
	string	client_peer_address;
	int16	client_peer_port;
	bool	is_raid_looter;
};

/// <summary>Represents a players group in game</summary>
class PlayerGroup {
public:
	PlayerGroup(int32 id);
	~PlayerGroup();

	/// <summary>Adds a new member to the players group</summary>
	/// <param name='member'>Entity to add to the group, can be a Player or NPC</param>
	/// <returns>True if the member was added</returns>
	bool AddMember(Entity* member, bool is_leader);
	bool AddMemberFromPeer(std::string name, bool isleader, bool isclient, int8 class_id, sint32 hp_cur, sint32 hp_max, int16 level_cur, int16 level_max,
		sint32 power_cur, sint32 power_max, int8 race_id, std::string zonename, int32 mentor_target_char_id, int32 zone_id, int32 instance_id,
		std::string peer_client_address, int16 peer_client_port, bool is_raid_looter);
	/// <summary>Removes a member from the players group</summary>
	/// <param name='member'>Entity to remove from the player group</param>
	/// <returns>True if the member was removed</param>
	bool RemoveMember(Entity* member);
	bool RemoveMember(std::string name, bool is_client, int32 charID);

	/// <summary>Removes all members from the group and destroys the group</summary>
	void Disband();

	/// <summary>Sends updates to all the clients in the group</summary>
	/// <param name='exclude'>Client to exclude from the update</param>
	void SendGroupUpdate(Client* exclude = 0, bool forceRaidUpdate = false);

	/// <summary>Gets the total number of members in the group</summary>
	/// <returns>int32, number of members in the group</returns>
	int32 Size() { return m_members.size(); }

	/// <summary>Gets a pointer to the list of members</summary>
	/// <returns>deque pointer</returns>
	deque<GroupMemberInfo*>* GetMembers() { return &m_members; }


	void SimpleGroupMessage(const char* message);
	void SendGroupMessage(int8 type, const char* message, ...);
	void GroupChatMessage(Spawn* from, int32 language, const char* message, int16 channel = CHANNEL_GROUP_SAY);
	void GroupChatMessage(std::string fromName, int32 language, const char* message, int16 channel = CHANNEL_GROUP_SAY);
	bool MakeLeader(Entity* new_leader);
	std::string GetLeaderName();

	bool ShareQuestWithGroup(Client* quest_sharer, Quest* quest);

	void RemoveClientReference(Client* remove);
	void UpdateGroupMemberInfo(Entity* ent, bool groupMembersLocked = false);
	Entity* GetGroupMemberByPosition(Entity* seeker, int32 mapped_position);

	void SetDefaultGroupOptions(GroupOptions* options = nullptr);
	bool GetDefaultGroupOptions(GroupOptions* options);

	GroupOptions* GetGroupOptions() { return &group_options; }
	int8 GetLastLooterIndex() { return group_options.last_looted_index; }
	void SetNextLooterIndex(int8 new_index) { group_options.last_looted_index = new_index; }

	int32 GetID() { return m_id; }

	void GetRaidGroups(std::vector<int32>* groups);
	void ReplaceRaidGroups(std::vector<int32>* groups);
	bool IsInRaidGroup(int32 groupID, bool isLeaderGroup = false);
	void AddGroupToRaid(int32 groupID);
	void RemoveGroupFromRaid(int32 groupID);
	bool IsGroupRaid();
	void ClearGroupRaid();
	Mutex MGroupMembers;				// Mutex for the group members
private:
	GroupOptions			group_options;
	int32					m_id;		// ID of this group
	deque<GroupMemberInfo*>	m_members;	// List of members in this group
	std::vector<int32> m_raidgroups;
	mutable std::shared_mutex			MRaidGroups; // mutex for std vector
};

/// <summary>Responsible for managing all the player groups in the world</summary>
class PlayerGroupManager {
public:
	PlayerGroupManager();
	~PlayerGroupManager();

	/// <summary>Adds a member to a group</summary>
	/// <param name='group_id'>ID of the group to add a member to</param>
	/// <param name='member'>Entity* to add to the group</param>
	/// <returns>True if the member was added to the group</returns>
	bool AddGroupMember(int32 group_id, Entity* member, bool is_leader = false);
	bool AddGroupMemberFromPeer(int32 group_id, GroupMemberInfo* info);

	/// <summary>Removes a member from a group</summary>
	/// <param name='group_id'>ID of the group to remove a member from</param>
	/// <param name='member'>Entity* to remove from the group</param>
	/// <returns>True if the member was removed from the group</returns>
	bool RemoveGroupMember(int32 group_id, Entity* member);
	bool RemoveGroupMember(int32 group_id, std::string name, bool is_client, int32 charID);

	/// <summary>Creates a new group with the provided Entity* as the leader</summary>
	/// <param name='leader'>The Entity* that will be the leader of the group</param>
	int32 NewGroup(Entity* leader, GroupOptions* goptions, int32 override_group_id = 0);

	/// <summary>Removes the group from the group manager</summary>
	/// <param name='group_id'>ID of the group to remove</param>
	void RemoveGroup(int32 group_id);

	/// <summary>Handles a player inviting another player or NPC to a group</summary>
	/// <param name='leader'>Player that sent the invite</param>
	/// <param name='member'>Player or NPC that is the target of the invite</param>
	/// <returns>Error code if invite was unsuccessful, 0 if successful</returns>
	int8 Invite(Player* leader, Entity* member);
	bool AddInvite(Player* leader, Entity* member);

	/// <summary>Handles accepting of a group invite</summary>
	/// <param name='member'>Entity* that is accepting the invite</param>
	/// <returns>Error code if accepting the invite failed, 0 if successful<returns>
	int8 AcceptInvite(Entity* member, int32* group_override_id = nullptr, bool auto_add_group = true);

	/// <summary>Handles declining of a group invite</summary>
	/// <param name='member'>Entity* that is declining the invite</param>
	void DeclineInvite(Entity* member);

	/// <summary>Checks to see if there is a group with the given id in the group manager</summary>
	/// <param name='group_id'>ID to check for</param>
	/// <returns>True if a group with the given ID is found</returns>
	bool IsGroupIDValid(int32 group_id);

	/// <summary>Send updates to all the clients in the group</summary>
	/// <param name='group_id'>ID of the group to send updates to</param>
	/// <param name='exclude'>Client* to exclude from the update, usually the one that triggers the update</param>
	void SendGroupUpdate(int32 group_id, Client* exclude = 0, bool forceRaidUpdate = false);


	PlayerGroup* GetGroup(int32 group_id);

	/// <summary>Read locks the group list, no changes to the list should be made when using this</summary>
	/// <param name='function'>Name of the function called from, used for better debugging in the event of a deadlock</param>
	/// <param name='line'>Line number that this was called from, used for better debugging in the event of a deadlock</param>
	void GroupHardLock(const char* function = 0, int32 line = 0U) { MGroups.lock(); }
	void GroupLock(const char* function = 0, int32 line = 0U) { MGroups.lock_shared(); }

	/// <summary>Releases the readlock acquired from GroupLock()</summary>
	/// <param name='function'>Name of the function called from, used for better debugging in the event of a deadlock</param>
	/// <param name='line'>Line number that this was called from, used for better debugging in the event of a deadlock</param>
	void ReleaseGroupHardLock(const char* function = 0, int32 line = 0U) { MGroups.unlock(); }
	void ReleaseGroupLock(const char* function = 0, int32 line = 0U) { MGroups.unlock_shared(); }

	void ClearPendingInvite(Entity* member);

	std::string HasPendingInvite(Entity* member);

	void RemoveGroupBuffs(int32 group_id, Client* client);

	int32 GetGroupSize(int32 group_id);

	void SendGroupQuests(int32 group_id, Client* client);
	bool HasGroupCompletedQuest(int32 group_id, int32 quest_id);

	void SimpleGroupMessage(int32 group_id, const char* message);
	void SendGroupMessage(int32 group_id, int8 type, const char* message, ...);
	void GroupMessage(int32 group_id, const char* message, ...);
	void GroupChatMessage(int32 group_id, Spawn* from, int32 language, const char* message, int16 channel = CHANNEL_GROUP_SAY);
	void GroupChatMessage(int32 group_id, std::string fromName, int32 language, const char* message, int16 channel = CHANNEL_GROUP_SAY);
	void SendGroupChatMessage(int32 group_id, int16 channel, const char* message, ...);
	bool MakeLeader(int32 group_id, Entity* new_leader);
	void UpdateGroupBuffs();

	bool IsInGroup(int32 group_id, Entity* member);
	Entity* IsPlayerInGroup(int32 group_id, int32 char_id);
	// TODO: Any function below this comment
	bool IsSpawnInGroup(int32 group_id, string name); // used in follow
	Player* GetGroupLeader(int32 group_id);

	void UpdateGroupMemberInfoFromPeer(int32 group_id, std::string name, bool is_client, GroupMemberInfo* updateinfo);
	void SendPeerGroupData(std::string peerId);

	void ClearGroupRaid(int32 groupID);
	void RemoveGroupFromRaid(int32 groupID, int32 targetGroupID);
	bool IsInRaidGroup(int32 groupID, int32 targetGroupID, bool isLeaderGroup = false);
	bool GetDefaultGroupOptions(int32 group_id, GroupOptions* options);
	void GetRaidGroups(int32 group_id, std::vector<int32>* groups);
	void ReplaceRaidGroups(int32 groupID, std::vector<int32>* newGroups);
	void SetGroupOptions(int32 groupID, GroupOptions* options);
	void SendWhoGroupMembers(Client* client, int32 groupID);
	void SendWhoRaidMembers(Client* client, int32 groupID);
	int8 AcceptRaidInvite(std::string acceptorName, int32 groupID);
	bool SendRaidInvite(Client* sender, Entity* target);
	void SplitWithGroupOrRaid(Client* client, int32 coin_plat, int32 coin_gold, int32 coin_silver, int32 coin_copper);
	bool IdentifyMemberInGroupOrRaid(ZoneChangeDetails* details, Client* client, int32 zoneID, int32 instanceID = 0);
	void ClearGroupRaidLooterFlag(int32 groupID);
private:
	int32								m_nextGroupID;			// Used to generate a new unique id for new groups

	map<int32, PlayerGroup*>			m_groups;				// int32 is the group id, PlayerGroup* is a pointer to the actual group
	map<string, string>					m_pendingInvites;		// First string is the person invited to the group, second string is the leader of the group
	map<string, string>					m_raidPendingInvites;	// First string is the other group leader invited to the group, second string is the leader of the raid

	mutable std::shared_mutex			MGroups;				// Mutex for the group map (m_groups)
	Mutex								MPendingInvites;		// Mutex for the pending invites map (m_pendingInvites)
};

#endif