mirror of
https://github.com/DarkflameUniverse/DarkflameServer.git
synced 2024-12-26 23:43:34 +00:00
367 lines
12 KiB
C++
367 lines
12 KiB
C++
#pragma once
|
|
|
|
#include <cstdint>
|
|
#include <string>
|
|
#include <vector>
|
|
|
|
class User;
|
|
class Entity;
|
|
class NiPoint3;
|
|
enum class eMissionState : int32_t;
|
|
enum class ePetTamingNotifyType : uint32_t;
|
|
enum class eQuickBuildState : uint32_t;
|
|
|
|
namespace CppScripts {
|
|
/**
|
|
* Base class for all scripts. Includes virtual methods to be overridden to handle LUA equivelent events.
|
|
*
|
|
* All methods pass 'self' as the first parameter, this is the associated parent entity for the event.
|
|
* There will only ever be one instance of each script.
|
|
*
|
|
* Do not use class members as entity specific variables unless you're sure there will only event be one instance of this script.
|
|
* Do use class members as script wide variables, variables all entities which this script will access.
|
|
*
|
|
* Use self->GetVar<type_t>(u"variable_name") and self->SetVar<type_t>(u"variable_name", value) to manage variables.
|
|
*
|
|
* Designed to yield as close to a 1:1 mapping as possible with LUA.
|
|
* There will be events which are not implemented or inheritetly LUA features not easily translated to C++.
|
|
* Most of the time these can be worked around or ignored.
|
|
*/
|
|
class Script {
|
|
public:
|
|
/**
|
|
* Invoked one frame after the script is loaded.
|
|
*
|
|
* Equivalent to 'function onStartup(self)'
|
|
*/
|
|
virtual void OnStartup(Entity* self) {};
|
|
|
|
/**
|
|
* Invoked upon an entity entering the phantom collider on self.
|
|
*
|
|
* Equivalent to 'function onCollisionPhantom(self, msg)'
|
|
*/
|
|
virtual void OnCollisionPhantom(Entity* self, Entity* target) {};
|
|
|
|
/**
|
|
* Invoked upon an entity leaving the phantom collider on self.
|
|
*
|
|
* Equivalent to 'function onOffCollisionPhantom(self, msg)'
|
|
*/
|
|
virtual void OnOffCollisionPhantom(Entity* self, Entity* target) {};
|
|
|
|
/**
|
|
* Invoked when a player accepted a mission.
|
|
*
|
|
* Equivalent to 'function onMissionDialogueOK(self, msg)'
|
|
*/
|
|
virtual void OnMissionDialogueOK(Entity* self, Entity* target, int missionID, eMissionState missionState) {};
|
|
|
|
/**
|
|
* Invoked when the client or the server invoked an event server-side.
|
|
*
|
|
* Equivalent to 'function onFireEventServerSide(self, msg)'
|
|
*/
|
|
virtual void OnFireEventServerSide(Entity* self, Entity* sender, std::string args, int32_t param1, int32_t param2, int32_t param3) {};
|
|
|
|
/**
|
|
* Invoked upon sending a object notification.
|
|
*
|
|
* Equivalent to 'function onNotifyObject(self, msg)'
|
|
*/
|
|
virtual void OnNotifyObject(Entity* self, Entity* sender, const std::string& name, int32_t param1 = 0, int32_t param2 = 0) {};
|
|
|
|
/**
|
|
* Invoked upon a player exiting the modular build minigame.
|
|
*
|
|
* Equivalent to 'function onModularBuildExit(self, msg)'
|
|
*/
|
|
virtual void OnModularBuildExit(Entity* self, Entity* player, bool bCompleted, std::vector<LOT> modules) {};
|
|
|
|
/**
|
|
* Invoked when a player has loaded into the zone.
|
|
*
|
|
* Equivalent to 'function onPlayerLoaded(self, msg)'
|
|
*/
|
|
virtual void OnPlayerLoaded(Entity* self, Entity* player) {};
|
|
|
|
/**
|
|
* Invoked when a player has died.
|
|
*
|
|
* Equivalent to 'function onPlayerDied(self, msg)'
|
|
*/
|
|
virtual void OnPlayerDied(Entity* self, Entity* player) {};
|
|
|
|
/**
|
|
* Invoked when a player has resurrected.
|
|
*
|
|
* Equivalent to 'function onPlayerResurrected(self, msg)'
|
|
*/
|
|
virtual void OnPlayerResurrected(Entity* self, Entity* player) {};
|
|
|
|
/**
|
|
* Invoked when a player has left the zone.
|
|
*
|
|
* Equivalent to 'function onPlayerExit(self, msg)'
|
|
*/
|
|
virtual void OnPlayerExit(Entity* self, Entity* player) {};
|
|
|
|
/**
|
|
* Invoked when a player has interacted with the proximity collider on self.
|
|
*
|
|
* Equivalent to 'function onProximityUpdate(self, msg)'
|
|
*
|
|
* @param name The name of the proximity collider recviving an interaction.
|
|
* @param status "ENTER" if a player has entered the proximity collider; "LEAVE" if a player has left the proximity collider
|
|
*/
|
|
virtual void OnProximityUpdate(Entity* self, Entity* entering, std::string name, std::string status) {};
|
|
|
|
/**
|
|
* Invoked when a timer on self has expired.
|
|
*
|
|
* Equivalent to 'function onTimerDone(self, msg)'
|
|
*/
|
|
virtual void OnTimerDone(Entity* self, std::string timerName) {};
|
|
|
|
/**
|
|
* Invoked when a player interactions with self.
|
|
*
|
|
* Equivalent to 'function onUse(self, msg)'
|
|
*/
|
|
virtual void OnUse(Entity* self, Entity* user) {};
|
|
|
|
/**
|
|
* Invoked when self has died.
|
|
*
|
|
* Equivalent to 'function onDie(self, msg)'
|
|
*/
|
|
virtual void OnDie(Entity* self, Entity* killer) {};
|
|
|
|
/**
|
|
* Invoked when self has received a hit.
|
|
*
|
|
* Equivalent to 'function onHit(self, msg)'
|
|
*/
|
|
virtual void OnHit(Entity* self, Entity* attacker) {};
|
|
|
|
/**
|
|
* Invoked when self has received an emote from a player.
|
|
*
|
|
* Equivalent to 'function onEmoteReceived(self, msg)'
|
|
*/
|
|
virtual void OnEmoteReceived(Entity* self, int32_t emote, Entity* target) {};
|
|
|
|
/**
|
|
* Invoked when a player has started building this quickbuild.
|
|
*
|
|
* Equivalent to 'function onQuickBuildStart(self, msg)'
|
|
*/
|
|
virtual void OnQuickBuildStart(Entity* self, Entity* target) {};
|
|
|
|
/**
|
|
* Invoked when this quickbuild has changed state.
|
|
*
|
|
* Equivalent to 'function onQuickBuildNotifyState(self, msg)'
|
|
*/
|
|
virtual void OnQuickBuildNotifyState(Entity* self, eQuickBuildState state) {};
|
|
|
|
/**
|
|
* Invoked when this quickbuild has been completed.
|
|
*
|
|
* Equivalent to 'function OnQuickBuildComplete(self, msg)'
|
|
*/
|
|
virtual void OnQuickBuildComplete(Entity* self, Entity* target) {};
|
|
|
|
/**
|
|
* Invoked when self has received either a hit or heal.
|
|
*
|
|
* Equivalent to 'function onHitOrHealResult(self, msg)'
|
|
*/
|
|
virtual void OnHitOrHealResult(Entity* self, Entity* attacker, int32_t damage) {};
|
|
|
|
/**
|
|
* Invoked when self has received either a hit or heal. Only used for scripts subscribed to an entity.
|
|
*
|
|
* Equivalent to 'function notifyHitOrHealResult(self, msg)'
|
|
*/
|
|
virtual void NotifyHitOrHealResult(Entity* self, Entity* attacker, int32_t damage) {};
|
|
|
|
/**
|
|
* Invoked when a player has responsed to a mission.
|
|
*
|
|
* Equivalent to 'function onRespondToMission(self, msg)'
|
|
*/
|
|
virtual void OnRespondToMission(Entity* self, int missionID, Entity* player, int reward) {};
|
|
|
|
/**
|
|
* Invoked once per frame.
|
|
*
|
|
* No LUA eqivalent.
|
|
*/
|
|
virtual void OnUpdate(Entity* self) {};
|
|
|
|
/**
|
|
* Invoked when this property has been rented.
|
|
*
|
|
* Equivalent to 'function onZonePropertyRented(self, msg)'
|
|
*/
|
|
virtual void OnZonePropertyRented(Entity* self, Entity* renter) {};
|
|
|
|
/**
|
|
* Invoked when a player has begun to edit this property.
|
|
*
|
|
* Equivalent to 'function onZonePropertyEditBegin(self, msg)'
|
|
*/
|
|
virtual void OnZonePropertyEditBegin(Entity* self) {};
|
|
|
|
/**
|
|
* Invoked when a player has concluded editing this property.
|
|
*
|
|
* Equivalent to 'function onZonePropertyEditEnd(self, msg)'
|
|
*/
|
|
virtual void OnZonePropertyEditEnd(Entity* self) {};
|
|
|
|
/**
|
|
* Invoked when a player has equipped a model while editing this property.
|
|
*
|
|
* Equivalent to 'function onZonePropertyModelEquipped(self, msg)'
|
|
*/
|
|
virtual void OnZonePropertyModelEquipped(Entity* self) {};
|
|
|
|
/**
|
|
* Invoked when a player has placed a model while editing this property.
|
|
*
|
|
* Equivalent to 'function onZonePropertyModelPlaced(self, msg)'
|
|
*/
|
|
virtual void OnZonePropertyModelPlaced(Entity* self, Entity* player) {};
|
|
|
|
/**
|
|
* Invoked when a player has picked up a model while editing this property.
|
|
*
|
|
* Equivalent to 'function onZonePropertyModelPickedUp(self, msg)'
|
|
*/
|
|
virtual void OnZonePropertyModelPickedUp(Entity* self, Entity* player) {};
|
|
|
|
/**
|
|
* Invoked when a player removed a model while editing this property.
|
|
*
|
|
* Equivalent to 'function onZonePropertyModelRemoved(self, msg)'
|
|
*/
|
|
virtual void OnZonePropertyModelRemoved(Entity* self, Entity* player) {};
|
|
|
|
/**
|
|
* Invoked when a player removed a model while holding it when editing this property.
|
|
*
|
|
* Equivalent to 'function onZonePropertyModelRemoved(self, msg)'
|
|
*/
|
|
virtual void OnZonePropertyModelRemovedWhileEquipped(Entity* self, Entity* player) {};
|
|
|
|
/**
|
|
* Invoked when a player rotated a model while editing this property.
|
|
*
|
|
* Equivalent to 'function onZonePropertyModelRotated(self, msg)'
|
|
*/
|
|
virtual void OnZonePropertyModelRotated(Entity* self, Entity* player) {};
|
|
|
|
/**
|
|
* Invoked when the pet taming minigame encounted an event.
|
|
*
|
|
* Equivalent to 'function onNotifyPetTamingMinigame(self, msg)'
|
|
*/
|
|
virtual void OnNotifyPetTamingMinigame(Entity* self, Entity* tamer, ePetTamingNotifyType type) {};
|
|
|
|
/**
|
|
* Invoked when a player responded to a message box.
|
|
*
|
|
* Equivalent to 'function onMessageBoxResponse(self, msg)'
|
|
*/
|
|
virtual void OnMessageBoxResponse(Entity* self, Entity* sender, int32_t button, const std::u16string& identifier, const std::u16string& userData) {};
|
|
|
|
/**
|
|
* Invoked when a player responded to a choice box.
|
|
*
|
|
* Equivalent to 'function onChoiceBoxResponse(self, msg)'
|
|
*/
|
|
virtual void OnChoiceBoxResponse(Entity* self, Entity* sender, int32_t button, const std::u16string& buttonIdentifier, const std::u16string& identifier) {};
|
|
|
|
/**
|
|
* Invoked when self arrived at a moving platform waypoint.
|
|
*
|
|
* Equivalent to 'function onWaypointReached(self, msg)'
|
|
*/
|
|
virtual void OnWaypointReached(Entity* self, uint32_t waypointIndex) {};
|
|
|
|
/**
|
|
* Invoked when a player fired a skill event on self.
|
|
*
|
|
* Equivalent to 'function onSkillEventFired(self, msg)'
|
|
*/
|
|
virtual void OnSkillEventFired(Entity* self, Entity* caster, const std::string& message) {};
|
|
|
|
/**
|
|
* Invoked when self casted a skill.
|
|
*
|
|
* Equivalent to 'function onSkillCast(self, msg)'
|
|
*/
|
|
virtual void OnSkillCast(Entity* self, uint32_t skillID) {};
|
|
|
|
/**
|
|
* Invoked when a player on a rail reaches a waypoint
|
|
* Equivalent to: 'onPlayerRailArrivedNotification(self, msg)'
|
|
* @param self the parent of the script
|
|
* @param sender the entity that sent the event
|
|
* @param pathName the name of the path the entity was on
|
|
* @param waypoint the waypoint number of the path the entity was on
|
|
*/
|
|
virtual void OnPlayerRailArrived(Entity* self, Entity* sender, const std::u16string& pathName, int32_t waypoint) {};
|
|
|
|
/**
|
|
* Used by legacy minigames to indicate something has changed about the activity
|
|
* @param self the entity the script belongs to
|
|
* @param senderID the sender of the message
|
|
* @param value1 some value to represent the change
|
|
* @param value2 some other value to represent the change
|
|
* @param stringValue some string value to represent the change
|
|
*/
|
|
virtual void OnActivityStateChangeRequest(Entity* self, const LWOOBJID senderID, const int32_t value1,
|
|
const int32_t value2, const std::u16string& stringValue) {
|
|
};
|
|
|
|
virtual void OnCinematicUpdate(Entity* self, Entity* sender, eCinematicEvent event, const std::u16string& pathName,
|
|
float_t pathTime, float_t totalTime, int32_t waypoint) {
|
|
};
|
|
|
|
/**
|
|
* Used by items to tell their owner that they were equipped.
|
|
*
|
|
* @param itemOwner The owner of the item
|
|
* @param itemObjId The items Object ID
|
|
*/
|
|
virtual void OnFactionTriggerItemEquipped(Entity* itemOwner, LWOOBJID itemObjId) {};
|
|
|
|
/**
|
|
* Used by items to tell their owner that they were unequipped.
|
|
*
|
|
* @param itemOwner The owner of the item
|
|
* @param itemObjId The items Object ID
|
|
*/
|
|
virtual void OnFactionTriggerItemUnequipped(Entity* itemOwner, LWOOBJID itemObjId) {};
|
|
|
|
/**
|
|
* Handles exiting a scripted activity
|
|
*
|
|
* @param sender
|
|
* @param player the player to remove
|
|
* @param canceled if it was done via the cancel button
|
|
*/
|
|
virtual void OnRequestActivityExit(Entity* sender, LWOOBJID player, bool canceled){};
|
|
};
|
|
|
|
Script* const GetScript(Entity* parent, const std::string& scriptName);
|
|
|
|
// Get the invalid script. Would be a static variable of the namespace, but that would be
|
|
// more cluttery to use. Also this allows us to control where this invalid script is defined and initialized
|
|
// since we dont want anyone externally modifying it.
|
|
Script* const GetInvalidScript();
|
|
};
|