ScriptMgr.h

Go to the documentation of this file.

/*
 * This file is part of the TrinityCore Project. See AUTHORS file for Copyright information
 *
 * This program 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 2 of the License, or (at your
 * option) any later version.
 *
 * This program 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 this program. If not, see <http://www.gnu.org/licenses/>.
 */
 
#ifndef SC_SCRIPTMGR_H
#define SC_SCRIPTMGR_H
 
#include "Common.h"
#include "ObjectGuid.h"
#include "Tuples.h"
#include "Types.h"
#include <memory>
#include <vector>
 
class AccountMgr;
class AuctionHouseObject;
class Aura;
class AuraScript;
class Battlefield;
class Battleground;
class BattlegroundMap;
class Channel;
class Creature;
class CreatureAI;
class DynamicObject;
class GameObject;
class GameObjectAI;
class Guild;
class GridMap;
class Group;
class InstanceMap;
class InstanceScript;
class Item;
class Map;
class ModuleReference;
class OutdoorPvP;
class Player;
class Quest;
class ScriptMgr;
class Spell;
class SpellInfo;
class SpellScript;
class SpellCastTargets;
class Transport;
class Unit;
class Vehicle;
class Weather;
class WorldPacket;
class WorldSocket;
class WorldObject;
class WorldSession;
 
struct AreaTriggerEntry;
struct AuctionEntry;
struct ConditionSourceInfo;
struct Condition;
struct CreatureTemplate;
struct CreatureData;
struct ItemTemplate;
struct MapEntry;
struct Position;
 
namespace Trinity::ChatCommands { struct ChatCommandBuilder; }
 
enum BattlegroundTypeId : uint32;
enum ContentLevels : uint8;
enum Difficulty : uint8;
enum DuelCompleteType : uint8;
enum Emote : uint32;
enum QuestStatus : uint8;
enum RemoveMethod : uint8;
enum ShutdownExitCode : uint32;
enum ShutdownMask : uint32;
enum SpellEffIndex : uint8;
enum WeatherState : uint32;
enum XPColorChar : uint8;
 
#define VISIBLE_RANGE       166.0f                          //MAX visible range (size of grid)
 
/*
    @todo Add more script type classes.
 
    MailScript
    SessionScript
    CollisionScript
    ArenaTeamScript
 
*/
 
/*
    Standard procedure when adding new script type classes:
 
    First of all, define the actual class, and have it inherit from ScriptObject, like so:
 
    class MyScriptType : public ScriptObject
    {
        uint32 _someId;
 
        private:
 
            void RegisterSelf();
 
        protected:
 
            MyScriptType(char const* name, uint32 someId)
                : ScriptObject(name), _someId(someId)
            {
                ScriptRegistry<MyScriptType>::AddScript(this);
            }
 
        public:
 
            // If a virtual function in your script type class is not necessarily
            // required to be overridden, just declare it virtual with an empty
            // body. If, on the other hand, it's logical only to override it (i.e.
            // if it's the only method in the class), make it pure virtual, by adding
            // = 0 to it.
            virtual void OnSomeEvent(uint32 someArg1, std::string& someArg2) { }
 
            // This is a pure virtual function:
            virtual void OnAnotherEvent(uint32 someArg) = 0;
    }
 
    Next, you need to add a specialization for ScriptRegistry. Put this in the bottom of
    ScriptMgr.cpp:
 
    template class ScriptRegistry<MyScriptType>;
 
    Now, add a cleanup routine in ScriptMgr::~ScriptMgr:
 
    SCR_CLEAR(MyScriptType);
 
    Now your script type is good to go with the script system. What you need to do now
    is add functions to ScriptMgr that can be called from the core to actually trigger
    certain events. For example, in ScriptMgr.h:
 
    void OnSomeEvent(uint32 someArg1, std::string& someArg2);
    void OnAnotherEvent(uint32 someArg);
 
    In ScriptMgr.cpp:
 
    void ScriptMgr::OnSomeEvent(uint32 someArg1, std::string& someArg2)
    {
        FOREACH_SCRIPT(MyScriptType)->OnSomeEvent(someArg1, someArg2);
    }
 
    void ScriptMgr::OnAnotherEvent(uint32 someArg)
    {
        FOREACH_SCRIPT(MyScriptType)->OnAnotherEvent(someArg1, someArg2);
    }
 
    Now you simply call these two functions from anywhere in the core to trigger the
    event on all registered scripts of that type.
*/
 
class TC_GAME_API ScriptObject
{
    friend class ScriptMgr;
 
    public:
 
        std::string const& GetName() const;
 
    protected:
 
        ScriptObject(char const* name);
        virtual ~ScriptObject();
 
    private:
 
        std::string const _name;
};
 
class TC_GAME_API SpellScriptLoader : public ScriptObject
{
    protected:
 
        explicit SpellScriptLoader(char const* name);
 
    public:
 
        // Should return a fully valid SpellScript pointer.
        virtual SpellScript* GetSpellScript() const;
 
        // Should return a fully valid AuraScript pointer.
        virtual AuraScript* GetAuraScript() const;
};
 
class TC_GAME_API ServerScript : public ScriptObject
{
    protected:
 
        explicit ServerScript(char const* name);
 
    public:
 
        // Called when reactive socket I/O is started (WorldTcpSessionMgr).
        virtual void OnNetworkStart();
 
        // Called when reactive I/O is stopped.
        virtual void OnNetworkStop();
 
        // Called when a remote socket establishes a connection to the server. Do not store the socket object.
        virtual void OnSocketOpen(std::shared_ptr<WorldSocket> socket);
 
        // Called when a socket is closed. Do not store the socket object, and do not rely on the connection
        // being open; it is not.
        virtual void OnSocketClose(std::shared_ptr<WorldSocket> socket);
 
        // Called when a packet is sent to a client. The packet object is a copy of the original packet, so reading
        // and modifying it is safe.
        virtual void OnPacketSend(WorldSession* session, WorldPacket& packet);
 
        // Called when a (valid) packet is received by a client. The packet object is a copy of the original packet, so
        // reading and modifying it is safe. Make sure to check WorldSession pointer before usage, it might be null in case of auth packets
        virtual void OnPacketReceive(WorldSession* session, WorldPacket& packet);
};
 
class TC_GAME_API WorldScript : public ScriptObject
{
    protected:
 
        explicit WorldScript(char const* name);
 
    public:
 
        // Called when the open/closed state of the world changes.
        virtual void OnOpenStateChange(bool open);
 
        // Called after the world configuration is (re)loaded.
        virtual void OnConfigLoad(bool reload);
 
        // Called before the message of the day is changed.
        virtual void OnMotdChange(std::string& newMotd);
 
        // Called when a world shutdown is initiated.
        virtual void OnShutdownInitiate(ShutdownExitCode code, ShutdownMask mask);
 
        // Called when a world shutdown is cancelled.
        virtual void OnShutdownCancel();
 
        // Called on every world tick (don't execute too heavy code here).
        virtual void OnUpdate(uint32 diff);
 
        // Called when the world is started.
        virtual void OnStartup();
 
        // Called when the world is actually shut down.
        virtual void OnShutdown();
};
 
class TC_GAME_API FormulaScript : public ScriptObject
{
    protected:
 
        explicit FormulaScript(char const* name);
 
    public:
 
        // Called after calculating honor.
        virtual void OnHonorCalculation(float& honor, uint8 level, float multiplier);
 
        // Called after gray level calculation.
        virtual void OnGrayLevelCalculation(uint8& grayLevel, uint8 playerLevel);
 
        // Called after calculating experience color.
        virtual void OnColorCodeCalculation(XPColorChar& color, uint8 playerLevel, uint8 mobLevel);
 
        // Called after calculating zero difference.
        virtual void OnZeroDifferenceCalculation(uint8& diff, uint8 playerLevel);
 
        // Called after calculating base experience gain.
        virtual void OnBaseGainCalculation(uint32& gain, uint8 playerLevel, uint8 mobLevel, ContentLevels content);
 
        // Called after calculating experience gain.
        virtual void OnGainCalculation(uint32& gain, Player* player, Unit* unit);
 
        // Called when calculating the experience rate for group experience.
        virtual void OnGroupRateCalculation(float& rate, uint32 count, bool isRaid);
};
 
template<class TMap>
class TC_GAME_API MapScript
{
        MapEntry const* _mapEntry;
 
    protected:
 
        explicit MapScript(MapEntry const* mapEntry);
 
    public:
 
        // Gets the MapEntry structure associated with this script. Can return NULL.
        MapEntry const* GetEntry() const;
 
        // Called when the map is created.
        virtual void OnCreate(TMap* map);
 
        // Called just before the map is destroyed.
        virtual void OnDestroy(TMap* map);
 
        // Called when a grid map is loaded.
        virtual void OnLoadGridMap(TMap* /*map*/, GridMap* /*gmap*/, uint32 /*gx*/, uint32 /*gy*/) { }
 
        // Called when a grid map is unloaded.
        virtual void OnUnloadGridMap(TMap* /*map*/, GridMap* /*gmap*/, uint32 /*gx*/, uint32 /*gy*/)  { }
 
        // Called when a player enters the map.
        virtual void OnPlayerEnter(TMap* map, Player* player);
 
        // Called when a player leaves the map.
        virtual void OnPlayerLeave(TMap* map, Player* player);
 
        virtual void OnUpdate(TMap* map, uint32 diff);
};
 
class TC_GAME_API WorldMapScript : public ScriptObject, public MapScript<Map>
{
    protected:
 
        explicit WorldMapScript(char const* name, uint32 mapId);
};
 
class TC_GAME_API InstanceMapScript : public ScriptObject, public MapScript<InstanceMap>
{
    protected:
 
        explicit InstanceMapScript(char const* name, uint32 mapId);
 
    public:
 
        // Gets an InstanceScript object for this instance.
        virtual InstanceScript* GetInstanceScript(InstanceMap* map) const;
};
 
class TC_GAME_API BattlegroundMapScript : public ScriptObject, public MapScript<BattlegroundMap>
{
    protected:
 
        explicit BattlegroundMapScript(char const* name, uint32 mapId);
};
 
class TC_GAME_API ItemScript : public ScriptObject
{
    protected:
 
        explicit ItemScript(char const* name);
 
    public:
 
        // Called when a player accepts a quest from the item.
        virtual bool OnQuestAccept(Player* player, Item* item, Quest const* quest);
 
        // Called when a player uses the item.
        virtual bool OnUse(Player* player, Item* item, SpellCastTargets const& targets);
 
        // Called when the item expires (is destroyed).
        virtual bool OnExpire(Player* player, ItemTemplate const* proto);
 
        // Called when the item is destroyed.
        virtual bool OnRemove(Player* player, Item* item);
 
        // Called before casting a combat spell from this item (chance on hit spells of item template, can be used to prevent cast if returning false)
        virtual bool OnCastItemCombatSpell(Player* player, Unit* victim, SpellInfo const* spellInfo, Item* item);
};
 
class TC_GAME_API UnitScript : public ScriptObject
{
    protected:
 
        explicit UnitScript(char const* name);
 
    public:
        // Called when a unit deals healing to another unit
        virtual void OnHeal(Unit* healer, Unit* reciever, uint32& gain);
 
        // Called when a unit deals damage to another unit
        virtual void OnDamage(Unit* attacker, Unit* victim, uint32& damage);
 
        // Called when DoT's Tick Damage is being Dealt
        virtual void ModifyPeriodicDamageAurasTick(Unit* target, Unit* attacker, uint32& damage);
 
        // Called when Melee Damage is being Dealt
        virtual void ModifyMeleeDamage(Unit* target, Unit* attacker, uint32& damage);
 
        // Called when Spell Damage is being Dealt
        virtual void ModifySpellDamageTaken(Unit* target, Unit* attacker, int32& damage);
};
 
class TC_GAME_API CreatureScript : public ScriptObject
{
    protected:
 
        explicit CreatureScript(char const* name);
 
    public:
        // Called when a CreatureAI object is needed for the creature.
        virtual CreatureAI* GetAI(Creature* creature) const = 0;
};
 
class TC_GAME_API GameObjectScript : public ScriptObject
{
    protected:
 
        explicit GameObjectScript(char const* name);
 
    public:
 
        // Called when a GameObjectAI object is needed for the gameobject.
        virtual GameObjectAI* GetAI(GameObject* go) const = 0;
};
 
class TC_GAME_API AreaTriggerScript : public ScriptObject
{
    protected:
 
        explicit AreaTriggerScript(char const* name);
 
    public:
 
        // Called when the area trigger is activated by a player.
        virtual bool OnTrigger(Player* player, AreaTriggerEntry const* trigger);
};
 
class TC_GAME_API OnlyOnceAreaTriggerScript : public AreaTriggerScript
{
    using AreaTriggerScript::AreaTriggerScript;
 
    public:
        bool OnTrigger(Player* /*player*/, AreaTriggerEntry const* /*trigger*/) final override;
 
    protected:
        // returns true if the trigger was successfully handled, false if we should try again next time
        virtual bool TryHandleOnce(Player* player, AreaTriggerEntry const* trigger) = 0;
        void ResetAreaTriggerDone(InstanceScript* instance, uint32 triggerId);
        void ResetAreaTriggerDone(Player const* player, AreaTriggerEntry const* trigger);
};
 
class TC_GAME_API BattlefieldScript : public ScriptObject
{
    protected:
 
        explicit BattlefieldScript(char const* name);
 
    public:
 
        virtual Battlefield* GetBattlefield() const = 0;
};
 
class TC_GAME_API BattlegroundScript : public ScriptObject
{
    protected:
 
        explicit BattlegroundScript(char const* name);
 
    public:
 
        // Should return a fully valid Battleground object for the type ID.
        virtual Battleground* GetBattleground() const = 0;
};
 
class TC_GAME_API OutdoorPvPScript : public ScriptObject
{
    protected:
 
        explicit OutdoorPvPScript(char const* name);
 
    public:
 
        // Should return a fully valid OutdoorPvP object for the type ID.
        virtual OutdoorPvP* GetOutdoorPvP() const = 0;
};
 
class TC_GAME_API CommandScript : public ScriptObject
{
    protected:
 
        explicit CommandScript(char const* name);
 
    public:
 
        // Should return a pointer to a valid command table (ChatCommand array) to be used by ChatHandler.
        virtual std::vector<Trinity::ChatCommands::ChatCommandBuilder> GetCommands() const = 0;
};
 
class TC_GAME_API WeatherScript : public ScriptObject
{
    protected:
 
        explicit WeatherScript(char const* name);
 
    public:
 
        // Called when the weather changes in the zone this script is associated with.
        virtual void OnChange(Weather* weather, WeatherState state, float grade);
 
        virtual void OnUpdate(Weather* weather, uint32 diff);
};
 
class TC_GAME_API AuctionHouseScript : public ScriptObject
{
    protected:
 
        explicit AuctionHouseScript(char const* name);
 
    public:
 
        // Called when an auction is added to an auction house.
        virtual void OnAuctionAdd(AuctionHouseObject* ah, AuctionEntry* entry);
 
        // Called when an auction is removed from an auction house.
        virtual void OnAuctionRemove(AuctionHouseObject* ah, AuctionEntry* entry);
 
        // Called when an auction was succesfully completed.
        virtual void OnAuctionSuccessful(AuctionHouseObject* ah, AuctionEntry* entry);
 
        // Called when an auction expires.
        virtual void OnAuctionExpire(AuctionHouseObject* ah, AuctionEntry* entry);
};
 
class TC_GAME_API ConditionScript : public ScriptObject
{
    protected:
 
        explicit ConditionScript(char const* name);
 
    public:
 
        // Called when a single condition is checked for a player.
        virtual bool OnConditionCheck(Condition const* condition, ConditionSourceInfo& sourceInfo);
};
 
class TC_GAME_API VehicleScript : public ScriptObject
{
    protected:
 
        explicit VehicleScript(char const* name);
 
    public:
 
        // Called after a vehicle is installed.
        virtual void OnInstall(Vehicle* veh);
 
        // Called after a vehicle is uninstalled.
        virtual void OnUninstall(Vehicle* veh);
 
        // Called when a vehicle resets.
        virtual void OnReset(Vehicle* veh);
 
        // Called after an accessory is installed in a vehicle.
        virtual void OnInstallAccessory(Vehicle* veh, Creature* accessory);
 
        // Called after a passenger is added to a vehicle.
        virtual void OnAddPassenger(Vehicle* veh, Unit* passenger, int8 seatId);
 
        // Called after a passenger is removed from a vehicle.
        virtual void OnRemovePassenger(Vehicle* veh, Unit* passenger);
};
 
class TC_GAME_API DynamicObjectScript : public ScriptObject
{
    protected:
 
        explicit DynamicObjectScript(char const* name);
 
    public:
 
        virtual void OnUpdate(DynamicObject* obj, uint32 diff);
};
 
class TC_GAME_API TransportScript : public ScriptObject
{
    protected:
 
        explicit TransportScript(char const* name);
 
    public:
 
        // Called when a player boards the transport.
        virtual void OnAddPassenger(Transport* transport, Player* player);
 
        // Called when a creature boards the transport.
        virtual void OnAddCreaturePassenger(Transport* transport, Creature* creature);
 
        // Called when a player exits the transport.
        virtual void OnRemovePassenger(Transport* transport, Player* player);
 
        // Called when a transport moves.
        virtual void OnRelocate(Transport* transport, uint32 waypointId, uint32 mapId, float x, float y, float z);
 
        virtual void OnUpdate(Transport* transport, uint32 diff);
};
 
class TC_GAME_API AchievementCriteriaScript : public ScriptObject
{
    protected:
 
        explicit AchievementCriteriaScript(char const* name);
 
    public:
 
        // Called when an additional criteria is checked.
        virtual bool OnCheck(Player* source, Unit* target) = 0;
};
 
class TC_GAME_API PlayerScript : public ScriptObject
{
    protected:
 
        explicit PlayerScript(char const* name);
 
    public:
 
        // Called when a player kills another player
        virtual void OnPVPKill(Player* killer, Player* killed);
 
        // Called when a player kills a creature
        virtual void OnCreatureKill(Player* killer, Creature* killed);
 
        // Called when a player is killed by a creature
        virtual void OnPlayerKilledByCreature(Creature* killer, Player* killed);
 
        // Called when a player's level changes (after the level is applied)
        virtual void OnLevelChanged(Player* player, uint8 oldLevel);
 
        // Called when a player's free talent points change (right before the change is applied)
        virtual void OnFreeTalentPointsChanged(Player* player, uint32 points);
 
        // Called when a player's talent points are reset (right before the reset is done)
        virtual void OnTalentsReset(Player* player, bool involuntarily);
 
        // Called when a player's money is modified (before the modification is done)
        virtual void OnMoneyChanged(Player* player, int32& amount);
 
        // Called when a player's money is at limit (amount = money tried to add)
        virtual void OnMoneyLimit(Player* player, int32 amount);
 
        // Called when a player gains XP (before anything is given)
        virtual void OnGiveXP(Player* player, uint32& amount, Unit* victim);
 
        // Called when a player's reputation changes (before it is actually changed)
        virtual void OnReputationChange(Player* player, uint32 factionId, int32& standing, bool incremental);
 
        // Called when a duel is requested
        virtual void OnDuelRequest(Player* target, Player* challenger);
 
        // Called when a duel starts (after 3s countdown)
        virtual void OnDuelStart(Player* player1, Player* player2);
 
        // Called when a duel ends
        virtual void OnDuelEnd(Player* winner, Player* loser, DuelCompleteType type);
 
        // The following methods are called when a player sends a chat message.
        virtual void OnChat(Player* player, uint32 type, uint32 lang, std::string& msg);
 
        virtual void OnChat(Player* player, uint32 type, uint32 lang, std::string& msg, Player* receiver);
 
        virtual void OnChat(Player* player, uint32 type, uint32 lang, std::string& msg, Group* group);
 
        virtual void OnChat(Player* player, uint32 type, uint32 lang, std::string& msg, Guild* guild);
 
        virtual void OnChat(Player* player, uint32 type, uint32 lang, std::string& msg, Channel* channel);
 
        // Both of the below are called on emote opcodes.
        virtual void OnEmote(Player* player, Emote emote);
 
        virtual void OnTextEmote(Player* player, uint32 textEmote, uint32 emoteNum, ObjectGuid guid);
 
        // Called in Spell::Cast.
        virtual void OnSpellCast(Player* player, Spell* spell, bool skipCheck);
 
        // Called when a player logs in.
        virtual void OnLogin(Player* player, bool firstLogin);
 
        // Called when a player logs out.
        virtual void OnLogout(Player* player);
 
        // Called when a player is created.
        virtual void OnCreate(Player* player);
 
        // Called when a player is deleted.
        virtual void OnDelete(ObjectGuid guid, uint32 accountId);
 
        // Called when a player delete failed
        virtual void OnFailedDelete(ObjectGuid guid, uint32 accountId);
 
        // Called when a player is about to be saved.
        virtual void OnSave(Player* player);
 
        // Called when a player is bound to an instance
        virtual void OnBindToInstance(Player* player, Difficulty difficulty, uint32 mapId, bool permanent, uint8 extendState);
 
        // Called when a player switches to a new zone
        virtual void OnUpdateZone(Player* player, uint32 newZone, uint32 newArea);
 
        // Called when a player changes to a new map (after moving to new map)
        virtual void OnMapChanged(Player* player);
 
        // Called when a player obtains progress on a quest's objective
        virtual void OnQuestObjectiveProgress(Player* /*player*/, Quest const* /*quest*/, uint32 /*objectiveIndex*/, uint16 /*progress*/) { }
 
        // Called after a player's quest status has been changed
        virtual void OnQuestStatusChange(Player* player, uint32 questId);
 
        // Called when a player presses release when he died
        virtual void OnPlayerRepop(Player* player);
 
        // Called when a player completes a movie
        virtual void OnMovieComplete(Player* player, uint32 movieId);
 
};
 
class TC_GAME_API AccountScript : public ScriptObject
{
    protected:
 
        explicit AccountScript(char const* name);
 
    public:
 
        // Called when an account logged in succesfully
        virtual void OnAccountLogin(uint32 accountId);
 
        // Called when an account login failed
        virtual void OnFailedAccountLogin(uint32 accountId);
 
        // Called when Email is successfully changed for Account
        virtual void OnEmailChange(uint32 accountId);
 
        // Called when Email failed to change for Account
        virtual void OnFailedEmailChange(uint32 accountId);
 
        // Called when Password is successfully changed for Account
        virtual void OnPasswordChange(uint32 accountId);
 
        // Called when Password failed to change for Account
        virtual void OnFailedPasswordChange(uint32 accountId);
};
 
class TC_GAME_API GuildScript : public ScriptObject
{
    protected:
 
        explicit GuildScript(char const* name);
 
    public:
 
        // Called when a member is added to the guild.
        virtual void OnAddMember(Guild* guild, Player* player, uint8& plRank);
 
        // Called when a member is removed from the guild.
        virtual void OnRemoveMember(Guild* guild, Player* player, bool isDisbanding, bool isKicked);
 
        // Called when the guild MOTD (message of the day) changes.
        virtual void OnMOTDChanged(Guild* guild, std::string const& newMotd);
 
        // Called when the guild info is altered.
        virtual void OnInfoChanged(Guild* guild, std::string const& newInfo);
 
        // Called when a guild is created.
        virtual void OnCreate(Guild* guild, Player* leader, std::string const& name);
 
        // Called when a guild is disbanded.
        virtual void OnDisband(Guild* guild);
 
        // Called when a guild member withdraws money from a guild bank.
        virtual void OnMemberWitdrawMoney(Guild* guild, Player* player, uint32& amount, bool isRepair);
 
        // Called when a guild member deposits money in a guild bank.
        virtual void OnMemberDepositMoney(Guild* guild, Player* player, uint32& amount);
 
        // Called when a guild member moves an item in a guild bank.
        virtual void OnItemMove(Guild* guild, Player* player, Item* pItem, bool isSrcBank, uint8 srcContainer, uint8 srcSlotId,
            bool isDestBank, uint8 destContainer, uint8 destSlotId);
 
        virtual void OnEvent(Guild* guild, uint8 eventType, ObjectGuid::LowType playerGuid1, ObjectGuid::LowType playerGuid2, uint8 newRank);
 
        virtual void OnBankEvent(Guild* guild, uint8 eventType, uint8 tabId, ObjectGuid::LowType playerGuid, uint32 itemOrMoney, uint16 itemStackCount, uint8 destTabId);
};
 
class TC_GAME_API GroupScript : public ScriptObject
{
    protected:
 
        explicit GroupScript(char const* name);
 
    public:
 
        // Called when a member is added to a group.
        virtual void OnAddMember(Group* group, ObjectGuid guid);
 
        // Called when a member is invited to join a group.
        virtual void OnInviteMember(Group* group, ObjectGuid guid);
 
        // Called when a member is removed from a group.
        virtual void OnRemoveMember(Group* group, ObjectGuid guid, RemoveMethod method, ObjectGuid kicker, char const* reason);
 
        // Called when the leader of a group is changed.
        virtual void OnChangeLeader(Group* group, ObjectGuid newLeaderGuid, ObjectGuid oldLeaderGuid);
 
        // Called when a group is disbanded.
        virtual void OnDisband(Group* group);
};
 
// Manages registration, loading, and execution of scripts.
class TC_GAME_API ScriptMgr
{
    friend class ScriptObject;
 
    private:
        ScriptMgr();
        virtual ~ScriptMgr();
 
        void FillSpellSummary();
        void LoadDatabase();
 
        void IncreaseScriptCount() { ++_scriptCount; }
        void DecreaseScriptCount() { --_scriptCount; }
 
    public: /* Initialization */
        static ScriptMgr* instance();
 
        void Initialize();
 
        uint32 GetScriptCount() const { return _scriptCount; }
 
        typedef void(*ScriptLoaderCallbackType)();
 
        void SetScriptLoader(ScriptLoaderCallbackType script_loader_callback)
        {
            _script_loader_callback = script_loader_callback;
        }
 
    public: /* Script contexts */
        void SetScriptContext(std::string const& context);
        std::string const& GetCurrentScriptContext() const { return _currentContext; }
        void ReleaseScriptContext(std::string const& context);
        void SwapScriptContext(bool initialize = false);
 
        static std::string const& GetNameOfStaticContext();
 
        std::shared_ptr<ModuleReference> AcquireModuleReferenceOfScriptName(
            std::string const& scriptname) const;
 
    public: /* Unloading */
 
        void Unload();
 
    public: /* SpellScriptLoader */
 
        void CreateSpellScripts(uint32 spellId, std::vector<SpellScript*>& scriptVector, Spell* invoker) const;
        void CreateAuraScripts(uint32 spellId, std::vector<AuraScript*>& scriptVector, Aura* invoker) const;
        SpellScriptLoader* GetSpellScriptLoader(uint32 scriptId);
 
    public: /* ServerScript */
 
        void OnNetworkStart();
        void OnNetworkStop();
        void OnSocketOpen(std::shared_ptr<WorldSocket> const& socket);
        void OnSocketClose(std::shared_ptr<WorldSocket> const& socket);
        void OnPacketReceive(WorldSession* session, WorldPacket const& packet);
        void OnPacketSend(WorldSession* session, WorldPacket const& packet);
 
    public: /* WorldScript */
 
        void OnOpenStateChange(bool open);
        void OnConfigLoad(bool reload);
        void OnMotdChange(std::string& newMotd);
        void OnShutdownInitiate(ShutdownExitCode code, ShutdownMask mask);
        void OnShutdownCancel();
        void OnWorldUpdate(uint32 diff);
        void OnStartup();
        void OnShutdown();
 
    public: /* FormulaScript */
 
        void OnHonorCalculation(float& honor, uint8 level, float multiplier);
        void OnGrayLevelCalculation(uint8& grayLevel, uint8 playerLevel);
        void OnColorCodeCalculation(XPColorChar& color, uint8 playerLevel, uint8 mobLevel);
        void OnZeroDifferenceCalculation(uint8& diff, uint8 playerLevel);
        void OnBaseGainCalculation(uint32& gain, uint8 playerLevel, uint8 mobLevel, ContentLevels content);
        void OnGainCalculation(uint32& gain, Player* player, Unit* unit);
        void OnGroupRateCalculation(float& rate, uint32 count, bool isRaid);
 
    public: /* MapScript */
 
        void OnCreateMap(Map* map);
        void OnDestroyMap(Map* map);
        void OnLoadGridMap(Map* map, GridMap* gmap, uint32 gx, uint32 gy);
        void OnUnloadGridMap(Map* map, GridMap* gmap, uint32 gx, uint32 gy);
        void OnPlayerEnterMap(Map* map, Player* player);
        void OnPlayerLeaveMap(Map* map, Player* player);
        void OnMapUpdate(Map* map, uint32 diff);
 
    public: /* InstanceMapScript */
 
        InstanceScript* CreateInstanceData(InstanceMap* map);
 
    public: /* ItemScript */
 
        bool OnQuestAccept(Player* player, Item* item, Quest const* quest);
        bool OnItemUse(Player* player, Item* item, SpellCastTargets const& targets);
        bool OnItemExpire(Player* player, ItemTemplate const* proto);
        bool OnItemRemove(Player* player, Item* item);
        bool OnCastItemCombatSpell(Player* player, Unit* victim, SpellInfo const* spellInfo, Item* item);
 
    public: /* CreatureScript */
 
        CreatureAI* GetCreatureAI(Creature* creature);
 
    public: /* GameObjectScript */
 
        GameObjectAI* GetGameObjectAI(GameObject* go);
 
    public: /* AreaTriggerScript */
 
        bool OnAreaTrigger(Player* player, AreaTriggerEntry const* trigger);
 
    public: /* BattlefieldScript */
 
        Battlefield* CreateBattlefield(uint32 scriptId);
 
    public: /* BattlegroundScript */
 
        Battleground* CreateBattleground(BattlegroundTypeId typeId);
 
    public: /* OutdoorPvPScript */
 
        OutdoorPvP* CreateOutdoorPvP(uint32 scriptId);
 
    public: /* CommandScript */
 
        std::vector<Trinity::ChatCommands::ChatCommandBuilder> GetChatCommands();
 
    public: /* WeatherScript */
 
        void OnWeatherChange(Weather* weather, WeatherState state, float grade);
        void OnWeatherUpdate(Weather* weather, uint32 diff);
 
    public: /* AuctionHouseScript */
 
        void OnAuctionAdd(AuctionHouseObject* ah, AuctionEntry* entry);
        void OnAuctionRemove(AuctionHouseObject* ah, AuctionEntry* entry);
        void OnAuctionSuccessful(AuctionHouseObject* ah, AuctionEntry* entry);
        void OnAuctionExpire(AuctionHouseObject* ah, AuctionEntry* entry);
 
    public: /* ConditionScript */
 
        bool OnConditionCheck(Condition const* condition, ConditionSourceInfo& sourceInfo);
 
    public: /* VehicleScript */
 
        void OnInstall(Vehicle* veh);
        void OnUninstall(Vehicle* veh);
        void OnReset(Vehicle* veh);
        void OnInstallAccessory(Vehicle* veh, Creature* accessory);
        void OnAddPassenger(Vehicle* veh, Unit* passenger, int8 seatId);
        void OnRemovePassenger(Vehicle* veh, Unit* passenger);
 
    public: /* DynamicObjectScript */
 
        void OnDynamicObjectUpdate(DynamicObject* dynobj, uint32 diff);
 
    public: /* TransportScript */
 
        void OnAddPassenger(Transport* transport, Player* player);
        void OnAddCreaturePassenger(Transport* transport, Creature* creature);
        void OnRemovePassenger(Transport* transport, Player* player);
        void OnTransportUpdate(Transport* transport, uint32 diff);
        void OnRelocate(Transport* transport, uint32 waypointId, uint32 mapId, float x, float y, float z);
 
    public: /* AchievementCriteriaScript */
 
        bool OnCriteriaCheck(uint32 scriptId, Player* source, Unit* target);
 
    public: /* PlayerScript */
 
        void OnPVPKill(Player* killer, Player* killed);
        void OnCreatureKill(Player* killer, Creature* killed);
        void OnPlayerKilledByCreature(Creature* killer, Player* killed);
        void OnPlayerLevelChanged(Player* player, uint8 oldLevel);
        void OnPlayerFreeTalentPointsChanged(Player* player, uint32 newPoints);
        void OnPlayerTalentsReset(Player* player, bool involuntarily);
        void OnPlayerMoneyChanged(Player* player, int32& amount);
        void OnPlayerMoneyLimit(Player* player, int32 amount);
        void OnGivePlayerXP(Player* player, uint32& amount, Unit* victim);
        void OnPlayerReputationChange(Player* player, uint32 factionID, int32& standing, bool incremental);
        void OnPlayerDuelRequest(Player* target, Player* challenger);
        void OnPlayerDuelStart(Player* player1, Player* player2);
        void OnPlayerDuelEnd(Player* winner, Player* loser, DuelCompleteType type);
        void OnPlayerChat(Player* player, uint32 type, uint32 lang, std::string& msg);
        void OnPlayerChat(Player* player, uint32 type, uint32 lang, std::string& msg, Player* receiver);
        void OnPlayerChat(Player* player, uint32 type, uint32 lang, std::string& msg, Group* group);
        void OnPlayerChat(Player* player, uint32 type, uint32 lang, std::string& msg, Guild* guild);
        void OnPlayerChat(Player* player, uint32 type, uint32 lang, std::string& msg, Channel* channel);
        void OnPlayerEmote(Player* player, Emote emote);
        void OnPlayerTextEmote(Player* player, uint32 textEmote, uint32 emoteNum, ObjectGuid guid);
        void OnPlayerSpellCast(Player* player, Spell* spell, bool skipCheck);
        void OnPlayerLogin(Player* player, bool firstLogin);
        void OnPlayerLogout(Player* player);
        void OnPlayerCreate(Player* player);
        void OnPlayerDelete(ObjectGuid guid, uint32 accountId);
        void OnPlayerFailedDelete(ObjectGuid guid, uint32 accountId);
        void OnPlayerSave(Player* player);
        void OnPlayerBindToInstance(Player* player, Difficulty difficulty, uint32 mapid, bool permanent, uint8 extendState);
        void OnPlayerUpdateZone(Player* player, uint32 newZone, uint32 newArea);
        void OnQuestObjectiveProgress(Player* player, Quest const* quest, uint32 objectiveIndex, uint16 progress);
        void OnQuestStatusChange(Player* player, uint32 questId);
        void OnMovieComplete(Player* player, uint32 movieId);
        void OnPlayerRepop(Player* player);
 
    public: /* AccountScript */
 
        void OnAccountLogin(uint32 accountId);
        void OnFailedAccountLogin(uint32 accountId);
        void OnEmailChange(uint32 accountId);
        void OnFailedEmailChange(uint32 accountId);
        void OnPasswordChange(uint32 accountId);
        void OnFailedPasswordChange(uint32 accountId);
 
    public: /* GuildScript */
 
        void OnGuildAddMember(Guild* guild, Player* player, uint8& plRank);
        void OnGuildRemoveMember(Guild* guild, Player* player, bool isDisbanding, bool isKicked);
        void OnGuildMOTDChanged(Guild* guild, const std::string& newMotd);
        void OnGuildInfoChanged(Guild* guild, const std::string& newInfo);
        void OnGuildCreate(Guild* guild, Player* leader, const std::string& name);
        void OnGuildDisband(Guild* guild);
        void OnGuildMemberWitdrawMoney(Guild* guild, Player* player, uint32 &amount, bool isRepair);
        void OnGuildMemberDepositMoney(Guild* guild, Player* player, uint32 &amount);
        void OnGuildItemMove(Guild* guild, Player* player, Item* pItem, bool isSrcBank, uint8 srcContainer, uint8 srcSlotId,
            bool isDestBank, uint8 destContainer, uint8 destSlotId);
        void OnGuildEvent(Guild* guild, uint8 eventType, ObjectGuid::LowType playerGuid1, ObjectGuid::LowType playerGuid2, uint8 newRank);
        void OnGuildBankEvent(Guild* guild, uint8 eventType, uint8 tabId, ObjectGuid::LowType playerGuid, uint32 itemOrMoney, uint16 itemStackCount, uint8 destTabId);
 
    public: /* GroupScript */
 
        void OnGroupAddMember(Group* group, ObjectGuid guid);
        void OnGroupInviteMember(Group* group, ObjectGuid guid);
        void OnGroupRemoveMember(Group* group, ObjectGuid guid, RemoveMethod method, ObjectGuid kicker, char const* reason);
        void OnGroupChangeLeader(Group* group, ObjectGuid newLeaderGuid, ObjectGuid oldLeaderGuid);
        void OnGroupDisband(Group* group);
 
    public: /* UnitScript */
 
        void OnHeal(Unit* healer, Unit* reciever, uint32& gain);
        void OnDamage(Unit* attacker, Unit* victim, uint32& damage);
        void ModifyPeriodicDamageAurasTick(Unit* target, Unit* attacker, uint32& damage);
        void ModifyMeleeDamage(Unit* target, Unit* attacker, uint32& damage);
        void ModifySpellDamageTaken(Unit* target, Unit* attacker, int32& damage);
 
    private:
        uint32 _scriptCount;
 
        ScriptLoaderCallbackType _script_loader_callback;
 
        std::string _currentContext;
};
 
namespace Trinity::SpellScripts
{
    template<typename T>
    using is_SpellScript = std::is_base_of<SpellScript, T>;
 
    template<typename T>
    using is_AuraScript = std::is_base_of<AuraScript, T>;
}
 
template <typename... Ts>
class GenericSpellAndAuraScriptLoader : public SpellScriptLoader
{
    using SpellScriptType = typename Trinity::find_type_if_t<Trinity::SpellScripts::is_SpellScript, Ts...>;
    using AuraScriptType = typename Trinity::find_type_if_t<Trinity::SpellScripts::is_AuraScript, Ts...>;
    using ArgsType = typename Trinity::find_type_if_t<Trinity::is_tuple, Ts...>;
 
public:
    GenericSpellAndAuraScriptLoader(char const* name, ArgsType&& args) : SpellScriptLoader(name), _args(std::move(args)) { }
 
private:
    SpellScript* GetSpellScript() const override
    {
        if constexpr (!std::is_same_v<SpellScriptType, Trinity::find_type_end>)
            return Trinity::new_from_tuple<SpellScriptType>(_args);
        else
            return nullptr;
    }
 
    AuraScript* GetAuraScript() const override
    {
        if constexpr (!std::is_same_v<AuraScriptType, Trinity::find_type_end>)
            return Trinity::new_from_tuple<AuraScriptType>(_args);
        else
            return nullptr;
    }
 
    ArgsType _args;
};
 
#define RegisterSpellScriptWithArgs(spell_script, script_name, ...) new GenericSpellAndAuraScriptLoader<spell_script, decltype(std::make_tuple(__VA_ARGS__))>(script_name, std::make_tuple(__VA_ARGS__))
#define RegisterSpellScript(spell_script) RegisterSpellScriptWithArgs(spell_script, #spell_script)
#define RegisterSpellAndAuraScriptPairWithArgs(script_1, script_2, script_name, ...) new GenericSpellAndAuraScriptLoader<script_1, script_2, decltype(std::make_tuple(__VA_ARGS__))>(script_name, std::make_tuple(__VA_ARGS__))
#define RegisterSpellAndAuraScriptPair(script_1, script_2) RegisterSpellAndAuraScriptPairWithArgs(script_1, script_2, #script_1)
 
template <class AI>
class GenericCreatureScript : public CreatureScript
{
    public:
        GenericCreatureScript(char const* name) : CreatureScript(name) { }
        CreatureAI* GetAI(Creature* me) const override { return new AI(me); }
};
#define RegisterCreatureAI(ai_name) new GenericCreatureScript<ai_name>(#ai_name)
 
template <class AI, AI* (*AIFactory)(Creature*)>
class FactoryCreatureScript : public CreatureScript
{
    public:
        FactoryCreatureScript(char const* name) : CreatureScript(name) { }
        CreatureAI* GetAI(Creature* me) const override { return AIFactory(me); }
};
#define RegisterCreatureAIWithFactory(ai_name, factory_fn) new FactoryCreatureScript<ai_name, &factory_fn>(#ai_name)
 
template <class AI>
class GenericGameObjectScript : public GameObjectScript
{
    public:
        GenericGameObjectScript(char const* name) : GameObjectScript(name) { }
        GameObjectAI* GetAI(GameObject* go) const override { return new AI(go); }
};
#define RegisterGameObjectAI(ai_name) new GenericGameObjectScript<ai_name>(#ai_name)
 
template <class AI, AI* (*AIFactory)(GameObject*)>
class FactoryGameObjectScript : public GameObjectScript
{
    public:
        FactoryGameObjectScript(char const* name) : GameObjectScript(name) { }
        GameObjectAI* GetAI(GameObject* me) const override { return AIFactory(me); }
};
#define RegisterGameObjectAIWithFactory(ai_name, factory_fn) new FactoryGameObjectScript<ai_name, &factory_fn>(#ai_name)
 
#define sScriptMgr ScriptMgr::instance()
 
#endif