ForgetPlayerDiscovery

The player has found nothing again - the record emptied and the game told to forget.

For a mode that lets one game play more than one character: call it at each switch, then restore the new character’s record. The kinds are as SetDiscoveryTracking takes them, except that leaving them out (or nil) means every kind. The places cannot be forgotten yet: asking for them - by name, or by leaving the kinds out - forgets the others and returns false, and the places stay in the record and in the game (the game’s next report would bring them back). A mode that switches characters in one game should therefore not keep the places until they can be forgotten: leave "places" out of SetDiscoveryTracking, or the second character is saved with the first one’s places.

Syntax

ForgetPlayerDiscovery(pid [, kinds])

Parameter	Type
pid	number	the player
kinds	boolean | string | table | nil	the kinds to forget (all of them when left out) (optional)

Returns

boolean - false for a player who is not there, when a word is no kind (nothing is forgotten then) or when a kind cannot be forgotten (the places, today - the others are forgotten all the same)

Example

ForgetPlayerDiscovery(pid)     -- before the next character's record is put back

See also

SetPlayerDiscovery · GetPlayerDiscovery · the Discovery - the map and the places a player found group of the index