ArcDPS.h

#ifndef ARCDPS_H
#define ARCDPS_H

#include <stdint.h>
#include <windows.h>

#ifdef __cplusplus
namespace ArcDPS
{
#endif 
	/* arcdps export table */
	typedef struct Exports
	{
		uintptr_t   Size;         /* sizeof(arcdps_exports) */
		uint32_t    Signature;    /* pick a number between 0 and uint32 max that is not used by any other some_module */
		uint32_t    ImGuiVersion; /* IMGUI_VERSION_NUM */
		const char* Name;         /* "your module name", name string shown in options */
		const char* Build;        /* "1.2.40", version string */
		
		void* WndProc; // UINT fn(HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam)
		//     return value is assigned to real uMsg.
		//     unfiltered window event messages.
		
		void* CombatSquadCallback; // void fn(cbtevent* ev, ag* src, ag* dst, const char* skillname, uint64_t id, uint64_t revision)
		//     called asynchronously.
		//     ev parameter is cbtevent as in evtc documentation.
		//     ev may be null. if so, if src->elite == 1, then src->id is the id of the new targeted agent.
		//                             else, if src->prof, src->id was added
		//                                                       src->name = char name
		//                                                       dst->name = acc names
		//                                                       src->id = id
		//                                                       dst->id = instance id on map
		//                                                       dst->prof = prof
		//                                                       dst->elite = elite spec
		//                                                       dst->self = is self
		//                                                       src->team = team id
		//                                                       dst->team = subgroup
		//                                   else, src->id was removed
		//     use id parameter to re-establish order of events (if id == 0, consider the event unordered).
		//     due to unforseen circumstances after a change in assigning id, the first event will always have id == 2.
		//     refer to ag typedef for src and dst parameters.
		//     revision is cbtevent type revision, will most likely be 1.
		
		void* ImGuiRenderCallback; // void fn(uint32_t not_charsel_or_loading, uint32_t hide_if_combat_or_ooc)
		//     called before ImGui::Render.
		//     not_charsel_or_loading and hide_if_combat_or_ooc may be used to match arcdps window visibility.
		
		void* ImGuiOptions; // void fn()
		//     called when drawing module's options tab.
		
		void* CombatLocalCallback; // void fn(cbtevent* ev, ag* src, ag* dst, char* skillname, uint64_t id, uint64_t revision)
		//     same as combat, but for chatbox events.
		
		void* WndProcFiltered; // UINT fn(HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam)
		//     return value is assigned to real uMsg.
		//     modifiers-filtered window event messages.
		
		void* ImGuiWindows; // void fn(char* windowname)
		//     called during options window list, before the checkbox of 'window' is drawn.
	} PluginInfo;

	/* combat event - see evtc docs for details, revision param in combat cb is equivalent of revision byte header */
	struct CombatEvent
	{
		uint64_t Time;
		uint64_t SourceAgent;
		uint64_t DestinationAgent;
		int32_t  Value;
		int32_t  BuffDamage;
		uint32_t OverstackValue;
		uint32_t SkillID;
		uint16_t SourceInstanceID;
		uint16_t DestinationInstanceID;
		uint16_t SrcMasterInstanceID;
		uint16_t DestinationMasterInstanceID;
		uint8_t  IFF;
		uint8_t  Buff;
		uint8_t  Result;
		uint8_t  IsActivation;
		uint8_t  IsBuffRemove;
		uint8_t  IsNinety;
		uint8_t  IsFifty;
		uint8_t  IsMoving;
		uint8_t  IsStatechange;
		uint8_t  IsFlanking;
		uint8_t  IsShields;
		uint8_t  IsOffcycle;
		uint8_t  PAD61;
		uint8_t  PAD62;
		uint8_t  PAD63;
		uint8_t  PAD64;
	};

	/* agent short */
	struct AgentShort
	{
		char*     Name;           /* agent name. may be null. valid only at time of event. utf8 */
		uintptr_t ID;             /* agent unique identifier */
		uint32_t  Profession;     /* profession at time of event. refer to evtc notes for identification */
		uint32_t  Specialization; /* elite spec at time of event. refer to evtc notes for identification */
		uint32_t  IsSelf;         /* 1 if self, 0 if not */
		uint16_t  Team;           /* sep21+ */
	};

	enum ECombatStateChange
	{
		CBTS_NONE, // not used - not this kind of event
		// not used - not this kind of event

		CBTS_ENTERCOMBAT, // agent entered combat
		// src_agent: relates to agent
		// dst_agent: subgroup
		// value: prof id
		// buff_dmg: elite spec id
		// evtc: limited to squad outside instances
		// realtime: limited to squad

		CBTS_EXITCOMBAT, // agent left combat
		// src_agent: relates to agent
		// evtc: limited to squad outside instances
		// realtime: limited to squad

		CBTS_CHANGEUP, // agent is alive at time of event
		// src_agent: relates to agent
		// evtc: limited to agent table outside instances
		// realtime: limited to squad

		CBTS_CHANGEDEAD, // agent is dead at time of event
		// src_agent: relates to agent
		// evtc: limited to agent table outside instances
		// realtime: limited to squad

		CBTS_CHANGEDOWN, // agent is down at time of event
		// src_agent: relates to agent
		// evtc: limited to agent table outside instances
		// realtime: limited to squad

		CBTS_SPAWN, // agent entered tracking
		// src_agent: relates to agent
		// evtc: limited to agent table outside instances
		// realtime: no

		CBTS_DESPAWN, // agent left tracking
		// src_agent: relates to agent
		// evtc: limited to agent table outside instances
		// realtime: no

		CBTS_HEALTHPCTUPDATE, // agent health percentage changed
		// src_agent: relates to agent
		// dst_agent: percent * 10000 eg. 99.5% will be 9950
		// evtc: limited to agent table outside instances
		// realtime: no

		CBTS_SQCOMBATSTART, // squad combat start, first player enter combat. previously named log start
		// value: as uint32_t, server unix timestamp
		// buff_dmg: local unix timestamp
		// evtc: yes
		// realtime: yes

		CBTS_LOGEND, // squad combat stop, last player left combat. previously named log end
		// value: as uint32_t, server unix timestamp
		// buff_dmg: local unix timestamp
		// evtc: yes
		// realtime: yes

		CBTS_WEAPSWAP, // agent weapon set changed
		// src_agent: relates to agent
		// dst_agent: new weapon set id
		// value: old weapon seet id
		// evtc: yes
		// realtime: yes

		CBTS_MAXHEALTHUPDATE, // agent maximum health changed
		// src_agent: relates to agent
		// dst_agent: new max health
		// evtc: limited to non-players
		// realtime: no

		CBTS_POINTOFVIEW, // "recording" player
		// src_agent: relates to agent
		// evtc: yes
		// realtime: no

		CBTS_LANGUAGE, // text language id
		// src_agent: text language id
		// evtc: yes
		// realtime: no

		CBTS_GWBUILD, // game build
		// src_agent: game build number
		// evtc: yes
		// realtime: no

		CBTS_SHARDID, // server shard id
		// src_agent: shard id
		// evtc: yes
		// realtime: no

		CBTS_REWARD, // wiggly box reward
		// dst_agent: reward id
		// value: reward type
		// evtc: yes
		// realtime: yes

		CBTS_BUFFINITIAL, // buff application for buffs already existing at time of event
		// refer to cbtevent struct, identical to buff application. statechange is set to this
		// evtc: limited to squad outside instances
		// realtime: limited to squad

		CBTS_POSITION, // agent position changed
		// src_agent: relates to agent
		// dst_agent: (float*)&dst_agent is float[3], x/y/z
		// evtc: limited to agent table outside instances
		// realtime: no

		CBTS_VELOCITY, // agent velocity changed
		// src_agent: relates to agent
		// dst_agent: (float*)&dst_agent is float[3], x/y/z
		// evtc: limited to agent table outside instances
		// realtime: no

		CBTS_FACING, // agent facing direction changed
		// src_agent: relates to agent
		// dst_agent: (float*)&dst_agent is float[2], x/y
		// evtc: limited to agent table outside instances
		// realtime: no

		CBTS_TEAMCHANGE, // agent team id changed
		// src_agent: relates to agent
		// dst_agent: new team id
		// value: old team id
		// evtc: limited to agent table outside instances
		// realtime: limited to squad

		CBTS_ATTACKTARGET, // attacktarget to gadget association
		// src_agent: relates to agent, the attacktarget
		// dst_agent: the gadget
		// evtc: limited to agent table outside instances
		// realtime: no

		CBTS_TARGETABLE, // agent targetable state
		// src_agent: relates to agent
		// dst_agent: new targetable state
		// evtc: limited to agent table outside instances
		// realtime: no

		CBTS_MAPID, // map id
		// src_agent: map id
		// evtc: yes
		// realtime: no

		CBTS_REPLINFO, // internal use
		// internal use

		CBTS_STACKACTIVE, // buff instance is now active
		// src_agent: relates to agent
		// dst_agent: buff instance id
		// value: current buff duration
		// evtc: limited to squad outside instances
		// realtime: limited to squad

		CBTS_STACKRESET, // buff instance duration changed, value is the duration to reset to (also marks inactive), pad61-pad64 buff instance id
		// src_agent: relates to agent
		// value: new duration
		// evtc: limited to squad outside instances
		// realtime: limited to squad

		CBTS_GUILD, // agent is a member of guild
		// src_agent: relates to agent
		// dst_agent: (uint8_t*)&dst_agent is uint8_t[16], guid of guild
		// value: new duration
		// evtc: limited to squad outside instances
		// realtime: no

		CBTS_BUFFINFO, // buff information
		// skillid: skilldef id of buff
		// overstack_value: max combined duration
		// src_master_instid: 
		// is_src_flanking: likely an invuln
		// is_shields: likely an invert
		// is_offcycle: category
		// pad61: buff stacking type
		// pad62: likely a resistance
		// evtc: yes
		// realtime: no

		CBTS_BUFFFORMULA, // buff formula, one per event of this type
		// skillid: skilldef id of buff
		// time: (float*)&time is float[9], type attribute1 attribute2 parameter1 parameter2 parameter3 trait_condition_source trait_condition_self content_reference
		// src_instid: (float*)&src_instid is float[2], buff_condition_source buff_condition_self
		// evtc: yes
		// realtime: no

		CBTS_SKILLINFO, // skill information
		// skillid: skilldef id of skill
		// time: (float*)&time is float[4], cost range0 range1 tooltiptime
		// evtc: yes
		// realtime: no

		CBTS_SKILLTIMING, // skill timing, one per event of this type
		// skillid: skilldef id of skill
		// src_agent: timing type
		// dst_agent: at time since activation in milliseconds
		// evtc: yes
		// realtime: no

		CBTS_BREAKBARSTATE, // agent breakbar state changed
		// src_agent: relates to agent
		// dst_agent: new breakbar state
		// evtc: limited to agent table outside instances
		// realtime: no

		CBTS_BREAKBARPERCENT, // agent breakbar percentage changed
		// src_agent: relates to agent
		// value: (float*)&value is float[1], new percentage
		// evtc: limited to agent table outside instances
		// realtime: no

		CBTS_INTEGRITY, // one event per message. previously named error
		// time: (char*)&time is char[32], a short null-terminated message with reason
		// evtc: yes
		// realtime: no

		CBTS_MARKER, // one event per marker on an agent
		// src_agent: relates to agent
		// value: markerdef id. if value is 0, remove all markers presently on agent
		// buff: marker is a commander tag
		// evtc: limited to agent table outside instances
		// realtime: no

		CBTS_BARRIERPCTUPDATE, // agent barrier percentage changed
		// src_agent: relates to agent
		// dst_agent: percent * 10000 eg. 99.5% will be 9950
		// evtc: limited to agent table outside instances
		// realtime: no

		CBTS_STATRESET, // arcdps stats reset 
		// src_agent: species id of agent that triggered the reset, eg boss species id
		// evtc: yes
		// realtime: yes

		CBTS_EXTENSION, // for extension use. not managed by arcdps
		// evtc: yes
		// realtime: yes

		CBTS_APIDELAYED, // one per cbtevent that got deemed unsafe for realtime but safe for posting after squadcombat
		// evtc: no
		// realtime: yes

		CBTS_INSTANCESTART, // map instance start
		// src_agent: milliseconds ago instance was started 
		// evtc: yes
		// realtime: yes

		CBTS_RATEHEALTH, // tick health. previously named tickrate
		// src_agent: 25 - tickrate, when tickrate <= 20 
		// evtc: yes
		// realtime: no

		CBTS_LAST90BEFOREDOWN, // retired, not used since 240529+
		// retired

		CBTS_EFFECT, // retired, not used since 230716+
		// retired

		CBTS_IDTOGUID, // content id to guid association for volatile types
		// src_agent: (uint8_t*)&src_agent is uint8_t[16] guid of content
		// overstack_value: is of enum contentlocal
		// evtc: yes
		// realtime: no

		CBTS_LOGNPCUPDATE, // log boss agent changed
		// src_agent: species id of agent
		// dst_agent: related to agent
		// value: as uint32_t, server unix timestamp
		// evtc: yes
		// realtime: yes

		CBTS_IDLEEVENT, // internal use
		// internal use

		CBTS_EXTENSIONCOMBAT, // for extension use. not managed by arcdps
		// assumed to be cbtevent struct, skillid will be processed as such for purpose of buffinfo/skillinfo
		// evtc: yes
		// realtime: yes

		CBTS_FRACTALSCALE, // fractal scale for fractals
		// src_agent: scale
		// evtc: yes
		// realtime: no

		CBTS_EFFECT2, // play graphical effect
		// src_agent: related to agent
		// dst_agent: effect at location of agent (if applicable)
		// value: (float*)&value is float[3], location x/y/z (if not at agent location)
		// iff: (uint32_t*)&iff is uint32_t[1], effect duration
		// buffremove: (uint32_t*)&buffremove is uint32_t[1], trackable id of effect. id dst_agent and location is 0/0/0, effect was stopped
		// is_shields: (int16_t*)&is_shields is int16_t[3], orientation x/y/z, values are original*1000
		// is_flanking: effect is on a non-static platform
		// evtc: limited to agent table outside instances
		// realtime: no

		CBTS_RULESET, // ruleset for self
		// src_agent: bit0: pve, bit1: wvw, bit2: pvp
		// evtc: yes
		// realtime: no

		CBTS_SQUADMARKER, // squad ground markers
		// src_agent: (float*)&src_agent is float[3], x/y/z of marker location. if values are all zero or infinity, this marker is removed
		// skillid: index of marker eg. 0 is arrow
		// evtc: yes
		// realtime: no

		CBTS_ARCBUILD, // arc build info
		// src_agent: (char*)&src_agent is a null-terminated string matching the full build string in arcdps.log
		// evtc: yes
		// realtime: no

		CBTS_GLIDER, // glider status change
		// src_agent: related to agent
		// value: 1 deployed, 0 stowed
		// evtc: limited to agent table outside instances
		// realtime: no

		CBTS_STUNBREAK, // disable stopped early
		// src_agent: related to agent
		// value: duration remaining
		// evtc: limited to agent table outside instances
		// realtime: no

		CBTS_UNKNOWN // unknown/unsupported type newer than this list maybe
	};

	/* is friend/foe */
	enum EIsFriendFoe
	{
		IFF_FRIEND,
		IFF_FOE,
		IFF_UNKNOWN
	};

	/* combat result (direct) */
	enum ECombatResult
	{
		CBTR_NORMAL, // strike was neither crit or glance
		CBTR_CRIT, // strike was crit
		CBTR_GLANCE, // strike was glance
		CBTR_BLOCK, // strike was blocked eg. mesmer shield 4
		CBTR_EVADE, // strike was evaded, eg. dodge or mesmer sword 2
		CBTR_INTERRUPT, // strike interrupted something
		CBTR_ABSORB, // strike was "invulned" or absorbed eg. guardian elite
		CBTR_BLIND, // strike missed
		CBTR_KILLINGBLOW, // not a damage strike, target was killed by skill
		CBTR_DOWNED, // not a damage strike, target was downed by skill
		CBTR_BREAKBAR, // not a damage strike, target had value of breakbar damage dealt
		CBTR_ACTIVATION, // not a damage strike, skill activation event
		CBTR_CROWDCONTROL, // not a damage strike, target was crowdcontrolled
		CBTR_UNKNOWN
	};

	/* combat activation */
	enum ECombatActivation {
		ACTV_NONE, // not used - not this kind of event
		ACTV_START, // started skill/animation activation
		ACTV_QUICKNESS_UNUSED, // unused as of nov 5 2019
		ACTV_CANCEL_FIRE, // stopped skill activation with reaching tooltip time
		ACTV_CANCEL_CANCEL, // stopped skill activation without reaching tooltip time
		ACTV_RESET, // animation completed fully
		ACTV_UNKNOWN
	};

	/* combat buff remove type */
	enum ECombatBuffRemove {
		CBTB_NONE, // not used - not this kind of event
		CBTB_ALL, // last/all stacks removed (sent by server)
		CBTB_SINGLE, // single stack removed (sent by server). will happen for each stack on cleanse
		CBTB_MANUAL, // single stack removed (auto by arc on ooc or all stack, ignore for strip/cleanse calc, use for in/out volume)
		CBTB_UNKNOWN
	};

	/* combat buff cycle type */
	enum ECombatBuffCycle {
		CBTC_CYCLE, // damage happened on tick timer
		CBTC_NOTCYCLE, // damage happened outside tick timer (resistable)
		CBTC_NOTCYCLENORESIST, // BEFORE MAY 2021: the others were lumped here, now retired
		CBTC_NOTCYCLEDMGTOTARGETONHIT, // damage happened to target on hitting target
		CBTC_NOTCYCLEDMGTOSOURCEONHIT, // damage happened to source on htiting target
		CBTC_NOTCYCLEDMGTOTARGETONSTACKREMOVE, // damage happened to target on source losing a stack
		CBTC_UNKNOWN
	};

	/* language */
	enum EGWLanguage {
		GWL_ENG = 0,
		GWL_FRE = 2,
		GWL_GEM = 3,
		GWL_SPA = 4,
		GWL_CN = 5,
	};

	/* content local enum */
	enum EContentLocal {
		CONTENTLOCAL_EFFECT,
		CONTENTLOCAL_MARKER
	};

	struct UISettings
	{
		uint64_t IsHidden				: 1;
		uint64_t IsAlwaysDrawn			: 1;
		uint64_t IsModMoveLocked		: 1;
		uint64_t IsModClickLocked		: 1;
		uint64_t IsClosingWithEscape	: 1;
	};

	struct Modifiers
	{
		WORD Mod1;
		WORD Mod2;
		WORD ModMulti;
	};

	/* exports */
	typedef uint64_t(*Export_GetU64)();

	static void* LogFile;
	static void* LogArc;

	static void LogToFile(char* str) /* log to arcdps.log, thread/async safe */
	{
		size_t(*log)(char*) = (size_t(*)(char*))LogFile;
		if (log) (*log)(str);
		return;
	}
	static void LogToArc(char* str) /* log to extensions tab in arcdps log window, thread/async safe */
	{
		size_t(*log)(char*) = (size_t(*)(char*))LogArc;
		if (log) (*log)(str);
		return;
	}
	static void Log(char* str) /* log to arcdps.log and log window*/
	{
		LogToFile(str);
		LogToArc(str);
		return;
	}
#ifdef __cplusplus
}
#endif

#endif