StarterPlayer
*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.
Un servizio che consente ai valori predefiniti delle proprietà nell'oggetto Player di essere Impostare. Quando un giocatore entra nel Server, ogni proprietà del giocatore viene impostata al valore corrente della proprietà corrispondente in StarterPlayer .
Inoltre, puoi aggiungere quattro oggetti a questo servizio:
- Un'istanza StarterPlayerScripts con gli script che vengono eseguiti una volta per ciascun Giocatore.
- Un'istanza StarterCharacterScripts con script da aggiungere al personaggio di ogni Giocatoreogni volta che si genera.
- Un'istanza Humanoid chiamata StarterHumanoid che verrà utilizzata come il personaggio predefinito per ogni Giocatore.
- Una Model istanza con il nome StarterCharacter che sarà utilizzata come modello di personaggio per tutti i giocatori.
Sommario
Proprietà
Descrive i livelli di autorizzazione del Giocoattuale per le animazioni dell'avatar personalizzate dal sito Web.
Imposta se il personaggio salterà automaticamente quando colpisce un ostacolo su un Dispositivomobile.
La distanza massima che la fotocamera predefinita del Giocatoreè autorizzata a zoom in studs.
La distanza minima in studs della telecamera predefinita del Giocatoreè consentita per lo ingrandire.
Cambia la modalità della Telecamerapredefinita in prima o terza persona.
Determina il valore di partenza di Humanoid.JumpHeight per Player.Character .
Determina il valore di partenza di Humanoid.JumpPower per Player.Character .
Determina il valore di partenza di Humanoid.MaxSlopeAngle per Player.Character .
Determina lo stato di partenza di Humanoid.UseJumpPower per Player.Character .
Determina il valore di partenza di Humanoid.WalkSpeed per Player.Character .
Imposta il modo in cui le maniglie della fotocamera gestiscono gli oggetti tra la fotocamera e il Giocatore.
Permetti agli sviluppatori di sovrascrivere il modo fotocamera predefinito per ciascun giocatore se il giocatore è su un computer.
Permetti agli sviluppatori di sovrascrivere il modo di movimento del Giocatorese il giocatore è su un computer.
Permetti ai developer di sovrascrivere il modo di movimento della telecamera predefinito per ciascun giocatore se il giocatore è su un Dispositivomobile.
Permetti agli sviluppatori di sovrascrivere il modo di movimento del Giocatorese il giocatore è su un Dispositivotouch.
Determina se un giocatore può attivare o meno la blocco del mouse per impostazione predefinita.
Imposta la distanza in cui questo giocatore vedrà le altre barre di salute Humanoid. Se impostato su 0, le barre di salute non saranno visualizzate.
Indipendentemente dal fatto che l'aspetto di un personaggio del Giocatoredebba essere caricato o meno.
Indica se i personaggi che si generano in un'esperienza avranno accessori di abbigliamento a più livelli.
Imposta la distanza in cui questo giocatore vedrà altri nomi Humanoid . Se impostato su 0, i nomi sono nascosti.
Determina se gli emotes di proprietà dell'utente vengono caricati quando si caricano gli avatar.
Metodi
Proprietà
AllowCustomAnimations
La proprietà AllowCustomAnimations descrive i livelli di autorizzazione del Giocoattuale riguardanti l'avatar personalizzato Animations dal sito Web.
Come tale, questo valore non può essere cambiato dal dentro del Gioco. Può essere cambiato solo cambiando i livelli di autorizzazione del Gioconella pagina di Configurazionedel Giocosul sito Web.
Questa proprietà non è destinata all'uso nel Gioco.
AutoJumpEnabled
La proprietà AutoJumpEnabled imposta se il personaggio salterà automaticamente quando colpisce un ostacolo su un Dispositivomobile.
Questa proprietà viene copiata dal StarterPlayer a un Player quando si uniscono al Gioco. Seguendo questo. il valore di questa proprietà viene copiato al Humanoid.AutoJumpEnabled proprietà del personaggio's 2>Class.Humanoid2> al Rigenerare. In
Campioni di codice
This code sample is meant for a TextButton. It allows the player to toggle the auto-jumping behavior while on a mobile device.
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local button = script.Parent
local function update()
-- Update button text
if player.AutoJumpEnabled then
button.Text = "Auto-Jump is ON"
else
button.Text = "Auto-Jump is OFF"
end
-- Reflect the property in the player's character, if they have one
if player.Character then
local human = player.Character:FindFirstChild("Humanoid")
if human then
human.AutoJumpEnabled = player.AutoJumpEnabled
end
end
end
local function onActivated()
-- Toggle auto-jump
player.AutoJumpEnabled = not player.AutoJumpEnabled
-- Update everything else
update()
end
button.Activated:Connect(onActivated)
update()AvatarJointUpgrade
CameraMaxZoomDistance
La proprietà CameraMaxZoomDistance imposta la distanza massima in studs che la fotocamera può essere dal personaggio con le telecamere predefinite.
Questa proprietà imposta il valore predefinito di Player.CameraMaxZoomDistance per ogni giocatore che si unisce al Gioco. Se questo valore viene impostato a un valore inferiore a StarterPlayer.CameraMinZoomDistance verrà aumentato a CameraMinZoomDistance.
Campioni di codice
The example demonstrates how to set a player's camera minimum and maximum zoom distance.
In this example, we set the Player.CameraMinZoomDistance and Player.CameraMaxZoomDistance to set the min and max distance in studs a player's camera can be from their character.
Note that since the example attempts to set the CameraMinZoomDistance to be greater than the CameraMaxZoomDistance, the CameraMinZoomDistance value will be decreased and set to the value of the max zoom distance.
To change the default min and max zoom distance values for a player when they first enter the game, you can change the StarterClass.Player.CameraMinZoomDistance and StarterClass.Player.CameraMaxZoomDistance properties.
local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.CameraMaxZoomDistance = 50
player.CameraMinZoomDistance = 75CameraMinZoomDistance
La proprietà CameraMinZoonDistance imposta la distanza minima in studs dalla quale la fotocamera può essere dal personaggio con le telecamere predefinite.
Questa proprietà imposta il valore predefinito di Player.CameraMinZoomDistance per ogni giocatore che si unisce al Gioco. Se questo valore viene impostato su un valore maggiore di StarterPlayer.CameraMaxZoomDistance verrà ridotto a CameraMaxZoomDistance.
Campioni di codice
The example demonstrates how to set a player's camera minimum and maximum zoom distance.
In this example, we set the Player.CameraMinZoomDistance and Player.CameraMaxZoomDistance to set the min and max distance in studs a player's camera can be from their character.
Note that since the example attempts to set the CameraMinZoomDistance to be greater than the CameraMaxZoomDistance, the CameraMinZoomDistance value will be decreased and set to the value of the max zoom distance.
To change the default min and max zoom distance values for a player when they first enter the game, you can change the StarterClass.Player.CameraMinZoomDistance and StarterClass.Player.CameraMaxZoomDistance properties.
local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.CameraMaxZoomDistance = 50
player.CameraMinZoomDistance = 75CameraMode
Imposta il valore predefinito per Player.CameraMode per ciascun giocatore nel Gioco. La fotocamera ha due modalità:
Prima persona
In modalità prima persona, la fotocamera del Giocatoreè zoomata fino in fondo. A meno che non sia presente un'interfaccia utente visibile con la proprietà GuiButton.Modal impostata su true , il mouse sarà bloccato e la fotocamera dell'utente si trasformerà mentre il mouse si muove.
Terza persona
In modalità terza persona (predefinita), il personaggio può essere visto nella Telecamera. Mentre nella modalità terza persona su Roblox:
- Puoi fare clic con il pulsante destro del mouse e trascinare per ruotare la tua Telecamera, o usare i pulsanti freccia in basso a destra dello schermo.
- Quando muovi il Topo, or mouse as computer mouse, la tua fotocamera non cambia (a meno che non muovi il mouse verso la fine dello schermo).
- Quando premi una qualsiasi delle frecce, il personaggio dell'utente affronterà nella direzione corrispondente alla freccia chiave.
- Puoi ingrandire e restringere liberamente.
Campioni di codice
This example demonstrates how to change the character's CameraMode to first person using the LockFirstPerson value of the Enum.CameraMode enum.
local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.CameraMode = Enum.CameraMode.LockFirstPersonCharacterJumpHeight
CharacterJumpHeight determinato il valore di partenza di Humanoid.JumpHeight per un Giocatoredi Character . Il valore di questa proprietà predefinito è 7,2 studs.
Questa proprietà è visibile solo nella finestra Proprietà Se StarterPlayer.CharacterUseJumpPower è impostata su false , poiché non sarebbe rilevante altrimenti.
Poiché questa proprietà è rilevante solo per i personaggi che vengono generati in futuro, cambiarlo non cambierà alcun personaggio esistente. Le modifiche a questa proprietà avranno effetto solo quando un giocatore respawna.
CharacterJumpPower
CharacterJumpPower determina il valore di partenza di Humanoid.JumpPower per un Giocatore. Il valore di questa proprietà predefinito 50 e quando applicato al Giocatoredi Character sarà limitato tra 0 e 1000.
Questa proprietà è visibile solo nella finestra Proprietà Se StarterPlayer.CharacterUseJumpPower è impostata su true , poiché non sarebbe rilevante altrimenti.
Poiché questa proprietà è rilevante solo per i personaggi che vengono generati in futuro, cambiarlo non cambierà alcun personaggio esistente. Le modifiche a questa proprietà avranno effetto solo quando un giocatore respawna.
CharacterMaxSlopeAngle
CharacterMaxSlopeAngle determina il valore di partenza di Humanoid.MaxSlopeAngle per un Giocatore. Si predefinisce su 89°, quindi gli umanoidi possono salire quasi qualsiasi curva che vogliono per impostazione predefinita. Quando applicato al Giocatore's Class.Humanoid sarà limit
Poiché questa proprietà è rilevante solo per i personaggi che vengono generati in futuro, cambiarlo non cambierà alcun personaggio esistente. Le modifiche a questa proprietà avranno effetto solo quando un giocatore respawna.
CharacterUseJumpPower
CharacterUseJumpPower determinano il valore di partenza di Humanoid.UseJumpPower per un Giocatore. Togglierlo cambierà quale proprietà è visibile nella finestra delle proprietà: Character (falso) o
Poiché questa proprietà è rilevante solo per i personaggi che vengono generati in futuro, cambiarlo non cambierà alcun personaggio esistente. Le modifiche a questa proprietà avranno effetto solo quando un giocatore respawna.
CharacterWalkSpeed
CharacterWalkSpeed determinare il valore di partenza di Humanoid.WalkSpeed per un Giocatoredi Character . Questa proprietà predefinita 16.
Poiché questa proprietà è rilevante solo per i personaggi che vengono generati in futuro, cambiarlo non cambierà alcun personaggio esistente. Le modifiche a questa proprietà avranno effetto solo quando un giocatore respawna.
DevCameraOcclusionMode
Difini come gli script della telecamera predefiniti gestiscono gli oggetti tra la telecamera e il soggetto della telecamera. Si applica a tutti i giocatori mentre si uniscono all'esperienza e non possono essere cambiati per i singoli giocatori.
Il valore predefinito è Zoom (0). Vedi Enum.DevCameraOcclusionMode per una lista di modalità disponibili.
DevComputerCameraMovementMode
La proprietà DevComputerCameraMovementMode consente al sviluppatore di sovrascrivere il modo della telecamera del Giocatorese il giocatore è su un computer.
Questa è la proprietà predefinita per i giocatori che si uniscono al Gioco. Può essere cambiata per i giocatori individuali impostando il Player.DevComputerCameraMode .
Se impostato su UserChoice il modo in cui la fotocamera del Giocatoresi muove sarà determinato dal modo in cui il giocatore ha impostato le impostazioni di gioco. Altrimenti, il modo sarà impostato in base a questa Proprietà.
Vedi Enum.DevComputerCameraMovementMode per i diversi modelli di telecamera disponibili.
Questa proprietà non ha alcun effetto sui giocatori non su un computer.
Campioni di codice
The example demonstrates how to set a player's camera movement mode for players on a computer.
In this example, we set the camera movement mode to Classic via the Enum.DevComputerCameraMovementMode enum. This means that the camera of players on touch enabled devices will track the player but will not automatically rotate if the player walks left or right.
local Players = game:GetService("Players")
local player = Players.LocalPlayer
-- Set the player's camera movement mode on computers to classic
player.DevComputerCameraMode = Enum.DevComputerCameraMovementMode.ClassicDevComputerMovementMode
La proprietà DevComputerMovementMove consente al sviluppatore di sovrascrivere il modo di movimento del Giocatorese il giocatore è su un computer.
Questa è la proprietà predefinita per i giocatori che si uniscono al Gioco. Può essere cambiata per i giocatori individuali impostando il Player.DevComputerMovementMode .
Se impostato su UserChoice il modo in cui il Giocatoresi muove sarà determinato dalle impostazioni di gioco. Altrimenti, il modo sarà impostato in base a questa Proprietà.
Vedi Enum.DevComputerMovementMode per i diversi modelli di movimento disponibili. Lasciamo che gli sviluppatori sovrascrivere il modo di movimento del Giocatorese il giocatore è su un computer.
Questa proprietà non ha alcun effetto sui giocatori non su un computer.
Campioni di codice
Demonstrates how to set the movement mode for players on computers using the Player.DevComputerMovementMode property.
local Players = game:GetService("Players")
local function onPlayerAdded(player: Player)
-- Set the player's movement mode on desktop devices to click-to-move
-- Once set, the player can right click in the game world and the character will move there.
player.DevComputerMovementMode = Enum.DevComputerMovementMode.ClickToMove
end
Players.PlayerAdded:Connect(onPlayerAdded)DevTouchCameraMovementMode
La proprietà DevTouchCameraMovementMode consente al sviluppatore di sovrascrivere il modo della telecamera del Giocatorese il giocatore è su un Dispositivotouch.
Questa è la proprietà predefinita per i giocatori che si uniscono al Gioco. Può essere cambiata per i giocatori individuali impostando il Player.DevTouchCameraMode .
Se impostato su UserChoice allora il modo in cui il Giocatoreusa la fotocamera sarà determinato dal modo in cui il giocatore imposta le impostazioni di gioco. Altrimenti, il modo sarà impostato in base a questa Proprietà.
Vedi Enum.DevTouchCameraMovementMode per i diversi modelli di telecamera disponibili.
Questa proprietà non ha alcun effetto sui giocatori non su un Dispositivomobile.
Campioni di codice
The example demonstrates how to set a player's camera movement mode.
In this example, we set the camera movement mode to Classic via the Enum.DevTouchCameraMovementMode enum. This means that the camera of players on touch enabled devices will track the player but will not automatically rotate if the player walks left or right.
local Players = game:GetService("Players")
local player = Players.LocalPlayer
-- Set the player's camera movement mode on mobile devices to classic
player.DevTouchCameraMovementMode = Enum.DevTouchCameraMovementMode.ClassicDevTouchMovementMode
La proprietà DevTouchMovementMode consente al sviluppatore di sovrascrivere il modo di movimento del Giocatorese il giocatore è su un Dispositivotouch.
Questa è la proprietà predefinita per i giocatori che si uniscono al Gioco. Può essere cambiata per i giocatori individuali impostando il Player.DevTouchMovementMode .
Se impostato su UserChoice il modo in cui il Giocatoresi muove sarà determinato dalle impostazioni di gioco. Altrimenti, il modo sarà impostato in base a questa Proprietà.
Vedi Enum.DevTouchMovementMode per i diversi modelli di movimento disponibili. Lasciamo gli sviluppatori sovrascrivere il modo di movimento del Giocatorese il giocatore è su un Dispositivotouch.
Questa proprietà non ha alcun effetto sui giocatori non su un Dispositivoabilitato al tocco.
Campioni di codice
The example demonstrates how to set the movement mode for players on touch enabled devices.
In this example, we set the movement mode to Thumbstick via the Enum.DevTouchMovementMode enum. This means that players on touch enabled devices are able to move via a virtual thumbstick on their screen.
local Players = game:GetService("Players")
game.Players.PlayerAdded:Connect(function(player)
-- Set the player's movement mode on mobile devices to a dynamic thumbstick
player.DevTouchMovementMode = Enum.DevTouchMovementMode.DynamicThumbstick
end)EnableDynamicHeads
EnableMouseLockOption
La proprietà EnableMouseLockOption determina se un giocatore può attivare la sblocco del mouse per impostazione predefinita.
Mouselock bloccherà il cursore del Giocatoreal centro dello schermo. Il movimento del mouse ruoterà la Camera e il Player si muoverà rispetto alla rotazione attuale della Telecamera.
Questa proprietà imposta il valore di Player.DevEnableMouseLock .
Nota che le API correlate a shift-lock sono in corso di Deprecare, quindi si consiglia di utilizzare UserInputService.MouseBehavior invece per bloccare il Topo, or mouse as computer mouse.
Campioni di codice
The example demonstrates how to enable and disabled whether a player can lock their mouse.
In this example, we set the use a while true loop to toggle the state of the DevEnabledMouseLock property between true and false every 5 seconds. While this example has little practical use, it demos how to change the property via a LocalScript.
local Players = game:GetService("Players")
local player = Players.LocalPlayer
while true do
player.DevEnableMouseLock = not player.DevEnableMouseLock
task.wait(5)
endHealthDisplayDistance
La proprietà HealthDisplayDistance imposta la distanza in studs in cui questo giocatore vedrà le altre barre di salute Humanoid . Se impostato su 0, le barre di salute non saranno visualizzate. Questa proprietà è impostata su 100 studs per impostazione predefinita.
Per cambiare la distanza di visualizzazione per un giocatore una volta che si unisce al Gioco, puoi impostare la ProprietàPlayer.HealthDisplayDistance .
Se una barra di salute Humanoid è visibile, puoi impostare il tipo di visualizzazione usando Humanoid.DisplayDistanceType .
Campioni di codice
This example demonstrates how to hide other Humanoid's (Player and NPC) health bars and names.
This is done by setting the player's Player.HealthDisplayDistance and Player.NameDisplayDistance properties to 0.
If you would like to display health bars and names, you set the properties to a value greater than 0. For instance, setting the properties to 100 means that the player will see other player's health and names up to 100 studs away.
To modify the default values for players, you can change the values of the StarterClass.Player.HealthDisplayDistance and StarterClass.Player.NameDisplayDistance properties.
local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.HealthDisplayDistance = 0
player.NameDisplayDistance = 0LoadCharacterAppearance
La proprietà LoadCharacterAppearance imposta se la velocità di caricamento del personaggio di un Giocatoredeve essere caricata o no.
Impostando questo su false i risultati sono che il giocatore non ha vestiti (inclusi gli stivali), colori del corpo, pacchetti del corpo o qualsiasi altra cosa relativa all'aspetto del Giocatore. Per impostazione predefinita, questa proprietà è impostata su true .
Impostando questo su true risulta nel giocatore che carica l'aspetto corrispondente al GiocatorePlayer.CharacterAppearanceId .
Se Player:LoadCharacterWithHumanoidDescription() viene utilizzato, può essere vantaggioso impostare StarterPlayer.LoadCharacterAppearance su false come l'avatar del Giocatorenon è richiesto come tutti gli ID delle risorse per equipaggiare sul personaggio verranno dal passato in HumanoidDescription .
Campioni di codice
This example demonstrates how to disable loading a player's character appearance. Instead, the player loads as a grey model without any hats, shirts, pants, etc.
This is useful for games using custom clothing and accessories.
Note that if the character has already spawned, this change will not take affect until the player respawns or the Player:LoadCharacter() function is called.
local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.CanLoadCharacterAppearance = falseLoadCharacterLayeredClothing
Indica se i personaggi che si generano in un'esperienza avranno gli accessori per la ropa a più strati (anche se Workspace.MeshPartHeadsAndAccessories deve essere abilitato anche nella Workspace .
LuaCharacterController
NameDisplayDistance
Imposta la distanza in cui questo giocatore vedrà altri nomi Humanoid . Se impostato su 0, i nomi sono nascosti.
Il valore DisplayDistance StarterPlayer imposta la distanza in studs in cui questo giocatore vedrà altri nomi Humanoid . Se impostato su 0, i nomi sono nascosti. Questa proprietà è impostata su 100 studs per impostazione predefinita.
Per cambiare la distanza di visualizzazione per un giocatore una volta che si unisce al Gioco, puoi impostare la ProprietàPlayer.NameDisplayDistance .
Se un nome Humanoid è visibile, puoi impostare il tipo di visualizzazione utilizzando Humanoid.DisplayDistanceType .
Campioni di codice
This example demonstrates how to hide other Humanoid's (Player and NPC) health bars and names.
This is done by setting the player's Player.HealthDisplayDistance and Player.NameDisplayDistance properties to 0.
If you would like to display health bars and names, you set the properties to a value greater than 0. For instance, setting the properties to 100 means that the player will see other player's health and names up to 100 studs away.
To modify the default values for players, you can change the values of the StarterClass.Player.HealthDisplayDistance and StarterClass.Player.NameDisplayDistance properties.
local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.HealthDisplayDistance = 0
player.NameDisplayDistance = 0UserEmotesEnabled
Questa proprietà determina se gli emotes di proprietà dell'utente vengono caricati quando si caricano gli avatar. Impostando questa proprietà su false disabilita il caricamento. Gli sviluppatori possono impostare la proprietà in Studio direttamente o attraverso il menu Impostazioni di gioco .
Quando la funzione di caricamento delle emotes è disabilitata, l'interfaccia utente delle emotes funzionerà ancora a patto che gli sviluppatori scelgano di utilizzare la funzione delle emotes aggiungendo emotes nel loro Gioco.
Vedi anche Emotes per l'Avatar, un articolo dettagliato su come controllare, personalizzare e giocare alle emotes per l'avatar.