StarterPlayer

Visualizza obsoleti

*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.

Non costruibile
Assistenza

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à

Proprietà

AllowCustomAnimations

Nascosto
Sicurezza Script Roblox
Lettura Parallela

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

Lettura Parallela

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

Auto-Jump Toggle

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

Non Replicato
Non programmabile
Non Navigabile
Lettura Parallela

CameraMaxZoomDistance

Lettura Parallela

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

Setting Camera Zoom Distance

local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.CameraMaxZoomDistance = 50
player.CameraMinZoomDistance = 75

CameraMinZoomDistance

Lettura Parallela

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

Setting Camera Zoom Distance

local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.CameraMaxZoomDistance = 50
player.CameraMinZoomDistance = 75

CameraMode

Lettura Parallela

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

Playing in First Person

local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.CameraMode = Enum.CameraMode.LockFirstPerson

CharacterJumpHeight

Lettura Parallela

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

Lettura Parallela

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

Lettura Parallela

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

Lettura Parallela

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

Lettura Parallela

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

Lettura Parallela

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

Lettura Parallela

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

Setting a Player's Camera Movement Mode (Desktop)

local Players = game:GetService("Players")
local player = Players.LocalPlayer
-- Set the player's camera movement mode on computers to classic
player.DevComputerCameraMode = Enum.DevComputerCameraMovementMode.Classic

DevComputerMovementMode

Lettura Parallela

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

Setting a Player's Movement Mode (Desktop)

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

Lettura Parallela

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

Setting a Player's Camera Movement Mode (Touch)

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.Classic

DevTouchMovementMode

Lettura Parallela

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

Setting a Player's Movement Mode (Touch)

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

Non programmabile
Lettura Parallela

EnableMouseLockOption

Lettura Parallela

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

Enabling a Player's Mouse Lock

local Players = game:GetService("Players")
local player = Players.LocalPlayer
while true do
player.DevEnableMouseLock = not player.DevEnableMouseLock
task.wait(5)
end

HealthDisplayDistance

Lettura Parallela

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

Hiding Player Health and Names

local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.HealthDisplayDistance = 0
player.NameDisplayDistance = 0

LoadCharacterAppearance

Lettura Parallela

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

Disabling a Player's Appearance

local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.CanLoadCharacterAppearance = false

LoadCharacterLayeredClothing

Non Replicato
Non programmabile
Lettura Parallela

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

Non Navigabile
Lettura Parallela

NameDisplayDistance

Lettura Parallela

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

Hiding Player Health and Names

local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.HealthDisplayDistance = 0
player.NameDisplayDistance = 0

UserEmotesEnabled

Lettura Parallela

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.

Metodi

Eventi