QCherry: Document universal per-observer nameplates and test resource available from update 0.1.3

2026-09-09T03:08:36Z

Document universal per-observer nameplates and test resource available from update 0.1.3

New page

= resetPlayerNameplateVisibleFor =
<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.3</div>
<div style="color:#111111; margin-top:0.25rem;">This function is available in G1R:MP 0.1.3 and later. The contract below includes the compatibility guarantees introduced in that update.</div>
</div>

Removes only the calling resource's whole-label visibility override for one observer/target pair.

== Syntax ==
<syntaxhighlight lang="lua">
bool resetPlayerNameplateVisibleFor(int observerId, int targetId)
</syntaxhighlight>

== Parameters ==
{| class="wikitable"
! Name !! Type !! Required !! Description
|-
| <code>observerId</code> || <code>int</code> || yes || The connected human player who will see the label.
|-
| <code>targetId</code> || <code>int</code> || yes || The different connected human player whose overhead label is controlled.
|}

== Returns ==
Returns <code>true</code> when the owned field is removed or was already absent; <code>false</code> for an invalid pair/service or a field owned by another resource.

== Examples ==
Resume inheritance from the current global setting:
<syntaxhighlight lang="lua" line>
resetPlayerNameplateVisibleFor(observerId, targetId)
</syntaxhighlight>

== Notes ==
* Available only in server-side resource scripts.
* The ordered pair is observer -> target; the reverse pair is independent. Both IDs must be distinct, connected session IDs, not persistent character IDs or NPC IDs.
* Each field resolves independently: explicit pair override, then the target's current global field, then the native default. Getters expose server policy, not whether pixels are currently rendered.
* No built-in acquaintance database or gamemode permission policy is assumed. See [[Observer nameplates]] for resource ownership, limits, persistence and privacy boundaries.
* A pair field is exclusively owned by the resource that first sets it. Another resource cannot overwrite or reset that field; other fields remain independent. An absent reset and an identical owned write are successful no-ops.
* Pair overrides survive leaving the synchronization range, but are cleared for both endpoints on disconnect and for their owning resource on stop. State is replayed reliably when the target becomes relevant again; no database persistence is automatic.
* Limits default to 250,000 active pairs globally and per resource, with a per-resource mutation token bucket of 4,096/s and an 8,192 burst. New/changed non-reset writes consume tokens; resets and cleanup do not. See the guide for configuration keys.
* Does not restore a saved global snapshot or clear another field. The current target fallback is used immediately in server state; rendering remains asynchronous.
* PascalCase alias: <code>ResetPlayerNameplateVisibleFor</code>.

[[Category:Lua Functions]]
[[Category:Server Functions]]
[[Category:Player Functions]]
[[Category:Nameplate Functions]]

ResetPlayerNameplateVisibleFor - Revision history

QCherry: Document universal per-observer nameplates and test resource available from update 0.1.3