StarterPlayer
*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.
Un servizio che consente di impostare i predefiniti delle proprietà nell'oggetto Player .Quando un giocatore entra nel Server, ogni proprietà dell'oggetto giocatore viene impostata sul valore corrente della proprietà corrispondente in StarterPlayer .
Inoltre, puoi aggiungere quattro oggetti a questo servizio:
- Un'istanza StarterPlayerScripts con script che si eseguono una volta per ogni 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 umanoide predefinito per il personaggio di ciascun Giocatore.
- Un'istanza Model chiamata StarterCharacter che verrà utilizzata come modello di personaggio per tutti i giocatori.
Sommario
Proprietà
Descrive i livelli di autorizzazione attuali della Giocoin termini di animazioni di avatar personalizzate dal sito web.
Imposta se il personaggio salterà automaticamente quando colpisce un ostacolo su un Dispositivomobile.
La distanza massima a cui la fotocamera predefinita del Giocatoreè autorizzata a zoomare in studs.
La distanza minima in studs della fotocamera predefinita del Giocatoreè consentita di ingrandire.
Cambia la modalità della Telecamerapredefinita in prima o terza persona.
Determina il valore iniziale di Humanoid.JumpHeight per Player.Character .
Determina il valore iniziale di Humanoid.JumpPower per Player.Character .
Determina il valore iniziale di Humanoid.MaxSlopeAngle per Player.Character .
Determina lo stato iniziale di Humanoid.UseJumpPower per Player.Character .
Determina il valore iniziale di Humanoid.WalkSpeed per Player.Character .
Imposta come la fotocamera predefinita gestisca gli oggetti tra la fotocamera e il Giocatore.
Consente allo sviluppatore di sovrascrivere il modo fotocamera predefinito per ciascun giocatore se il giocatore è su un computer.
Consenti allo sviluppatore di sovrascrivere la modalità di movimento del Giocatorese il giocatore è su un computer.
Consente allo sviluppatore di sovrascrivere il modo di movimento della fotocamera predefinita per ciascun giocatore se il giocatore è su un Dispositivomobile.
Consenti allo sviluppatore di sovrascrivere la modalità di movimento del Giocatorese il giocatore è su un Dispositivotouch.
Determina se un giocatore può attivare il blocco del mouse per impostazione predefinita.
Imposta la distanza in cui questo giocatore vedrà altre barre di salute Humanoid. Se impostata a 0, le barre di salute non verranno visualizzate.
Se l'aspetto di un personaggio di un Giocatoredebba essere caricato o meno.
Indica se i personaggi che si generano in un'esperienza avranno accessori di abbigliamento stratificati equipaggiati su di loro.
Imposta la distanza in cui questo giocatore vedrà altri nomi Humanoid .
Determina se le emote di proprietà dell'utente vengono caricate quando si caricano gli avatar.
Metodi
Proprietà
AllowCustomAnimations
Questa proprietà descrive i livelli di autorizzazione attuali del Giocoin relazione all'avatar personalizzato Animations dal sito web.
Come tale, questo valore non può essere cambiato dall'interno del Gioco.Può essere cambiato solo modificando i livelli di autorizzazione del Gioconella pagina delle impostazioni del Giocosul sito web.
Questa proprietà non è destinata all'uso nel Gioco.
AutoJumpEnabled
Questa proprietà imposta se il personaggio salterà automaticamente quando colpisce un ostacolo su un Dispositivomobile.
Questa proprietà viene copiata dal StarterPlayer al Player quando si uniscono al Gioco.A seguire.il valore di questa proprietà viene copiato a Humanoid.AutoJumpEnabled proprietà del personaggio di Humanoid on Rigenerare.In altre parole, è possibile impostare il comportamento di auto-salto su una base per carattere, per giocatore e per gioco utilizzando queste tre proprietà.
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
Questa proprietà imposta la distanza massima in studs dalla quale la fotocamera può essere dal personaggio con le fotocamere predefinite.
Questa proprietà imposta il valore predefinito di Player.CameraMaxZoomDistance per ogni giocatore che si unisce al Gioco.Se questo valore è impostato su un valore più basso di 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
Questa proprietà imposta la distanza minima in studs dalla quale la fotocamera può essere dal personaggio con le fotocamere predefinite.
Questa proprietà imposta il valore predefinito di Player.CameraMinZoomDistance per ogni giocatore che si unisce al Gioco.Se questo valore è impostato su un valore superiore a 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 ogni giocatore nella Gioco. La fotocamera ha due modi:
Prima persona
Nella modalità in prima persona, la fotocamera del Giocatoreè ingrandita fino in fondo.A meno che non ci sia una GUI visibile presente con la proprietà GuiButton.Modal impostata su true , il mouse verrà bloccato e la fotocamera dell'utente si attiverà quando il mouse si muove.
Terza persona
Nella modalità in terza persona (predefinita), il personaggio può essere visto nella Telecamera. Mentre in modalità in terza persona su Roblox:
- Puoi fare clic con il pulsante destro e trascinare per ruotare la Telecamerao usare le frecce nelle aree inferiori destra dello schermo.
- Quando muovi il Topo, or mouse as computer mouse, la tua fotocamera non cambia (a meno che non muovi il mouse fino alla fine dello schermo).
- Quando premi una qualsiasi delle freccie, il personaggio dell'utente si orienterà nella direzione della chiavecorrispondente.
- Puoi zoomare e scorrere 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
Questa proprietà determina il valore iniziale di Humanoid.JumpHeight per un Giocatoredi Player.Character . Il valore di questa proprietà predefinito è di 7,2 studs.
Questa proprietà è visibile solo nella finestra Proprietà se StarterPlayer.CharacterUseJumpPower è impostata su false, altrimenti non sarebbe rilevante.
Poiché questa proprietà è rilevante solo per i personaggi che verranno generati in futuro, cambiarla non cambierà alcun personaggio giocatore esistente.I cambiamenti a questa proprietà avranno effetto solo quando un giocatore respawnerà.
CharacterJumpPower
Questa proprietà determina il valore iniziale di Humanoid.JumpPower per un Giocatoredi Player.Character .Il valore di questa proprietà predefinito è 50 e quando applicato al Giocatoredi Humanoid sarà limitato tra 0 e 1000.
Questa proprietà è visibile solo nella finestra Proprietà se StarterPlayer.CharacterUseJumpPower è impostata su true, altrimenti non sarebbe rilevante.
Poiché questa proprietà è rilevante solo per i personaggi che verranno generati in futuro, cambiarla non cambierà alcun personaggio giocatore esistente.I cambiamenti a questa proprietà avranno effetto solo quando un giocatore respawnerà.
CharacterMaxSlopeAngle
Questa proprietà determina il valore iniziale di Humanoid.MaxSlopeAngle per un Giocatoredi Player.Character .Predefinisce 89°, quindi gli umanoidi possono salire praticamente qualsiasi pendenza che vogliono per impostazione predefinita.Quando viene applicato al Giocatoredi Humanoid sarà limitato tra 0 e 89.
Poiché questa proprietà è rilevante solo per i personaggi che verranno generati in futuro, cambiarla non cambierà alcun personaggio giocatore esistente.I cambiamenti a questa proprietà avranno effetto solo quando un giocatore respawnerà.
CharacterUseJumpPower
CharacterUseJumpPower determina il valore iniziale di Humanoid.UseJumpPower per un Giocatoredi Player.Character .Attivandolo cambierà quale proprietà è visibile nella finestra Proprietà: CharacterJumpHeight (false) o StarterPlayer.CharacterJumpPower (true).Predefinito su vero.
Poiché questa proprietà è rilevante solo per i personaggi che verranno generati in futuro, cambiarla non cambierà alcun personaggio giocatore esistente.I cambiamenti a questa proprietà avranno effetto solo quando un giocatore respawnerà.
CharacterWalkSpeed
Questa proprietà determina il valore iniziale di Humanoid.WalkSpeed per un Giocatoredi Player.Character . Questa proprietà predefinita è 16.
Poiché questa proprietà è rilevante solo per i personaggi che verranno generati in futuro, cambiarla non cambierà alcun personaggio giocatore esistente.I cambiamenti a questa proprietà avranno effetto solo quando un giocatore respawnerà.
ClassicDeath
DevCameraOcclusionMode
Definisce come i script della fotocamera predefinita gestiscono gli oggetti tra la fotocamera e il soggetto della fotocamera.Si applica a tutti i giocatori quando si uniscono all'esperienza e non può essere cambiato per i singoli giocatori.
Il valore predefinito è Zoom (0). Vedi Enum.DevCameraOcclusionMode per un elenco dei modi disponibili.
DevComputerCameraMovementMode
Questa proprietà consente allo sviluppatore di sovrascrivere la modalità della fotocamera del Giocatorese il giocatore è su un computer.
Questa è la proprietà predefinita per i giocatori che si uniscono al Gioco. Può essere cambiata per i singoli giocatori impostando il Player.DevComputerCameraMode .
Se impostato su UserChoice , il modo di movimento della fotocamera del Giocatoresarà determinato da ciò che il giocatore ha impostato nelle impostazioni di gioco.Altrimenti, la modalità verrà impostata in base a questa Proprietà.
Vedi Enum.DevComputerCameraMovementMode per i diversi modi di fotocamera 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
Questa proprietà consente allo sviluppatore di sovrascrivere la modalità 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 singoli giocatori impostando il Player.DevComputerMovementMode .
Se impostato su UserChoice , il modo di movimento del Giocatoresarà determinato da ciò che il giocatore ha impostato nelle impostazioni di gioco.Altrimenti, la modalità verrà impostata in base a questa Proprietà.
Vedi Enum.DevComputerMovementMode per i diversi modi di movimento disponibili. Permetti allo sviluppatore di sovrascrivere la modalità 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
Questa proprietà consente allo sviluppatore di sovrascrivere la modalità della fotocamera del Giocatorese il giocatore è su un Dispositivotouch.
Questa è la proprietà predefinita per i giocatori che si uniscono al Gioco. Può essere cambiata per i singoli giocatori impostando il Player.DevTouchCameraMode .
Se impostato su UserChoice , il modo di movimento della fotocamera del Giocatoresarà determinato da ciò che il giocatore ha impostato nelle impostazioni di gioco.Altrimenti, la modalità verrà impostata in base a questa Proprietà.
Vedi Enum.DevTouchCameraMovementMode per i diversi modi di fotocamera 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
Questa proprietà consente allo sviluppatore di sovrascrivere la modalità 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 singoli giocatori impostando il Player.DevTouchMovementMode .
Se impostato su UserChoice , il modo di movimento del Giocatoresarà determinato da ciò che il giocatore ha impostato nelle impostazioni di gioco.Altrimenti, la modalità verrà impostata in base a questa Proprietà.
Vedi Enum.DevTouchMovementMode per i diversi modi di movimento disponibili. Permetti allo sviluppatore di sovrascrivere la modalità di movimento del Giocatorese il giocatore è su un Dispositivotouch.
Questa proprietà non ha alcun effetto sui giocatori non su un Dispositivotouch-abilitato.
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
Questa proprietà determina se un giocatore può attivare il blocco del mouse per impostazione predefinita.
Mouselock bloccherà il cursore del Giocatoreal centro dello schermo.Spostare il mouse ruoterà il Camera e Player si muoverà rispetto alla rotazione attuale della Telecamera.
Questa proprietà imposta il valore di Player.DevEnableMouseLock .
Si noti che le API correlate a shift-lock sono in fase 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
Questa proprietà imposta la distanza in studs in cui questo giocatore vedrà altre barre di salute Humanoid .Se impostato a 0, le barre della salute non verranno 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 della salute 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 = 0LoadCharacterAppearance
Questa proprietà imposta se l'aspetto di un personaggio del Giocatoredebba essere caricato o meno.
Impostare questo a false risulta nei giocatori senza vestiti (inclusi cappelli), colori del corpo, pacchetti del corpo o altro relativo all'aspetto dell'Avatardel Giocatore.Per impostazione predefinita, questa proprietà è impostata su true .
Impostare questo a true risulta nel caricamento dell'aspetto corrispondente all'aspetto del Giocatoredi Player.CharacterAppearanceId .
Se Player:LoadCharacterWithHumanoidDescription() viene utilizzato, può essere vantaggioso impostare StarterPlayer.LoadCharacterAppearance a false poiché l'avatar del Giocatorenon è richiesto poiché tutti gli ID delle risorse da equipaggiare sul personaggio verranno dal HumanoidDescription passato.
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 accessori di abbigliamento stratificati equipaggiati su di loro (anche se Workspace.MeshPartHeadsAndAccessories devono essere abilitati anche nel Workspace ).
LuaCharacterController
NameDisplayDistance
Imposta la distanza 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 = 0RagdollDeath
UserEmotesEnabled
Questa proprietà determina se le emote di proprietà dell'utente vengono caricate quando si caricano gli avatar.Impostare 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 caricamento delle emote è disabilitata, l'interfaccia utente delle emote funzionerà ancora finché gli sviluppatori scelgono di utilizzare la funzione delle emote aggiungendo emote all'interno del loro Gioco.
Vedi anche Emote di Avatar, un articolo che dettaglia come controllare, personalizzare e giocare alle emote di avatar.