From f0a52fc7513bd86f8548b3f976e85a3a59992ef3 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Wed, 23 Dec 2020 15:56:27 +0000 Subject: [PATCH] Merge docs for 'player() returns consistently on player scoped apps.' --- docs/scarpet/Full.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/docs/scarpet/Full.md b/docs/scarpet/Full.md index b5aec1b9..cae98c9d 100644 --- a/docs/scarpet/Full.md +++ b/docs/scarpet/Full.md @@ -2893,7 +2893,10 @@ In this case - entities would need to be re-fetched, or the code should account ### `player(), player(type), player(name)` -With no arguments, it returns the calling player or the player closest to the caller. Note that the main context +With no arguments, it returns the calling player or the player closest to the caller. +For player-scoped apps (which is a default) its always the owning player or `null` if it not present even if some code +still runs in their name. +Note that the main context will receive `p` variable pointing to this player. With `type` or `name` specified, it will try first to match a type, returning a list of players matching a type, and if this fails, will assume its player name query retuning player with that name, or `null` if no player was found. With `'all'`, list of all players in the game, in all dimensions, so end