StarterPlayer
*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.
Özelliklerin Player nesnesinin varsayılanlarının belirlenmesine izin veren bir hizmet. Bir oyuncu sunucuya girdiğinde, oyuncu nesnesinin her bir özelliği StarterPlayer nesnesinin mevcut değerine ayarlanır.
Ayrıca, bu hizmete dört nesne ekleyebilirsiniz:
- Her oyuncu için bir StarterPlayerScripts instance ile kodların çalışmasını sağlayan bir Class.StarterPlayerScripts scripti.
- Her oyuncu oluştuklarında oyuncu karakterlerine eklenebilecek StarterCharacterScripts bir instans.
- Her oyuncu karakterinin varsayılan humanoid'i için kullanılan Humanoid adlı bir StarterHumanoid instansı.
- Tüm oyuncular için karakter modeli olarak kullanılacak bir Model instansı olan StarterCharacter .
Özet
Özellikler
Web sitesinden özel avatar animasyonları için mevcut oyunun izin seviyelerini açıklar.
Mobil bir cihazda bir engelle karşılaşırken karakterin otomatik olarak atlayacağını ayarlar.
oyuncuvarsayılan kamerasının maksimum mesafe katlanabilir.
Oyuncunun varsayılan kamerasının minimum mesafesi oyuncunun mesafesine izin verilir.
Varsayılan kameranın modunu ilk veya üçüncü kişiye ayarlar.
Class.Player.Character için Player.Character başlangıç değerini belirler.
Class.Player.Character için Player.Character başlangıç değerini belirler.
Class.Player.Character için Player.Character ile başlangıç değerini belirler.
Class.Humanoid.UseJumpPower için Player.Character için başlangıç durumunu belirler.
Class.Player.Character için Player.Character başlangıç değerini belirler.
Kameranın ve oyuncunun arasındaki nesneleri nasıl varsayılan kameranın oyuncuya verdiği nesneleri ayarlar.
Oyuncu bir bilgisayarda ise oyuncunun varsayılan kamerası modunu üzerwrite etmeyi lütfen geliştiriciler yapın.
Oyuncu bir bilgisayarda ise oyuncunun hareket modunu geliştirici yazılımıyla üzerwrite edelim.
Oyuncu bir mobil cihazda ise oyuncunun varsayılan kamerası hareket modunu üzerwriteyelim.
Oyuncu bir dokunmatik cihazda ise oyuncunun hareket modunu geliştirici yazılımıyla yazılır.
Oyuncunun mouse kilidini varsayılan olarak ayarlar/kaldırır.
Bu oyuncunun diğer Humanoid sağlık çubuklarını göreceği mesafe ayarlarını ayarlar. 0'a ayarlandığında sağlık çubukları görünmez.
Bir oyuncunun karakterinin görünümü yüklenmeli veya yüklenmez.
Karakterlerin bir deneyime oluşturulup olmadığına bağlı olarak katmanlı kıyafet aksesuarları takıp takmayacağını gösterir.
Bu oyuncunun diğer Humanoid isimlerini göreceği mesafeyi ayarlar. Eğer 0 olarak ayarlandıysa, isimler gizlenir.
Kullanıcı tarafından yüklenen emoteleri avatar yüklenirken yüklenip yüklenmediğini belirler.
Özellikler
AllowCustomAnimations
AllowCustomAnimations özelliği, web sitesinden özel avatar Animations ile ilgili mevcut oyun izin seviyelerini açıklar.
Bu nedenle, bu değer oyun içinde değiştirilemez. Sadece oyunun izin seviyelerini değiştirerek oyunun ayarlarının sayfasındaki oyun izin seviyelerini değiştirebilirsiniz.
Bu özellik oyun içinde kullanılmak üzere değildir.
AutoJumpEnabled
AutoJumpEnabled özelliği, bir mobil cihazda bir engelle vurduğunda karakterin otomatik olarak zıplacağını belirler.
Bu özellik StarterPlayer dan bir Player eğer oyuna katıldığında kopyalanır. Bu takip edildiğinde. bu özelliğin değeri Humanoid.AutoJumpEnabled özelliğinin değeri kopyalanı
Kod Örnekleri
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
The CameraMaxZoomDistance özelliği, kamera'nın varsayılan kameralardan karakterle maksimum mesafeyi belirler.
Bu özellik, oyuna katılan her oyuncu için Player.CameraMaxZoomDistance 'yi varsayılana ayarlar. Eğer bu değer StarterPlayer.CameraMinZoomDistance 'den daha düşük olursa, CameraMinZoomDistance'e artırılır.
Kod Örnekleri
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
The CameraMinZoonDistance özelliği, kamera'nın varsayılan kameralardan karakter ile olan minimum mesafeyi belirler.
Bu özellik, oyuna katılan her oyuncu için Player.CameraMinZoomDistance 'yi varsayılana ayarlar. Eğer bu değer StarterPlayer.CameraMaxZoomDistance 'den daha yüksek bir değer olursa, KameramaxZoomDistance'e azaltılır.
Kod Örnekleri
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
Oyundaki her oyuncu için Player.CameraMode için varsayılan değeri ayarlar. Kameranın iki modu vardır:
Birinci Kişisel
İlk kişisel modunda, oyuncunun kamerası tüm yol boyunca yuvarlanır. GuiButton.Modal özelliği, true özelliği ile bir GUI görünümü sunulmadığından, oyuncu fareyi hareket ettirirken kilitlenir ve kamerası kameranın hareketiyle dönecektir.
Üçüncü Kişi
Üçüncü kişi modunda (Varsayılan), karakter kamerada görülebilir. Roblox'ta üçüncü kişi modunda olduğunuzda:
- Kameranızı döndürmek için sağ tıklayıp sürükle veya ekranın sağ kısmındaki okluk tuşlarını kullan.
- fare'unuzu hareket ettirirseniz, kameranız değişmez (eğer mouse'ı ekranın sonuna kadar hareket ettirirseniz).
- Okluk tuşlarından herhangi birine basarsanız, kullanıcının karakteri eşdeğer okluk anahtaryönünde karşılaşacaktır.
- Serbest olarak yakınlaştırın veya uzaklaştırın.
Kod Örnekleri
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 , bir oyuncunun Humanoid.JumpHeight için başlangıç değerini belirler. Bu özelliğin değeri varsayılır olarak 7.2 saniye değerindedir.
Bu özellik sadece Özellikler penceresinde görünür, çünkü aksi takdirde yanlış olurdu.
Bu özellik sadece gelecekte oluşturulan karakterler için alanın değerini değiştirme işlemi yapılır, böylece mevcut bir oyuncu karakterini etkilemez. Bu özellik değiştirilmesi sadece bir oyuncu yeniden doğduğunda etkili olacaktır.
CharacterJumpPower
CharacterJumpPower bir oyuncunun Humanoid.JumpPower için başlangıç değerini belirler. Bu özelliğin değeri varsayılır olarak 50'dir, ancak Character a uygulandığında, değer 0 ile 1000 arasında sı
Bu özellik sadece Özellikler penceresinde görünür, çünkü aksi takdirde yanlış olurdu.
Bu özellik sadece gelecekte oluşturulan karakterler için alanın değerini değiştirme işlemi yapılır, böylece mevcut bir oyuncu karakterini etkilemez. Bu özellik değiştirilmesi sadece bir oyuncu yeniden doğduğunda etkili olacaktır.
CharacterMaxSlopeAngle
CharacterMaxSlopeAngle bir oyuncunun Humanoid.MaxSlopeAngle için başlangıç değerini belirler. Standart olarak 89°'lik bir humanoid'in herhangi bir tepede tırmanabilmesi için maksimum 7°'lik bir eğilme değeri vardır. U
Bu özellik sadece gelecekte oluşturulan karakterler için alanın değerini değiştirme işlemi yapılır, böylece mevcut bir oyuncu karakterini etkilemez. Bu özellik değiştirilmesi sadece bir oyuncu yeniden doğduğunda etkili olacaktır.
CharacterUseJumpPower
CharacterUseJumpPower``Class.Humanoid.UseJumpPower için oyuncunun başlangıç değerini belirler. Eğer Character değerini değiştirir, özellikler
Bu özellik sadece gelecekte oluşturulan karakterler için alanın değerini değiştirme işlemi yapılır, böylece mevcut bir oyuncu karakterini etkilemez. Bu özellik değiştirilmesi sadece bir oyuncu yeniden doğduğunda etkili olacaktır.
CharacterWalkSpeed
CharacterWalkSpeed bir oyuncunun Humanoid.WalkSpeed için başlangıç değerini belirler. Bu özellik varsayılır olarak 16'ya ayarlanır.
Bu özellik sadece gelecekte oluşturulan karakterler için alanın değerini değiştirme işlemi yapılır, böylece mevcut bir oyuncu karakterini etkilemez. Bu özellik değiştirilmesi sadece bir oyuncu yeniden doğduğunda etkili olacaktır.
DevCameraOcclusionMode
Varsayılan kamerasının kullanıcılar arasında kamerası ve kamerası arasındaki nesneleri nasıl ele alacağını tanımlar. Tüm oyuncular katılırken deneyime ve kameraya bağlı olarak değiştirilemez.
Varsayılan değer, Zoom (0) dir. Aşağıdaki mod listesini görmek için Enum.DevCameraOcclusionMode eşine bakın.
DevComputerCameraMovementMode
The DevComputerCameraMovementMode özelliği, oyuncu bir bilgisayarda ise oyuncunun kamerasını üzerinde geliştirme modunu oluşturur.
Oyuna katılan oyuncular için varsayılan özelliktir. Player.DevComputerCameraMode ayarlarına göre bireysel oyuncular için değiştirilebilir.
Enüm.DevComputerCameraMovementMode|UserChoice olarak ayarlandıysa, oyuncunun kamerası hareket modu oyun ayarlarında belirlenir. Aksi takdirde, mod bu özellik üzerine ayarlanır.
Mevcut kameralar için Enum.DevComputerCameraMovementMode bakın.
Bu özellik, bir bilgisayarda olmayan oyuncular üzerinde hiçbir etkisi yoktur.
Kod Örnekleri
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
The DevComputerMovementMove özelliği, oyuncunun bir bilgisayarda olduğu durumda oyuncunun hareket modunu geliştiriciye yazma izni verir.
Oyuna katılan oyuncular için varsayılan özelliktir. Player.DevComputerMovementMode ayarlarına göre bireysel oyuncular için değiştirilebilir.
Amount.DevComputerMovementMode|UserChoice şeklinde ayarlandıysa, oyuncunun hareket modu oyun ayarlarında belirlenir. Aksi takdirde, mod bu özellikte belirlenir.
Disponible different hareket modları için Enum.DevComputerMovementMode görün. Oyuncu bir bilgisayarda ise oyuncu hareket modunu geliştiricilerin yazmasını sağlayalım.
Bu özellik, bir bilgisayarda olmayan oyuncular üzerinde hiçbir etkisi yoktur.
Kod Örnekleri
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
The DevTouchCameraMovementMode özelliği, oyuncu bir dokunmatik cihazda ise oyuncunun kamerasını üzerinde geliştirme izin verir.
Oyuna katılan oyuncular için varsayılan özelliktir. Player.DevTouchCameraMode ayarlarına göre bireysel oyuncular için değiştirilebilir.
Enums.DevTouchCameraMovementMode|UserChoice ile ayarlandıysa, oyun ayarlarında belirlenen oyuncu kamera hareket modu kullanıcının seçtiği şeyle belirlenir. Aksi takdirde, mod bu özellik üzerine ayarlanacaktır.
Mevcut kameralar için Enum.DevTouchCameraMovementMode bakın.
Bu özellik, mobil bir cihazda olmayan oyunculara etki etmez.
Kod Örnekleri
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
The DevTouchMovementMode özelliği, oyuncunun bir dokunmatik cihazda olduğunda oyuncunun hareket modunu geliştiriciye yazma izni verir.
Oyuna katılan oyuncular için varsayılan özelliktir. Player.DevTouchMovementMode ayarlarına göre bireysel oyuncular için değiştirilebilir.
Enum.DevTouchMovementMode|UserChoice olarak ayarlandıysa, oyuncunun hareket modu oyun ayarlarında belirlenir. Aksi takdirde, mod bu özellikte belirlenir.
Disponible different hareket modları için Enum.DevTouchMovementMode görün. Lets geliştiricilerinin oyuncunun hareket modunu yazdırır eğer o bir dokunmatik cihazda ise.
Bu özellik, dokunmatik bir cihazda olmayan oyunculara etkisi yoktur.
Kod Örnekleri
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
EnableMouseLockOption özelliği, bir oyuncunun varsayılan olarak mause kilidini değiştirebilirip değiştiremeyeceğini belirler.
Mouselock, oyuncunun kurdeğerini ekranın merkezine kilitlecek. Mouse'ı hareket ettirerek Camera ve Player kamera ile ilgili mevcut dönüşümü dönecek.
Bu özellik Player.DevEnableMouseLock 'in değerini ayarlar.
Shift-lock ilgili API'lerin depreciyon sürecinde olduğunu unutmayın, bu nedenle fare'ı kilitlemek için UserInputService.MouseBehavior yerine kullanılması önerilir.
Kod Örnekleri
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
Bu özellik, HealthDisplayDistance derinliği, bu oyuncuğun diğer Humanoid sağlık çubuklarını göreceği mesafeyi milim olarak ayarlar. Eğer 0 olarak ayarlandıysa, sağlık çubukları görüntülenmez. Bu özellik, varsayılan olarak 100 milim olarak ayarlandı.
Bir oyuncunun oyuna katıldığında görüntü mesafesini değiştirmek için Player.HealthDisplayDistance özelliğini ayarlayabilirsiniz.
Eğer bir Humanoid sağlık çubuğu görünürse, Humanoid.DisplayDistanceType kullanarak görüntü türünü ayarlayabilirsiniz.
Kod Örnekleri
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
oyuncukarakterinin görünümü LoadCharacterAppearance özelliği tarafından yüklenecek veya yüklenmeyecek.
Bu değeri false ile ayarlamak, oyuncunun hiç kıyafeti olmadığı (şapkalar dahil) beden rengi, beden paketleri veya oyuncunun avatarının görünümüyle ilgili herhangi bir şeyi olmayan sonuçlar verir.Varsayılan olarak, bu özellik true olarak ayarlanır.
Bunu true ile ayarlarsanız oyuncu Player.CharacterAppearanceId ile eşleşen görünümü yükler.
Eğer Player:LoadCharacterWithHumanoidDescription() kullanılırsa, oyuncunun avatarının tüm varlık ID'leri üzerindeki tüm eşyaların donanılması gerekmediğinden, StarterPlayer.LoadCharacterAppearance iletken olabilir.
Kod Örnekleri
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
Karakterlerin bir deneyime oluşturulmasında katmanlı kıyafet aksesuarlarının olup olmadığını gösterir (Workspace.MeshPartHeadsAndAccessories .
LuaCharacterController
NameDisplayDistance
Bu oyuncunun diğer Humanoid isimlerini göreceği mesafeyi ayarlar. Eğer 0 olarak ayarlandıysa, isimler gizlenir.
İsimGöstermeMesafesi StarterPlayer özelliği, bu oyuncunun diğer Humanoid isimlerini göreceği mesafeyi milim olarak ayarlar. Eğer 0 değerine ayarlandıysa, isimler gizlenir. Bu özellik, varsayılan olarak 100 mili olarak ayarlandı.
Bir oyuncunun oyuna katıldığında görüntü mesafesini değiştirmek için Player.NameDisplayDistance özelliğini ayarlayabilirsiniz.
Eğer bir Humanoid ismi görünürse, görüntü tipini Humanoid.DisplayDistanceType kullanarak ayarlayabilirsiniz.
Kod Örnekleri
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
Bu özellik, avatar'lar yüklenirken kullanıcı emotesi yüklenip yüklenmediğini belirler. Bu özelliği "Hayır" olarak ayarlarsanız yüklemeyi devre dışı bırakırsınız. Geliştiriciler Studio'da bu özelliği doğrudan veya Oyun Ayarları menüsünden değiştirebilirler.
Emote yüklemeyi devre dışı bırakırsanız, emote UI'i oyunlarının içine emote'i ekleyerek emote özelliğini kullanmanıza izin veren geliştiricilerin seçimine bağlı olarak hala çalışır.
Ayrıca bakınız Avatar Emotes, avatar emotes'i nasıl kontrol, özelleştir ve oynayacağınızı açıklayan bir makale.