You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
openmw-tes3coop/apps/openmw-mp/Script/Functions/Actors.h

679 lines
23 KiB
C

#ifndef OPENMW_ACTORAPI_HPP
#define OPENMW_ACTORAPI_HPP
#include "../api.h"
NAMESPACE_BEGIN(ActorFunctions)
/**
* \brief Use the last actor list received by the server as the one being read.
*
* \return void
*/
API_FUNCTION void CDECL ReadReceivedActorList() NOEXCEPT;
/**
* \brief Use the temporary actor list stored for a cell as the one being read.
*
* This type of actor list is used to store actor positions and dynamic stats and is deleted
* when the cell is unloaded.
*
* \param cellDescription The description of the cell whose actor list should be read.
* \return void
*/
API_FUNCTION void CDECL ReadCellActorList(const char* cellDescription) NOEXCEPT;
/**
* \brief Clear the data from the actor list stored on the server.
*
* \return void
*/
API_FUNCTION void CDECL ClearActorList() NOEXCEPT;
/**
* \brief Set the pid attached to the ActorList.
*
* \param pid The player ID to whom the actor list should be attached.
* \return void
*/
API_FUNCTION void CDECL SetActorListPid(PlayerId pid) NOEXCEPT;
/**
* \brief Take the contents of the read-only actor list last received by the
* server from a player and move its contents to the stored object list
* that can be sent by the server.
*
* \return void
*/
API_FUNCTION void CDECL CopyReceivedActorListToStore() NOEXCEPT;
/**
* \brief Get the number of indexes in the read actor list.
*
* \return The number of indexes.
*/
API_FUNCTION unsigned int CDECL GetActorListSize() NOEXCEPT;
/**
* \brief Get the action type used in the read actor list.
*
* \return The action type (0 for SET, 1 for ADD, 2 for REMOVE, 3 for REQUEST).
*/
API_FUNCTION unsigned char CDECL GetActorListAction() NOEXCEPT;
/**
* \brief Get the cell description of the actor at a certain index in the read actor list.
*
* \param index The index of the actor.
* \return The cell description.
*/
API_FUNCTION const char *CDECL GetActorCell(unsigned int index) NOEXCEPT;
/**
* \brief Get the refId of the actor at a certain index in the read actor list.
*
* \param index The index of the actor.
* \return The refId.
*/
API_FUNCTION const char *CDECL GetActorRefId(unsigned int index) NOEXCEPT;
/**
* \brief Get the refNum of the actor at a certain index in the read actor list.
*
* \param index The index of the actor.
* \return The refNum.
*/
API_FUNCTION unsigned int CDECL GetActorRefNum(unsigned int index) NOEXCEPT;
/**
* \brief Get the mpNum of the actor at a certain index in the read actor list.
*
* \param index The index of the actor.
* \return The mpNum.
*/
API_FUNCTION unsigned int CDECL GetActorMpNum(unsigned int index) NOEXCEPT;
/**
* \brief Get the X position of the actor at a certain index in the read actor list.
*
* \param index The index of the actor.
* \return The X position.
*/
API_FUNCTION double CDECL GetActorPosX(unsigned int index) NOEXCEPT;
/**
* \brief Get the Y position of the actor at a certain index in the read actor list.
*
* \param index The index of the actor.
* \return The Y position.
*/
API_FUNCTION double CDECL GetActorPosY(unsigned int index) NOEXCEPT;
/**
* \brief Get the Z position of the actor at a certain index in the read actor list.
*
* \param index The index of the actor.
* \return The Z position.
*/
API_FUNCTION double CDECL GetActorPosZ(unsigned int index) NOEXCEPT;
/**
* \brief Get the X rotation of the actor at a certain index in the read actor list.
*
* \param index The index of the actor.
* \return The X rotation.
*/
API_FUNCTION double CDECL GetActorRotX(unsigned int index) NOEXCEPT;
/**
* \brief Get the Y rotation of the actor at a certain index in the read actor list.
*
* \param index The index of the actor.
* \return The Y rotation.
*/
API_FUNCTION double CDECL GetActorRotY(unsigned int index) NOEXCEPT;
/**
* \brief Get the Z rotation of the actor at a certain index in the read actor list.
*
* \param index The index of the actor.
* \return The Z rotation.
*/
API_FUNCTION double CDECL GetActorRotZ(unsigned int index) NOEXCEPT;
/**
* \brief Get the base health of the actor at a certain index in the read actor list.
*
* \param index The index of the actor.
* \return The base health.
*/
API_FUNCTION double CDECL GetActorHealthBase(unsigned int index) NOEXCEPT;
/**
* \brief Get the current health of the actor at a certain index in the read actor list.
*
* \param index The index of the actor.
* \return The current health.
*/
API_FUNCTION double CDECL GetActorHealthCurrent(unsigned int index) NOEXCEPT;
/**
* \brief Get the modified health of the actor at a certain index in the read actor list.
*
* \param index The index of the actor.
* \return The modified health.
*/
API_FUNCTION double CDECL GetActorHealthModified(unsigned int index) NOEXCEPT;
/**
* \brief Get the base magicka of the actor at a certain index in the read actor list.
*
* \param index The index of the actor.
* \return The base magicka.
*/
API_FUNCTION double CDECL GetActorMagickaBase(unsigned int index) NOEXCEPT;
/**
* \brief Get the current magicka of the actor at a certain index in the read actor list.
*
* \param index The index of the actor.
* \return The current magicka.
*/
API_FUNCTION double CDECL GetActorMagickaCurrent(unsigned int index) NOEXCEPT;
/**
* \brief Get the modified magicka of the actor at a certain index in the read actor list.
*
* \param index The index of the actor.
* \return The modified magicka.
*/
API_FUNCTION double CDECL GetActorMagickaModified(unsigned int index) NOEXCEPT;
/**
* \brief Get the base fatigue of the actor at a certain index in the read actor list.
*
* \param index The index of the actor.
* \return The base fatigue.
*/
API_FUNCTION double CDECL GetActorFatigueBase(unsigned int index) NOEXCEPT;
/**
* \brief Get the current fatigue of the actor at a certain index in the read actor list.
*
* \param index The index of the actor.
* \return The current fatigue.
*/
API_FUNCTION double CDECL GetActorFatigueCurrent(unsigned int index) NOEXCEPT;
/**
* \brief Get the modified fatigue of the actor at a certain index in the read actor list.
*
* \param index The index of the actor.
* \return The modified fatigue.
*/
API_FUNCTION double CDECL GetActorFatigueModified(unsigned int index) NOEXCEPT;
/**
* \brief Get the refId of the item in a certain slot of the equipment of the actor at a
* certain index in the read actor list.
*
* \param index The index of the actor.
* \param slot The slot of the equipment item.
* \return The refId.
*/
API_FUNCTION const char *CDECL GetActorEquipmentItemRefId(unsigned int index, unsigned short slot) NOEXCEPT;
/**
* \brief Get the count of the item in a certain slot of the equipment of the actor at a
* certain index in the read actor list.
*
* \param index The index of the actor.
* \param slot The slot of the equipment item.
* \return The item count.
*/
API_FUNCTION int CDECL GetActorEquipmentItemCount(unsigned int index, unsigned short slot) NOEXCEPT;
/**
* \brief Get the charge of the item in a certain slot of the equipment of the actor at a
* certain index in the read actor list.
*
* \param index The index of the actor.
* \param slot The slot of the equipment item.
* \return The charge.
*/
API_FUNCTION int CDECL GetActorEquipmentItemCharge(unsigned int index, unsigned short slot) NOEXCEPT;
/**
* \brief Get the enchantment charge of the item in a certain slot of the equipment of the actor at a
* certain index in the read actor list.
*
* \param index The index of the actor.
* \param slot The slot of the equipment item.
* \return The enchantment charge.
*/
API_FUNCTION double CDECL GetActorEquipmentItemEnchantmentCharge(unsigned int index, unsigned short slot) NOEXCEPT;
/**
* \brief Check whether the killer of the actor at a certain index in the read actor list is a player.
*
* \param index The index of the actor.
* \return Whether the actor was killed by a player.
*/
API_FUNCTION bool CDECL DoesActorHavePlayerKiller(unsigned int index) NOEXCEPT;
/**
* \brief Get the player ID of the killer of the actor at a certain index in the read actor list.
*
* \param index The index of the actor.
* \return The player ID of the killer.
*/
API_FUNCTION int CDECL GetActorKillerPid(unsigned int index) NOEXCEPT;
/**
* \brief Get the refId of the actor killer of the actor at a certain index in the read actor list.
*
* \param index The index of the actor.
* \return The refId of the killer.
*/
API_FUNCTION const char *CDECL GetActorKillerRefId(unsigned int index) NOEXCEPT;
/**
* \brief Get the refNum of the actor killer of the actor at a certain index in the read actor list.
*
* \param index The index of the actor.
* \return The refNum of the killer.
*/
API_FUNCTION unsigned int CDECL GetActorKillerRefNum(unsigned int index) NOEXCEPT;
/**
* \brief Get the mpNum of the actor killer of the actor at a certain index in the read actor list.
*
* \param index The index of the actor.
* \return The mpNum of the killer.
*/
API_FUNCTION unsigned int CDECL GetActorKillerMpNum(unsigned int index) NOEXCEPT;
/**
* \brief Get the name of the actor killer of the actor at a certain index in the read actor list.
*
* \param index The index of the actor.
* \return The name of the killer.
*/
API_FUNCTION const char *CDECL GetActorKillerName(unsigned int index) NOEXCEPT;
/**
* \brief Check whether there is any positional data for the actor at a certain index in
* the read actor list.
*
* This is only useful when reading the actor list data recorded for a particular cell.
*
* \param index The index of the actor.
* \return Whether the read actor list contains positional data.
*/
API_FUNCTION bool CDECL DoesActorHavePosition(unsigned int index) NOEXCEPT;
/**
* \brief Check whether there is any dynamic stats data for the actor at a certain index in
* the read actor list.
*
* This is only useful when reading the actor list data recorded for a particular cell.
*
* \param index The index of the actor.
* \return Whether the read actor list contains dynamic stats data.
*/
API_FUNCTION bool CDECL DoesActorHaveStatsDynamic(unsigned int index) NOEXCEPT;
/**
* \brief Set the cell of the temporary actor list stored on the server.
*
* The cell is determined to be an exterior cell if it fits the pattern of a number followed
* by a comma followed by another number.
*
* \param cellDescription The description of the cell.
* \return void
*/
API_FUNCTION void CDECL SetActorListCell(const char* cellDescription) NOEXCEPT;
/**
* \brief Set the action type of the temporary actor list stored on the server.
*
* \param action The action type (0 for SET, 1 for ADD, 2 for REMOVE, 3 for REQUEST).
* \return void
*/
API_FUNCTION void CDECL SetActorListAction(unsigned char action) NOEXCEPT;
/**
* \brief Set the cell of the temporary actor stored on the server.
*
* Used for ActorCellChange packets, where a specific actor's cell now differs from that of the
* actor list.
*
* The cell is determined to be an exterior cell if it fits the pattern of a number followed
* by a comma followed by another number.
*
* \param cellDescription The description of the cell.
* \return void
*/
API_FUNCTION void CDECL SetActorCell(const char* cellDescription) NOEXCEPT;
/**
* \brief Set the refId of the temporary actor stored on the server.
*
* \param refId The refId.
* \return void
*/
API_FUNCTION void CDECL SetActorRefId(const char* refId) NOEXCEPT;
/**
* \brief Set the refNum of the temporary actor stored on the server.
*
* \param refNum The refNum.
* \return void
*/
API_FUNCTION void CDECL SetActorRefNum(int refNum) NOEXCEPT;
/**
* \brief Set the mpNum of the temporary actor stored on the server.
*
* \param mpNum The mpNum.
* \return void
*/
API_FUNCTION void CDECL SetActorMpNum(int mpNum) NOEXCEPT;
/**
* \brief Set the position of the temporary actor stored on the server.
*
* \param x The X position.
* \param y The Y position.
* \param z The Z position.
* \return void
*/
API_FUNCTION void CDECL SetActorPosition(double x, double y, double z) NOEXCEPT;
/**
* \brief Set the rotation of the temporary actor stored on the server.
*
* \param x The X rotation.
* \param y The Y rotation.
* \param z The Z rotation.
* \return void
*/
API_FUNCTION void CDECL SetActorRotation(double x, double y, double z) NOEXCEPT;
/**
* \brief Set the base health of the temporary actor stored on the server.
*
* \param value The new value.
* \return void
*/
API_FUNCTION void CDECL SetActorHealthBase(double value) NOEXCEPT;
/**
* \brief Set the current health of the temporary actor stored on the server.
*
* \param value The new value.
* \return void
*/
API_FUNCTION void CDECL SetActorHealthCurrent(double value) NOEXCEPT;
/**
* \brief Set the modified health of the temporary actor stored on the server.
*
* \param value The new value.
* \return void
*/
API_FUNCTION void CDECL SetActorHealthModified(double value) NOEXCEPT;
/**
* \brief Set the base magicka of the temporary actor stored on the server.
*
* \param value The new value.
* \return void
*/
API_FUNCTION void CDECL SetActorMagickaBase(double value) NOEXCEPT;
/**
* \brief Set the current magicka of the temporary actor stored on the server.
*
* \param value The new value.
* \return void
*/
API_FUNCTION void CDECL SetActorMagickaCurrent(double value) NOEXCEPT;
/**
* \brief Set the modified magicka of the temporary actor stored on the server.
*
* \param value The new value.
* \return void
*/
API_FUNCTION void CDECL SetActorMagickaModified(double value) NOEXCEPT;
/**
* \brief Set the base fatigue of the temporary actor stored on the server.
*
* \param value The new value.
* \return void
*/
API_FUNCTION void CDECL SetActorFatigueBase(double value) NOEXCEPT;
/**
* \brief Set the current fatigue of the temporary actor stored on the server.
*
* \param value The new value.
* \return void
*/
API_FUNCTION void CDECL SetActorFatigueCurrent(double value) NOEXCEPT;
/**
* \brief Set the modified fatigue of the temporary actor stored on the server.
*
* \param value The new value.
* \return void
*/
API_FUNCTION void CDECL SetActorFatigueModified(double value) NOEXCEPT;
/**
* \brief Set the sound of the temporary actor stored on the server.
*
* \param sound The sound.
* \return void
*/
API_FUNCTION void CDECL SetActorSound(const char* sound) NOEXCEPT;
/**
* \brief Set the AI action of the temporary actor stored on the server.
*
* \param action The new action.
* \return void
*/
API_FUNCTION void CDECL SetActorAIAction(unsigned int action) NOEXCEPT;
/**
* \brief Set a player as the AI target of the temporary actor stored on the server.
*
* \param pid The player ID.
* \return void
*/
API_FUNCTION void CDECL SetActorAITargetToPlayer(PlayerId pid) NOEXCEPT;
/**
* \brief Set another object as the AI target of the temporary actor stored on the server.
*
* \param refNum The refNum of the target object.
* \param mpNum The mpNum of the target object.
* \return void
*/
API_FUNCTION void CDECL SetActorAITargetToObject(int refNum, int mpNum) NOEXCEPT;
/**
* \brief Set the coordinates for the AI package associated with the current AI action.
*
* \param x The X coordinate.
* \param y The Y coordinate.
* \param z The Z coordinate.
* \return void
*/
API_FUNCTION void CDECL SetActorAICoordinates(double x, double y, double z) NOEXCEPT;
/**
* \brief Set the distance of the AI package associated with the current AI action.
*
* \param duration The distance of the package.
* \return void
*/
API_FUNCTION void CDECL SetActorAIDistance(unsigned int distance) NOEXCEPT;
/**
* \brief Set the duration of the AI package associated with the current AI action.
*
* \param duration The duration of the package.
* \return void
*/
API_FUNCTION void CDECL SetActorAIDuration(unsigned int duration) NOEXCEPT;
/**
* \brief Set whether the current AI package should be repeated.
*
* Note: This only has an effect on the WANDER package.
*
* \param shouldRepeat Whether the package should be repeated.
* \return void
*/
API_FUNCTION void CDECL SetActorAIRepetition(bool shouldRepeat) NOEXCEPT;
/**
* \brief Equip an item in a certain slot of the equipment of the temporary actor stored
* on the server.
*
* \param slot The equipment slot.
* \param refId The refId of the item.
* \param count The count of the item.
* \param charge The charge of the item.
* \param enchantmentCharge The enchantment charge of the item.
* \return void
*/
API_FUNCTION void CDECL EquipActorItem(unsigned short slot, const char* refId, unsigned int count, int charge, double enchantmentCharge = -1) NOEXCEPT;
/**
* \brief Unequip the item in a certain slot of the equipment of the temporary actor stored
* on the server.
*
* \param slot The equipment slot.
* \return void
*/
API_FUNCTION void CDECL UnequipActorItem(unsigned short slot) NOEXCEPT;
/**
* \brief Add a copy of the server's temporary actor to the server's temporary actor list.
*
* In the process, the server's temporary actor will automatically be cleared so a new
* one can be set up.
*
* \return void
*/
API_FUNCTION void CDECL AddActor() NOEXCEPT;
/**
* \brief Send an ActorList packet.
*
* It is sent only to the player for whom the current actor list was initialized.
*
* \return void
*/
API_FUNCTION void CDECL SendActorList() NOEXCEPT;
/**
* \brief Send an ActorAuthority packet.
*
* The player for whom the current actor list was initialized is recorded in the server memory
* as the new actor authority for the actor list's cell.
*
* The packet is sent to that player as well as all other players who have the cell loaded.
*
* \return void
*/
API_FUNCTION void CDECL SendActorAuthority() NOEXCEPT;
/**
* \brief Send an ActorPosition packet.
*
* \param sendToOtherVisitors Whether this packet should be sent to cell visitors other
* than the player attached to the packet (false by default).
* \param skipAttachedPlayer Whether the packet should skip being sent to the player attached
* to the packet (false by default).
*
* \return void
*/
API_FUNCTION void CDECL SendActorPosition(bool sendToOtherVisitors, bool skipAttachedPlayer) NOEXCEPT;
/**
* \brief Send an ActorStatsDynamic packet.
*
* \param sendToOtherVisitors Whether this packet should be sent to cell visitors other
* than the player attached to the packet (false by default).
* \param skipAttachedPlayer Whether the packet should skip being sent to the player attached
* to the packet (false by default).
*
* \return void
*/
API_FUNCTION void CDECL SendActorStatsDynamic(bool sendToOtherVisitors, bool skipAttachedPlayer) NOEXCEPT;
/**
* \brief Send an ActorEquipment packet.
*
* \param sendToOtherVisitors Whether this packet should be sent to cell visitors other
* than the player attached to the packet (false by default).
* \param skipAttachedPlayer Whether the packet should skip being sent to the player attached
* to the packet (false by default).
*
* \return void
*/
API_FUNCTION void CDECL SendActorEquipment(bool sendToOtherVisitors, bool skipAttachedPlayer) NOEXCEPT;
/**
* \brief Send an ActorSpeech packet.
*
* \param sendToOtherVisitors Whether this packet should be sent to cell visitors other
* than the player attached to the packet (false by default).
* \param skipAttachedPlayer Whether the packet should skip being sent to the player attached
* to the packet (false by default).
* \return void
*/
API_FUNCTION void CDECL SendActorSpeech(bool sendToOtherVisitors, bool skipAttachedPlayer) NOEXCEPT;
/**
* \brief Send an ActorAI packet.
*
* \param sendToOtherVisitors Whether this packet should be sent to cell visitors other
* than the player attached to the packet (false by default).
* \param skipAttachedPlayer Whether the packet should skip being sent to the player attached
* to the packet (false by default).
* \return void
*/
API_FUNCTION void CDECL SendActorAI(bool sendToOtherVisitors, bool skipAttachedPlayer) NOEXCEPT;
/**
* \brief Send an ActorCellChange packet.
*
* \param sendToOtherVisitors Whether this packet should be sent to cell visitors other
* than the player attached to the packet (false by default).
* \param skipAttachedPlayer Whether the packet should skip being sent to the player attached
* to the packet (false by default).
*
* \return void
*/
API_FUNCTION void CDECL SendActorCellChange(bool sendToOtherVisitors, bool skipAttachedPlayer) NOEXCEPT;
// All methods below are deprecated versions of methods from above
API_FUNCTION void CDECL ReadLastActorList() NOEXCEPT;
API_FUNCTION void CDECL InitializeActorList(PlayerId pid) NOEXCEPT;
API_FUNCTION void CDECL CopyLastActorListToStore() NOEXCEPT;
API_FUNCTION unsigned int CDECL GetActorRefNumIndex(unsigned int index) NOEXCEPT;
API_FUNCTION unsigned int CDECL GetActorKillerRefNumIndex(unsigned int index) NOEXCEPT;
API_FUNCTION void CDECL SetActorRefNumIndex(int refNum) NOEXCEPT;
NAMESPACE_END()
#endif //OPENMW_ACTORAPI_HPP