QCherry: Release G1R:MP 0.1.5 BUILD144 / Protocol 37; update availability and migration

2026-09-26T07:34:20Z

Release G1R:MP 0.1.5 BUILD144 / Protocol 37; update availability and migration

← Older revision		Revision as of 07:34, 26 September 2026
Line 31:		Line 31:
	== Notes ==		== Notes ==
	* Server-side only. Mutations require the NPC to belong to the calling resource; getters do not grant control.		* Server-side only. Mutations require the NPC to belong to the calling resource; getters do not grant control.
	* Since 0.1.5. ~~This documents~~ the ~~next release; public~~ 0.1.~~4 does not include these additions~~.		* Since 0.1.5. Use the matching 0.1.5 client and server (Protocol 37).
	* Use matching updated client and server. See [[NPC scripting]] for lifecycle, defaults, combat examples and collision limitations.		* Use matching updated client and server. See [[NPC scripting]] for lifecycle, defaults, combat examples and collision limitations.
	* Default true. A living invulnerable NPC can intercept a projectile without losing HP. Authorized health setters still work.		* Default true. A living invulnerable NPC can intercept a projectile without losing HP. Authorized health setters still work.

QCherry: Document new NPC/player-mode API and events available from 0.1.5

2026-09-25T17:15:16Z

Document new NPC/player-mode API and events available from 0.1.5

New page

= setNpcInvulnerable =
<div style="background:#fff5f5; border:1px solid #d13b3b; border-left:5px solid #d13b3b; color:#111111; padding:0.85rem 1rem; margin:0.75rem 0 1rem;">
<div style="color:#111111; font-weight:bold; letter-spacing:0.04em;">AVAILABLE FROM UPDATE 0.1.5</div>
<div style="color:#111111; margin-top:0.25rem;">This function is available in G1R:MP 0.1.5 and later. The contract below includes the compatibility guarantees introduced in that update.</div>
</div>

Enables/disables incoming damage protection.

== Syntax ==
<syntaxhighlight lang="lua">
setNpcInvulnerable(npcId, enabled)
</syntaxhighlight>

== Parameters ==
{| class="wikitable"
! Name !! Type !! Required !! Description
|-
| <code>npcId</code> || <code>int</code> || yes || Server-assigned NPC ID returned by spawnNpc; not a player ID.
|-
| <code>enabled</code> || <code>bool</code> || yes || true enables the setting, false disables it.
|}

== Returns ==
Returns true when accepted, false for a rejected request. Acceptance is not proof of a rendered animation, projectile release or hit.

== Examples ==
<syntaxhighlight lang="lua" line>
setNpcInvulnerable(npcId, false)
</syntaxhighlight>

== Notes ==
* Server-side only. Mutations require the NPC to belong to the calling resource; getters do not grant control.
* Since 0.1.5. This documents the next release; public 0.1.4 does not include these additions.
* Use matching updated client and server. See [[NPC scripting]] for lifecycle, defaults, combat examples and collision limitations.
* Default true. A living invulnerable NPC can intercept a projectile without losing HP. Authorized health setters still work.

[[Category:Lua Functions]]
[[Category:Server Functions]]
[[Category:NPC Functions]]

SetNpcInvulnerable - Revision history

QCherry: Release G1R:MP 0.1.5 BUILD144 / Protocol 37; update availability and migration

QCherry: Document new NPC/player-mode API and events available from 0.1.5