### Untitled

No description

--------------------------------

### Untitled

No description

--------------------------------

### Get World of Warcraft Installation Directory

Source: https://apep-docs.pages.dev/api/apep

Retrieves the absolute path to the directory where World of Warcraft is installed on the system. Returns a string representing the path.

```lua
local wowDirectory = _A.GetWoWDirectory()
print(wowDirectory)

```

--------------------------------

### Untitled

No description

--------------------------------

### Untitled

No description

--------------------------------

### Lua: Get Player Name

Source: https://apep-docs.pages.dev/index

This Lua code snippet demonstrates how to get and print the name of the player unit using the Apep framework. It requires the Unit object to be initialized.

```Lua
local player = Unit('player')

print(player:Name())

```

--------------------------------

### Untitled

No description

--------------------------------

### Untitled

No description

--------------------------------

### GUI Settings Example (Lua)

Source: https://apep-docs.pages.dev/config

An example snippet demonstrating the structure for configuring GUI settings within an Apep rotation file. This specific example focuses on the 'gui_st' table, defining the title, color, width, and height of the rotation's graphical user interface.

```lua
{
    gui_st: {
        title = "Warrior Protection",
        color = "87CEFA",
        width = "315",
        height = "370"
    }
}
```

--------------------------------

### Untitled

No description

--------------------------------

### Basic ACTION Syntax Example

Source: https://apep-docs.pages.dev/framework/actions

Demonstrates the fundamental structure of an ACTION, comprising the action itself, conditions, and the target unit.

```lua
{ACTION, CONDITIONS, UNIT/FAKEUNIT}
```

--------------------------------

### Untitled

No description

--------------------------------

### Basic DSL Rotation Structure

Source: https://apep-docs.pages.dev/index

This snippet shows the basic structure of a rotation definition in Apep's Domain-Specific Language (DSL). It includes placeholders for action, condition, and unit.

```DSL
{"ACTION", "CONDITION", "UNIT"},

```

--------------------------------

### Configure Apep Settings via INI File

Source: https://apep-docs.pages.dev/installation

This configuration snippet shows how to modify Apep's behavior by editing the Apep.ini file. It enables alternative injection methods for specific game versions and bypasses symbolic link permission issues.

```ini
MoP_AltInjection=true
SymLinkByPass=false
```

--------------------------------

### Get Object Entry ID and GUID

Source: https://apep-docs.pages.dev/api/apep

Fetches both the entry ID and GUID for a given object pointer. This provides a comprehensive identifier for game objects.

```lua
local targetEntryID, targetGUID = _A.ObjectID_GUID("target")
```

--------------------------------

### Untitled

No description

--------------------------------

### Get Unit Target Pointer and GUID

Source: https://apep-docs.pages.dev/api/apep

Retrieves the target's pointer and GUID for a given unit object. This function is useful for identifying and tracking the target of a specific unit.

```lua
local pointer, GUID = _A.UnitTarget("mouseover")
```

--------------------------------

### Get Object Creator GUID

Source: https://apep-docs.pages.dev/api/apep

Retrieves the GUID of the creator of a specified fishing bobber object. Returns nil if the object or its creator's pointer is not available.

```lua
local objectPointer = "0x01234567"
local unitPointer = _A.ObjectCreator(objectPointer)
```

--------------------------------

### Untitled

No description

--------------------------------

### UnitTarget API

Source: https://apep-docs.pages.dev/api/apep

Retrieves the target of a given unit, returning both its pointer and GUID.

```APIDOC
## UnitTarget API

### Description
This function takes a unit object and returns the target of that unit as its pointer and GUID.

### Method
_A.UnitTarget

### Parameters
#### Path Parameters
- **object** (string) - Required - The unit object for which to retrieve the target.

### Returns `pointer`, `guid`
- **pointer** (string) - The pointer of the unit's target.
- **guid** (string) - The GUID of the unit's target.

### Request Example
```lua
local pointer, GUID = _A.UnitTarget("mouseover") 
```
```

--------------------------------

### Getting Specific Object from Object Manager - Lua

Source: https://apep-docs.pages.dev/framework/object-manager

Shows how to retrieve a specific object, such as the player's character, from a table within the Object Manager using the 'Get' method and direct table access. This avoids manual iteration for common lookups.

```lua
local playerObject = _A.OM:Get("Roster")[UnitGUID("player")]

```

```lua
local playerObject = _A.OM["Roster"][UnitGUID("player")]

```

--------------------------------

### Nested Actions Example

Source: https://apep-docs.pages.dev/framework/actions

Demonstrates nesting actions to create complex conditional structures. The outer condition must be met, followed by evaluation of each inner action with its specific conditions.

```lua
{{
  {"Execute", "health<=20", "target"},
  {"Mortal Strike", "spell.ready", "target"}
}, "player.incombat && target.WarriorMelee"}
```

--------------------------------

### GetPositionFromPosition API

Source: https://apep-docs.pages.dev/api/apep

Calculates a new position in 3D space based on a starting position, distance, and two angles.

```APIDOC
## GetPositionFromPosition

### Description
This function calculates a new position in three-dimensional space based on a starting position (X, Y, Z), a specified distance, and two angles (Angle1 and Angle2). It uses trigonometric functions to calculate the new coordinates and returns the calculated X, Y, and Z values.

### Method
GET

### Endpoint
/utility/position/from-position

### Parameters
#### Path Parameters
None

#### Query Parameters
- **X** (number) - Required - The X coordinate of the starting position.
- **Y** (number) - Required - The Y coordinate of the starting position.
- **Z** (number) - Required - The Z coordinate of the starting position.
- **Distance** (number) - Required - The distance from the starting position to the new position.
- **Angle1** (number) - Required - The angle (in radians) in the XY plane (horizontal plane) from the positive X-axis.
- **Angle2** (number) - Required - The angle (in radians) between the XY plane and the line connecting the starting position and the new position.

#### Request Body
None

### Request Example
```lua
local newX, newY, newZ = _A.GetPositionFromPosition(100, 100, 0, 10, math.rad(45), math.rad(30))
print("Distance:", distance)
```

### Response
#### Success Response (200)
- **newX** (number) - The calculated X coordinate of the new position.
- **newY** (number) - The calculated Y coordinate of the new position.
- **newZ** (number) - The calculated Z coordinate of the new position.

#### Response Example
```json
{
  "newX": 105.3,
  "newY": 107.1,
  "newZ": 5.0
}
```
```

--------------------------------

### Untitled

No description

--------------------------------

### Get Fishing Bobber Creator GUID

Source: https://apep-docs.pages.dev/api/apep

Retrieves the GUID of the creator of a fishing bobber object. Returns nil if the object is not valid.

```lua
local bobberPointer = "0x01234567"
local creatorGUID = _A.BobberCreator(bobberPointer)
```

--------------------------------

### Get UI Configuration Value

Source: https://apep-docs.pages.dev/framework/conditions/general

Retrieves the value of a specific key from the GUI configuration. The return type can be boolean, string, or number, depending on the key's associated UI element.

```DSLLua
{ACTION, "ui(ashamane_key)" },

```

```Lua
_A.DSL:Get("ui")(_, "ashamane_key")

```

```Lua
PLAYER:Ui("ashamane_key")

```

--------------------------------

### Get Apep Directory - Lua

Source: https://apep-docs.pages.dev/api/apep

Retrieves the directory path where the Apep executable is located. This is useful for accessing related files or configurations.

```lua
local apepDirectory = _A.GetApepDirectory()
print(apepDirectory)
```

--------------------------------

### Untitled

No description

--------------------------------

### Untitled

No description

--------------------------------

### Get Files in Directory

Source: https://apep-docs.pages.dev/api/apep

Retrieves a list of file names within a specified directory path. Can optionally include files from subfolders. Returns a table of strings.

```lua
local wowDirectory = _A.GetWoWDirectory()
local files = _A.GetDirectoryFiles(wowDirectory, true)
for _, fileName in ipairs(files) do
    print(fileName)
end

```

--------------------------------

### Get Folders in Directory

Source: https://apep-docs.pages.dev/api/apep

Retrieves a list of folder names within a specified directory path. Can optionally include folders from subfolders. Returns a table of strings.

```lua
local wowDirectory = _A.GetWoWDirectory()
local folders = _A.GetDirectoryFolders(wowDirectory, false)
for _, folderName in ipairs(folders) do
    print(folderName)
end

```

--------------------------------

### Untitled

No description

--------------------------------

### Get Apep Executable Directory

Source: https://apep-docs.pages.dev/api/apep

Retrieves the directory path where the Apep executable is located on the system. This function is useful for locating Apep-related files or configurations.

```lua
-- Example usage:
local apepDir = _A.GetApepDirectory()
print("Apep directory: " .. apepDir)

```

--------------------------------

### Get Object Pointer by GUID - Lua

Source: https://apep-docs.pages.dev/api/apep

Retrieves an object's pointer using its globally unique identifier (GUID). It takes a GUID string as input and returns the object's pointer (number) or nil if not found. Requires the UnitGUID function.

```Lua
local guid = _G.UnitGUID("target")
local targetPointer = _A.GetObjectWithGUID(guid)
```

--------------------------------

### Get Channeling Percentage

Source: https://apep-docs.pages.dev/framework/conditions/general

Retrieves the completion percentage of a unit's current channeling ability. Returns a number representing the percentage.

```DSLLua
{ACTION, "UNIT.channeling.percent >= 60", UNIT},

```

```Lua
_A.DSL:Get("channeling.percent")("UNIT") >= 60

```

```Lua
UNIT:ChannelingPercent() >= 60

```

--------------------------------

### Get Unit GUID (Lua)

Source: https://apep-docs.pages.dev/framework/conditions/unit

Retrieves the globally unique identifier (GUID) for a specified unit. The function takes a unit as input and returns its GUID as a string. If the unit is invalid, it returns nil. This is useful for unique identification and data storage.

```lua
_A.DSL:Get("guid")("UNIT")

```

```lua
UNIT.guid
or
UNIT:Guid()

```

--------------------------------

### Untitled

No description

--------------------------------

### Untitled

No description

--------------------------------

### Get Unit Cast ID, Pointer, and GUID

Source: https://apep-docs.pages.dev/api/apep

Retrieves the cast ID, pointer, and GUID of a unit's current cast. This function is essential for monitoring and interacting with ongoing unit casts.

```lua
local castId, tarPointer, tarGUID = _A.UnitCastID("target")
if castId==12345 then
    
end
```

--------------------------------

### Get Focus Resource for Player or Pet

Source: https://apep-docs.pages.dev/framework/conditions/class

Calculates the focus resource of the player or pet, based on the provided target. The UNIT parameter specifies 'pet' or 'player'. Returns a NUMBER representing the focus resource.

```DSLLua
{ACTION, "UNIT.focus >= 40", UNIT}
```

```Lua
_A.DSL:Get("focus")("UNIT") >= 40
```

```Lua
UNIT:Focus() >= 40
```

--------------------------------

### Retrieve Enemy List - DSLLua

Source: https://apep-docs.pages.dev/framework/units/fakeunits/enemy

Retrieves a list of all enemy units from the Object Manager. It returns a table indexed by GUID containing the enemy units. This function has no input parameters.

```DSLLua
{ACTION, ACTION, "enemies"},

```

```DSLLua
local enemies = Object("enemies") or {}
for _, Obj in pairs(enemies) do
    print(Obj:Distance()) 
end

```

--------------------------------

### Lua Combat Rotation Setup

Source: https://apep-docs.pages.dev/my-first-rotation

Sets up a combat rotation in Lua for Apep. It defines combat actions as a table, specifying conditions and targets. This approach is suitable for simpler, declarative rotation logic.

```lua
local _, _A = ...

local inCombat = {
    {"%target", "!target.exists || target.dead", "nearEnemyCb"},
    {"Serpent Sting", "spell.ready && spell.range && !debuff", "target"},
    {"Explosive Shot", "spell.ready && spell.range", "target"},
}

_A.CR:Add(255, { 
    name = "Survival Hunter PVE",
    ic = inCombat,
    wow_ver = "5.4.8", 
    apep_ver = "1.1",
})

```

--------------------------------

### Untitled

No description

--------------------------------

### Get Unit Class - Lua

Source: https://apep-docs.pages.dev/framework/conditions/unit

Retrieves the class of a given unit. If the class cannot be determined, it returns 'Unknown'. Example classes include 'DEATHKNIGHT'.

```Lua
_A.DSL:Get("class")("UNIT") == "DEATHKNIGHT"
```

```Lua
UNIT:Class() == "DEATHKNIGHT"
```

--------------------------------

### Untitled

No description

--------------------------------

### Untitled

No description

--------------------------------

### DSLLua: Retrieve most targeted roster unit

Source: https://apep-docs.pages.dev/framework/units/fakeunits/roster

Retrieves the unit from the roster that is most targeted by enemies. The example shows how to get the 'mostTargetedRoster' object and print its name, useful for identifying high-priority targets or units under pressure.

```DSLLua
{ACTION, ACTION, "mostTargetedRoster"},

```

```DSLLua
local mostT = Object("mostTargetedRoster")
if mostT then
    print(mostT.name) 
end

```

--------------------------------

### Untitled

No description

--------------------------------

### DSLLua: Retrieve healer from roster

Source: https://apep-docs.pages.dev/framework/units/fakeunits/roster

Retrieves a healer unit from the roster based on current health. The example demonstrates how to get the 'healer' object and print its name, useful for targeting or managing healers in the game.

```DSLLua
{ACTION, ACTION, "healer"},

```

```DSLLua
local healer = Object("healer")
if healer then
    print(healer.name) 
end

```

--------------------------------

### DSLLua: Retrieve tank from roster

Source: https://apep-docs.pages.dev/framework/units/fakeunits/roster

Retrieves a tank unit from the roster based on a priority calculation involving maximum health and role multiplier. The example shows how to get 'tank1' and 'tank2' objects and print their names.

```DSLLua
{ACTION, ACTION, "tank1"},
{ACTION, ACTION, "tank2"},

```

```DSLLua
local tank1 = Object("tank1")
local tank2 = Object("tank2")
if tank1 then
    print(tank1.name) 
end
if tank2 then
    print(tank2.name) 
end

```

--------------------------------

### Library Function Call Action

Source: https://apep-docs.pages.dev/framework/actions

Shows how to call registered library functions using the '@' prefix. Libraries must be added using '_A.Library:Add()' prior to invocation.

```lua
{"@LibraryName.FunctionName(arguments)", CONDITIONS, UNIT}
```

```lua
{"@Prot.Use(Health Stones)", CONDITIONS, "player"}
```

```lua
{"@Prot.PickupHS(unit)", CONDITIONS, "objectID(193169)"}
```

--------------------------------

### Untitled

No description

--------------------------------

### Untitled

No description

--------------------------------

### Apep DSL: Basic ACTION with Conditions and Unit

Source: https://apep-docs.pages.dev/framework/conditions

This example shows the fundamental structure of an ACTION in Apep's DSL. It includes the ACTION itself, a string defining multiple conditions, and the target UNIT. Conditions like 'inmelee', buff checks with stack limits, and spell usability can be combined using logical operators.

```dsl
{ACTION, "inmelee && player.buff(Taste for Blood).stack < 3 && spell(Slam).usable", UNIT}

```

--------------------------------

### Equipped Item Usage Actions

Source: https://apep-docs.pages.dev/framework/actions

Demonstrates using equipped items from specific equipment slots. The '#' prefix denotes an equipment slot. Valid slots include trinket1, trinket2, neck, waist, hands, and others.

```lua
{"#trinket1", CONDITIONS, UNIT}
```

```lua
{"#trinket2", CONDITIONS, UNIT}
```

```lua
{"#neck", CONDITIONS, UNIT}
```

```lua
{"#waist", CONDITIONS, UNIT}
```

```lua
{"#hands", CONDITIONS, UNIT}
```

--------------------------------

### Untitled

No description

--------------------------------

### Untitled

No description

--------------------------------

### Unit GUID API

Source: https://apep-docs.pages.dev/framework/conditions/unit

Retrieves the unique identifier (GUID) for a unit. This is useful for referencing specific units.

```APIDOC
## UNIT.guid

### Description
Retrieves the GUID of a unit.

### Method
GET

### Endpoint
/units/{UNIT}/guid

### Parameters
#### Path Parameters
- **UNIT** (UNIT) - Required - The unit for which to retrieve the GUID.

### Response
#### Success Response (200)
- **guid** (STRING) - The GUID of the target, or nil if the target is not valid.

### Request Example
```lua
_A.DSL:Get("guid")("UNIT")
```

### Response Example
```json
{
  "guid": "a1b2c3d4-e5f6-7890-1234-567890abcdef"
}
```
```

--------------------------------

### UI Configuration API

Source: https://apep-docs.pages.dev/framework/conditions/general

Retrieve values from the GUI configuration.

```APIDOC
## ui

### Description
Retrieves the value associated with a given key from the GUI configuration.

### Method
GET (implied)

### Endpoint
N/A (Function call)

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
None

### Parameters
* **KEY** (string) - Required - The name of the key in the GUI configuration to check.

### Request Example
```lua
{ACTION, "ui(ashamane_key)"}
```

### Response
#### Success Response (200)
* **return_value** (boolean | string | number) - The value associated with the provided key in the GUI configuration.

#### Response Example
```lua
true
```
```

--------------------------------

### Untitled

No description

--------------------------------

### Check if Unit is Sheathed (Lua)

Source: https://apep-docs.pages.dev/framework/conditions/unit

Provides Lua code examples to check if a unit is sheathed. The examples cover using a direct action, a DSL query, and a unit method. The function takes a UNIT as input and returns a boolean.

```lua
{ACTION, "UNIT.sheathed", UNIT},

```

```lua
_A.DSL:Get("sheathed")("UNIT")

```

```lua
UNIT:IsSheathed()

```

--------------------------------

### Untitled

No description

--------------------------------

### Object Identification and Distance Calculation

Source: https://apep-docs.pages.dev/api/apep

Functions for retrieving objects by GUID and calculating distances.

```APIDOC
## GetObjectWithGUID

### Description
Retrieves the object's pointer using its globally unique identifier (GUID).

### Method
N/A (Function Call)

### Endpoint
N/A

### Parameters
#### Path Parameters
N/A

#### Query Parameters
N/A

#### Request Body
N/A

### Request Example
```lua
local guid = _G.UnitGUID("target")
local targetPointer = _A.GetObjectWithGUID(guid)
```

### Response
#### Success Response (200)
- **pointer** (number|nil) - The pointer of the object, or `nil` if the object was not found.

#### Response Example
```json
{
  "pointer": 12345678
}
```

## GetDistanceBetweenPositions

### Description
Calculates the Euclidean distance between two 3D positions in the game world.

### Method
N/A (Function Call)

### Endpoint
N/A

### Parameters
#### Path Parameters
N/A

#### Query Parameters
N/A

#### Request Body
N/A

### Request Example
```lua
local distance = _A.GetDistanceBetweenPositions(100, 200, 0, 150, 250, 10)
print("Distance:", distance)
```

### Response
#### Success Response (200)
- **distance** (number) - The distance between the two positions.

#### Response Example
```json
{
  "distance": 70.71
}
```

## GetDistanceBetweenObjects

### Description
Calculates the distance between two objects.

### Method
N/A (Function Call)

### Endpoint
N/A

### Parameters
#### Path Parameters
N/A

#### Query Parameters
N/A

#### Request Body
N/A

### Request Example
```lua
local distance = _A.GetDistanceBetweenObjects("player", "0x87654321")
print("Distance:", distance)
```

### Response
#### Success Response (200)
- **distance** (number) - The distance between the two objects, or nil if positions couldn't be retrieved.

#### Response Example
```json
{
  "distance": 15.2
}
```

## GetRangeBetweenObjects

### Description
Calculates the range between two objects while taking into account their combat reach.

### Method
N/A (Function Call)

### Endpoint
N/A

### Parameters
#### Path Parameters
N/A

#### Query Parameters
N/A

#### Request Body
N/A

### Request Example
```lua
local effectiveRange = _A.GetRangeBetweenObjects("player", "target")
```

### Response
#### Success Response (200)
- **range** (number) - The effective range between the two objects, considering combat reaches.

#### Response Example
```json
{
  "range": 10.5
}
```
```

--------------------------------

### Object Manager Initialization - Lua

Source: https://apep-docs.pages.dev/framework/object-manager

Initializes the Object Manager (_A.OM) with various sub-tables for different entity types like All, Enemy, Friendly, Roster, Dead, Critters, and various Object types. This structure allows for organized access to game world entities.

```lua
_A.OM = {
    All = {},
    Enemy = {},
    EnemyCombat = {},
    Friendly = {},
    Roster = {},
    Dead = {},
    Critters = {},
    Object = {},
    GameObject = {},
    DynamicObject = {},
}

```

--------------------------------

### ObjectID_GUID API

Source: https://apep-docs.pages.dev/api/apep

Retrieves both the entry ID and GUID of an object using its pointer or identifier.

```APIDOC
## ObjectID_GUID API

### Description
This function retrieves the entry ID and GUID of an object identified by its pointer or object identifier.

### Method
_A.ObjectID_GUID

### Parameters
#### Path Parameters
- **object** (string) - Required - The pointer or object identifier (e.g., "player", "target", or a pointer value).

### Returns `entryID`, `guid`
- **entryID** (number) - The entry ID of the object, or `nil` if the object pointer is invalid or not found.
- **guid** (string) - The GUID of the object, or `nil` if the object pointer is invalid or not found.

### Request Example
```lua
local targetEntryID, targetGUID = _A.ObjectID_GUID("target")
```
```

--------------------------------

### Combat Control Macro Actions

Source: https://apep-docs.pages.dev/framework/actions

Controls auto-attack behavior using macro commands. '/startattack' initiates auto-attack, while '/stopattack' halts it. These actions target the specified UNIT under given CONDITIONS.

```lua
{"/startattack", CONDITIONS, UNIT}
```

```lua
{"/stopattack", CONDITIONS, UNIT}
```

--------------------------------

### Casting Remaining API

Source: https://apep-docs.pages.dev/framework/conditions/general

Get the remaining time for a unit's current cast.

```APIDOC
## casting.remaining

### Description
Gets the remaining time for a unit's current cast.

### Method
GET (implied)

### Endpoint
N/A (Function call)

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
None

### Parameters
* **UNIT** (Unit) - Required - The unit to check for casting.

### Request Example
```lua
{ACTION, "UNIT.casting.remaining < 0.5", UNIT}
```

### Response
#### Success Response (200)
* **return_value** (number) - The remaining time in seconds for the current cast. Returns `999` if not currently casting.

#### Response Example
```lua
0.2
```
```

--------------------------------

### Untitled

No description

--------------------------------

### Casting Length API

Source: https://apep-docs.pages.dev/framework/conditions/general

Get the total duration of a unit's current cast.

```APIDOC
## casting.length

### Description
Gets the total duration of a unit's current cast.

### Method
GET (implied)

### Endpoint
N/A (Function call)

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
None

### Parameters
* **UNIT** (Unit) - Required - The unit to check for casting.

### Request Example
```lua
{ACTION, "UNIT.casting.length > 1.5", UNIT}
```

### Response
#### Success Response (200)
* **return_value** (number) - The length (duration) of the current cast in seconds.

#### Response Example
```lua
2.5
```
```

--------------------------------

### Basic Apep Rotation Configuration (Lua)

Source: https://apep-docs.pages.dev/config

This Lua table defines the fundamental settings for an Apep rotation. It includes the rotation's name, combat logic definitions, GUI parameters, and version information. Dependencies include predefined Lua variables like 'inCombat', 'outCombat', and 'GUI'.

```lua
{
    name = "Protection Warrior (DSL mode)",
    ic = inCombat,
    ooc = outCombat,
    use_lua_engine = false,
    gui = GUI,
    gui_st = {
        title = "CR Settings",
        color = "87CEFA",
        width = "315",
        height = "370"
    },
    wow_ver = "10.1.7",
    apep_ver = "1.1",
    ids = spellIds_Loc,
    blacklist = blacklist,
    pooling = false,
    load = exeOnLoad,
    unload = exeOnUnload
}
```

--------------------------------

### Channeling Percent API

Source: https://apep-docs.pages.dev/framework/conditions/general

Get the percentage of completion for a unit's current channel.

```APIDOC
## channeling.percent

### Description
Gets the percentage of completion for a unit's current channel.

### Method
GET (implied)

### Endpoint
N/A (Function call)

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
None

### Parameters
* **UNIT** (Unit) - Required - The unit to check for channeling.

### Request Example
```lua
{ACTION, "UNIT.channeling.percent >= 60", UNIT}
```

### Response
#### Success Response (200)
* **return_value** (number) - The percentage of completion for the channeling ability.

#### Response Example
```lua
80.2
```
```

--------------------------------

### Untitled

No description

--------------------------------

### Untitled

No description

--------------------------------

### Casting Percent API

Source: https://apep-docs.pages.dev/framework/conditions/general

Get the percentage of completion for a unit's current cast.

```APIDOC
## casting.percent

### Description
Gets the percentage of completion for a unit's current cast.

### Method
GET (implied)

### Endpoint
N/A (Function call)

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
None

### Parameters
* **UNIT** (Unit) - Required - The unit to check for casting.

### Request Example
```lua
{ACTION, "UNIT.casting.percent >= 60", UNIT}
```

### Response
#### Success Response (200)
* **return_value** (number) - The percentage of completion for the casting ability.

#### Response Example
```lua
75.5
```
```

--------------------------------

### Get Unit Name

Source: https://apep-docs.pages.dev/framework/conditions/unit

Retrieves the name of a unit. Returns the name as a string, or 'Unknown' if it cannot be determined.

```Lua
_A.DSL:Get("name")("UNIT") == "Gul'dan"

```

```Lua
UNIT.name == "Gul'dan"
or
UNIT:Name() == "Gul'dan"

```

--------------------------------

### Get Unit Level

Source: https://apep-docs.pages.dev/framework/conditions/unit

Retrieves the level of a unit. Returns the level as a number, or -1 if it cannot be determined.

```Lua
{ACTION, "UNIT.level >= 45", UNIT},

```

```Lua
_A.DSL:Get("level")("UNIT") >= 45

```

```Lua
UNIT:Level() >= 45

```

--------------------------------

### Ground Targeting Item Action

Source: https://apep-docs.pages.dev/framework/actions

Illustrates how to use items that require ground targeting by appending '.ground' to the UNIT parameter. This is common for items like engineering belts.

```lua
{"#waist", CONDITIONS, "target.ground"}
```

--------------------------------

### Get Object Count

Source: https://apep-docs.pages.dev/api/apep

Retrieves the total number of objects currently present in the object manager. This function is deprecated.

```lua
local objectCount = _A.GetObjectCount()
```

--------------------------------

### UnitCastID API

Source: https://apep-docs.pages.dev/api/apep

Fetches information about a unit's current cast, including cast ID, pointer, and GUID.

```APIDOC
## UnitCastID API

### Description
This function takes a unit object as a parameter and returns information about the unit's current cast, including its cast ID, pointer, and GUID.

### Method
_A.UnitCastID

### Parameters
#### Path Parameters
- **object** (string) - Required - The unit object for which to retrieve the cast information.

### Returns `castId`, `pointer`, `guid`
- **castId** (number) - The cast ID of the unit's current cast.
- **pointer** (string) - The pointer of the unit's cast.
- **guid** (string) - The GUID of the unit's cast.

### Request Example
```lua
local castId, tarPointer, tarGUID = _A.UnitCastID("target") 
if castId==12345 then
    
end
```
```

--------------------------------

### LoadScript API

Source: https://apep-docs.pages.dev/api/apep

Loads and executes a Lua script located at the specified file path.

```APIDOC
## LoadScript

### Description
Loads and executes a Lua script located at the specified file path.

### Method
POST

### Endpoint
/script/load

### Parameters
#### Request Body
- **path** (string) - Required - The path to the Lua script file.

### Request Example
```json
{
  "path": "/path/to/scripts/start.lua"
}
```

### Response
#### Success Response (200)
This endpoint does not return a specific JSON response on success, but indicates execution completion.

#### Error Response (400)
- **error** (string) - An error message if the script failed to load or execute.

#### Response Example
```json
{
  "message": "Script executed successfully."
}
```
```

--------------------------------

### Untitled

No description

--------------------------------

### Get Object Facing

Source: https://apep-docs.pages.dev/api/apep

Retrieves the facing angle (in radians) of an object in the xy plane. Returns nil if the object does not exist.

```lua
_A.ObjectFacing("player")
```