State of commit 90f8ede

Author: DamianQualshy

docs/api.json

@@ -0,0 +1,8 @@
+---
+title: 'NPC'
+---
+# `constants` NPC <font size="4">(server-side)</font>
+
+| Name         | Description                          |
+| :----------: | :----------------------------------- |
+| `ACTION_PLAY_ANI` | Represents action play ani type. |

docs/scripting-reference/server-constants/NPC.md

@@ -0,0 +1,17 @@
+---
+title: 'onNpcActionFinished'
+---
+# `event` onNpcActionFinished <font size="4">(server-side)</font>
+!!! info "Available since version: 0.3.0"
+
+Triggered when an action leaves the queue through completion, failure, cancellation or timeout.
+
+## Parameters
+```c++
+void onNpcActionFinished(number npc_id, number action_type, number action_id, boolean result)
+```
+
+* `number` **npc_id**: NPC id.
+* `number` **action_type**: ACTION_PLAY_ANI.
+* `number` **action_id**: Finished action id.
+* `boolean` **result**: True only for successful completion reported by the current host.

docs/scripting-reference/server-events/npc/onNpcActionFinished.md

@@ -0,0 +1,16 @@
+---
+title: 'onNpcActionSent'
+---
+# `event` onNpcActionSent <font size="4">(server-side)</font>
+!!! info "Available since version: 0.3.0"
+
+Triggered when the current action is dispatched to its host. A replay after host migration may emit it again.
+
+## Parameters
+```c++
+void onNpcActionSent(number npc_id, number action_type, number action_id)
+```
+
+* `number` **npc_id**: NPC id.
+* `number` **action_type**: ACTION_PLAY_ANI.
+* `number` **action_id**: Dispatched action id.

docs/scripting-reference/server-events/npc/onNpcActionSent.md

@@ -0,0 +1,16 @@
+---
+title: 'onNpcChangeHostPlayer'
+---
+# `event` onNpcChangeHostPlayer <font size="4">(server-side)</font>
+!!! info "Available since version: 0.3.0"
+
+Triggered when the player responsible for executing an NPC's actions changes.
+
+## Parameters
+```c++
+void onNpcChangeHostPlayer(number npc_id, number current_id, number previous_id)
+```
+
+* `number` **npc_id**: NPC id.
+* `number` **current_id**: New host id, or -1 for no host.
+* `number` **previous_id**: Previous host id, or -1 for no host.

docs/scripting-reference/server-events/npc/onNpcChangeHostPlayer.md

@@ -0,0 +1,14 @@
+---
+title: 'onNpcCreated'
+---
+# `event` onNpcCreated <font size="4">(server-side)</font>
+!!! info "Available since version: 0.3.0"
+
+Reports NPC creation at the end of the server tick. The NPC may already be spawned or destroyed.
+
+## Parameters
+```c++
+void onNpcCreated(number npc_id)
+```
+
+* `number` **npc_id**: Created NPC id.

docs/scripting-reference/server-events/npc/onNpcCreated.md

@@ -0,0 +1,14 @@
+---
+title: 'onNpcDestroyed'
+---
+# `event` onNpcDestroyed <font size="4">(server-side)</font>
+!!! info "Available since version: 0.3.0"
+
+Triggered after a server-owned NPC is destroyed. The id is no longer valid.
+
+## Parameters
+```c++
+void onNpcDestroyed(number npc_id)
+```
+
+* `number` **npc_id**: Destroyed NPC id.

docs/scripting-reference/server-events/npc/onNpcDestroyed.md

@@ -0,0 +1,18 @@
+---
+title: 'clearNpcActions'
+---
+# `function` clearNpcActions <font size="4">(server-side)</font>
+!!! info "Available since version: 0.3.0"
+
+Cancels the current action and all pending actions.
+
+## Declaration
+```cpp
+boolean clearNpcActions(number npc_id)
+```
+
+## Parameters
+* `number` **npc_id**: Server NPC id.
+  
+## Returns `boolean`
+True if cleared, including an empty queue; false for an invalid NPC or failed operation.

docs/scripting-reference/server-functions/npc/clearNpcActions.md

@@ -0,0 +1,19 @@
+---
+title: 'createNpc'
+---
+# `function` createNpc <font size="4">(server-side)</font>
+!!! info "Available since version: 0.3.0"
+
+Creates an unspawned, server-owned NPC. Use spawnPlayer to stream it to clients.
+
+## Declaration
+```cpp
+number createNpc(string name, string|nil instance)
+```
+
+## Parameters
+* `string` **name**: Character name.
+* `string|nil` **instance**: Gothic NPC instance; defaults to PC_HERO.
+  
+## Returns `number`
+NPC id, or -1 on failure.

docs/scripting-reference/server-functions/npc/createNpc.md

@@ -0,0 +1,18 @@
+---
+title: 'destroyNpc'
+---
+# `function` destroyNpc <font size="4">(server-side)</font>
+!!! info "Available since version: 0.3.0"
+
+Destroys an NPC and cancels its queued actions.
+
+## Declaration
+```cpp
+boolean destroyNpc(number npc_id)
+```
+
+## Parameters
+* `number` **npc_id**: Server NPC id.
+  
+## Returns `boolean`
+True if the NPC was destroyed.