newPlayer

Typemessage
DictionaryLCS
LibraryLiveCode Script
Syntax
newPlayer
Associationsplayer
Summary

Sent to a new player right after it's created.

Introduced1.0
OSmac, windows, linux, ios, android
Platformsdesktop, server, mobile
Example
on newPlayer -- assign a file
  if the filename of the target is empty then
    answer file "Please choose a file to play:"
    set the filename of the target to it
  end if
end newPlayer
Values
NameTypeDescription
It

The newly-created player's long ID property is placed in the it variable.

RelatedKeyword: it, player, templatePlayer
Property: script
Command: copy, clone, paste
Glossary: object, property, variable, message path, message, tool, trap
Control Structure: pass
Description

Handle the newPlayer message if you want to create additional objects, switch tools, or do other tasks when a new player is created.

Normally, the newPlayer message is handled at a higher level of the message path, since the newly-created player does not yet have a script unless the templatePlayer contains one.

The actual creation is not triggered by the newPlayer message, so trapping the message and not allowing it to pass does not prevent the player from being created.

Tagsobjects