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.
Player nesnesindeki özelliklerin varsayımlarının ayarlanmasına izin veren bir hizmet.Bir oyuncu sunucuya girdiğinde, oyuncu nesnesinin her özelliği, eşleşen özellikteki mevcut değere ayarlanır StarterPlayer .
Ayrıca, bu hizmete dört nesne ekleyebilirsiniz:
- Her oyuncu için bir kez çalışan senaryolarla bir StarterPlayerScripts örneği.
- Her oyuncunun karakterine her oluştuğunda eklemek için kodları olan bir StarterCharacterScripts örneği.
- Her oyuncunun karakteri için varsayılan insanoid olarak kullanılacak Humanoid örneğin adı StarterHumanoid olan bir örnek.
- Tüm oyuncular için karakter modeli olarak kullanılacak Model örneğin adı StarterCharacter olan bir örnek.
Özet
Özellikler
Web sitesinden özel avatar animasyonlarına ilişkin mevcut oyunun izin seviyelerini tanımlar.
Karakterin bir mobil cihazda bir engelle karşılaştığında otomatik olarak atlayıp atmayacağını ayarlar.
oyuncuvarsayılan kamerasının çıkış yapmasına izin verilen maksimum mesafe çubuklarda.
oyuncuvarsayılan kamerasının yakınlaşmasına izin verilen minimum mesafe çubuklardır.
Varsayılan kameranın modunu ilk veya üçüncü kişiye değiştirir.
Humanoid.JumpHeight için başlangıç değerini Player.Character belirler.
Humanoid.JumpPower için başlangıç değerini Player.Character belirler.
Humanoid.MaxSlopeAngle için başlangıç değerini Player.Character belirler.
Humanoid.UseJumpPower için başlangıç durumunu belirler Player.Character .
Humanoid.WalkSpeed için başlangıç değerini Player.Character belirler.
Varsayılan kamera ile oyuncu arasındaki nesnelerin nasıl ele alınacağını ayarlar.
Geliştirici, oyuncunun bir bilgisayarda olduğu takdirde her oyuncu için varsayılan kamera modunu yeniden yazsın.
Oyuncunun hareket modunu yeniden yazmasına izin verelim ki oyuncu bir bilgisayarda ise.
Geliştirici, oyuncunun bir mobil cihazda olduğu takdirde her oyuncu için varsayılan kamera hareket modunu yeniden yazsın.
Oyuncunun hareket modunu yeniden yazmasına izin verin, eğer oyuncu bir dokunma cihazında ise.
Bir oyuncunun varsayılan olarak fare kilidini değiştirebileceğini belirler.
Bu oyuncunun diğer Humanoid sağlık çubuklarını göreceği mesafeyi ayarlar. 0 olarak ayarlanırsa, sağlık çubukları görüntülenmez.
Bir oyuncunun karakterinin görünümü yüklensin veya yüklenmesin.
Deneyime yerleştirilen karakterlerin üzerinde bulunan katmanlı giyim aksesuarları olup olmadığını gösterir.
Bu oyuncunun diğer Humanoid isimlerini göreceği mesafeyi ayarlar.
Kullanıcıya ait ifadelerin avatarlar yüklendiğinde yüklenecek olup olmadığını belirler.
Özellikler
AllowCustomAnimations
Bu özellik, web sitesinden özel avatar ile ilgili mevcut oyunun izin seviyelerini tanımlar Animations .
Bu nedenle, bu değer oyundan içeriden değiştirilemez.Sadece oyunun izin seviyelerini değiştirerek oyunun ayar sayfasındaki web sitesinde değiştirilebilir.
Bu özellik oyunda kullanılmak üzere tasarlanmadı.
AutoJumpEnabled
Bu özellik, karakterin bir mobil cihazda bir engeli vurduğunda otomatik olarak atlayıp atmayacağını ayarlar.
Bu özellik, oyuna katıldıklarında StarterPlayer 'den Player 'ye kopyalanır.Bunun ardından.Bu özelliğin değeri, karakterin Humanoid üzerinde oluştuğunda Humanoid.AutoJumpEnabled özelliğine kopyalanır.Diğer bir deyişle, bu üç özellik kullanılarak her karakter, oyuncu ve oyun üzerinde otomatik atlama davranışını ayarlamak mümkündür.
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
Bu özellik, kameranın varsayılan kameralarla karakterden maksimum mesafe olabileceği uzaklığı ayarlar.
Bu özellik, oyuna katılan her oyuncu için varsayılan değeri Player.CameraMaxZoomDistance belirler.Bu değer StarterPlayer.CameraMinZoomDistance daha düşük bir değere ayarlanırsa, KameraMinZoomDistance'a yükseltilecektir.
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
Bu özellik, kameranın varsayılan kameralarla karakterden alabileceği minimum mesafeyi mil olarak ayarlar.
Bu özellik, oyuna katılan her oyuncu için varsayılan değeri Player.CameraMinZoomDistance belirler.Bu değer StarterPlayer.CameraMaxZoomDistance 'dan daha yüksek bir değere ayarlanırsa, CameraMaxZoomDistance'a düşürülecektir.
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 varsayılan değeri Player.CameraMode ayarlar. Kamera iki moda sahiptir:
İlk Kişi
İlk kişi modunda, oyuncunun kamerası tüm yola kadar yakınlaştırılır.Görünür bir GUI ile özellik seti ayarlanmış olmadığı sürece, fare kilitlenecek ve kullanıcının kamerası fare hareketleriyle dönecektir.
Üçüncü Kişi
Üçüncü kişi modunda (Varsayılan), karakter kamerada görülebilir. Roblox'ta üçüncü kişi modunda:
- Kameranızı döndürmek için sağ tıklayıp sürükleyebilir veya ekranın sağ alt kısmındaki ok tuşlarını kullanabilirsiniz.
- Farenizi hareket ettirdiğinizde, kameranız değişmez (farenizi ekranın sonuna hareket ettirmediğiniz sürece).
- Ok tuşlarından herhangi birini basınca, kullanıcının karakteri eşleşen ok tuşunun yönüne doğru yüzünecektir.
- Serbestçe yakınlaşıp uzaklaşabilirsiniz.
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
Bu özellik, bir oyuncunun için başlangıç değerini belirler. Bu özelliğin değeri 7.2 çivilere geçer.
Bu özellik yalnızca Özellikler penceresinde görünebilir, çünkü başka bir şekilde önemli olmayacaktır. StarterPlayer.CharacterUseJumpPower eğer false olarak ayarlanmazsa.
Bu özellik yalnızca gelecekte oluşturulan karakterler için önemli olduğundan, onu değiştirmek mevcut herhangi bir oyuncu karakterini değiştirmeyecektir.Bu özellikteki değişiklikler yalnızca bir oyuncu yeniden doğduğunda etkili olacaktır.
CharacterJumpPower
Bu özellik, bir oyuncunun Player.Character için başlangıç değerini belirler Humanoid.JumpPower.Bu özelliğin değeri 50 olarak varsayılır ve oyuncunun Humanoid 'sine uygulandığında 0 ile 1000 arasında sınırlandırılacaktır.
Bu özellik yalnızca Özellikler penceresinde görünebilir, çünkü başka bir şekilde önemli olmayacaktır. StarterPlayer.CharacterUseJumpPower eğer true olarak ayarlanmazsa.
Bu özellik yalnızca gelecekte oluşturulan karakterler için önemli olduğundan, onu değiştirmek mevcut herhangi bir oyuncu karakterini değiştirmeyecektir.Bu özellikteki değişiklikler yalnızca bir oyuncu yeniden doğduğunda etkili olacaktır.
CharacterMaxSlopeAngle
Bu özellik, bir oyuncunun Player.Character için başlangıç değerini belirler Humanoid.MaxSlopeAngle.Varsayılan değeri 89°'dir, böylece insansızlar varsayılan olarak istedikleri herhangi bir eğime tırmanabilir.Oyuncunun Humanoid 'sine uygulandığında, 0 ile 89 arasında sınırlandırılacaktır.
Bu özellik yalnızca gelecekte oluşturulan karakterler için önemli olduğundan, onu değiştirmek mevcut herhangi bir oyuncu karakterini değiştirmeyecektir.Bu özellikteki değişiklikler yalnızca bir oyuncu yeniden doğduğunda etkili olacaktır.
CharacterUseJumpPower
CharacterUseJumpPower bir oyuncunun Humanoid.UseJumpPower için başlangıç değerini belirler Player.Character .Bunu değiştirmek, özellikler penceresinde hangi özelliklerin görüldüğünü değiştirecektir: CharacterJumpHeight (yanlış) veya StarterPlayer.CharacterJumpPower (doğru).Varsayılan değer doğru olur.
Bu özellik yalnızca gelecekte oluşturulan karakterler için önemli olduğundan, onu değiştirmek mevcut herhangi bir oyuncu karakterini değiştirmeyecektir.Bu özellikteki değişiklikler yalnızca bir oyuncu yeniden doğduğunda etkili olacaktır.
CharacterWalkSpeed
Bu özellik, bir oyuncunun için başlangıç değerini belirler. Bu özellik 16'ya varsayılır.
Bu özellik yalnızca gelecekte oluşturulan karakterler için önemli olduğundan, onu değiştirmek mevcut herhangi bir oyuncu karakterini değiştirmeyecektir.Bu özellikteki değişiklikler yalnızca bir oyuncu yeniden doğduğunda etkili olacaktır.
ClassicDeath
DevCameraOcclusionMode
Varsayılan kamera senaryolarının kamera ve kamera konusu arasındaki nesneleri nasıl ele aldığını tanımlar.Deneyime katılan tüm oyuncular için geçerlidir ve bireysel oyuncular için değiştirilemez.
Varsayılan değer Zoom (0) dir. Mevcut modların bir listesi için Enum.DevCameraOcclusionMode bakın.
DevComputerCameraMovementMode
Bu özellik, oyuncunun bilgisayarda olduğu durumda geliştiricinin oyuncunun kamerası modunu üzer yazmasına izin verir.
Bu, oyuna katılan oyuncuların varsayılan özelliğidir. Player.DevComputerCameraMode ayarları ile bireysel oyuncular için değiştirilebilir.
UserChoice olarak ayarlanırsa, oyuncunun kamerası hareket modu oyuncunun oyun ayarlarında belirlediği her şey tarafından belirlenir.Aksi takdirde, mod bu özellik üzerine ayarlanacaktır.
Mevcut farklı kamera modları için Enum.DevComputerCameraMovementMode bakın.
Bu özellik, 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
Bu özellik, oyuncunun hareket modunu yeniden yazmasına izin verir, eğer oyuncu bir bilgisayarda ise.
Bu, oyuna katılan oyuncuların varsayılan özelliğidir. Player.DevComputerMovementMode ayarları ile bireysel oyuncular için değiştirilebilir.
UserChoice olarak ayarlanırsa, oyuncunun hareket modu oyun ayarlarında belirtilen her şey tarafından belirlenir.Aksi takdirde, mod bu özellik üzerine ayarlanacaktır.
Mevcut farklı hareket modları için Enum.DevComputerMovementMode bakın. Oyuncunun bilgisayarda olduğu durumda geliştiricinin oyuncunun hareket modunu üzer yazmasına izin verin.
Bu özellik, 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
Bu özellik, oyuncunun dokunma cihazında olduğu takdirde geliştiricinin oyuncunun kamerası modunu üzer yazmasına izin verir.
Bu, oyuna katılan oyuncuların varsayılan özelliğidir. Player.DevTouchCameraMode ayarları ile bireysel oyuncular için değiştirilebilir.
UserChoice olarak ayarlanırsa, oyuncunun kamerası hareket modu oyuncunun oyun ayarlarında belirlediği her şey tarafından belirlenir.Aksi takdirde, mod bu özellik üzerine ayarlanacaktır.
Mevcut farklı kamera modları için Enum.DevTouchCameraMovementMode bakın.
Bu özellik, mobil cihazda olmayan oyuncuları etkilemez.
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
Bu özellik, oyuncunun dokunma cihazında olduğu takdirde geliştiricinin oyuncunun hareket modunu üzer yazmasına izin verir.
Bu, oyuna katılan oyuncuların varsayılan özelliğidir. Player.DevTouchMovementMode ayarları ile bireysel oyuncular için değiştirilebilir.
UserChoice olarak ayarlanırsa, oyuncunun hareket modu oyun ayarlarında belirtilen her şey tarafından belirlenir.Aksi takdirde, mod bu özellik üzerine ayarlanacaktır.
Mevcut farklı hareket modları için Enum.DevTouchMovementMode bakın. Oyuncunun dokunma cihazında olduğu takdirde geliştiricinin oyuncunun hareket modunu üzer yazmasına izin verin.
Bu özellik, dokunma etkinleştirilmiş bir cihazda olmayan oyuncular üzerinde hiçbir 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
Bu özellik, bir oyuncunun varsayılan olarak fare kilidini değiştirebileceğini belirler.
Fare kilidi, oyuncunun kurörünü ekranın merkezine kilitleyecektir.Fare hareket ettirildiğinde, Camera ve Player kameranın mevcut dönüşüne göre hareket edecek.
Bu özellik Player.DevEnableMouseLock 'nin değerini ayarlar.
Vurgu kilidi ile ilgili API'lerin yeniden düşürülme sürecinde olduğunu unutmayın, bu yüzden fareyi kilitlemek için UserInputService.MouseBehavior yerine kullanmanız ö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, bu oyuncunun diğer Humanoid sağlık çubuklarını göreceği mesafeyi milimetre olarak ayarlar.0 olarak ayarlanırsa, sağlık çubukları görüntülenmez.Bu özellik varsayılan olarak 100 damga ile ayarlanır.
Bir oyuncu oyuna katıldıktan sonra görüntü mesafesini değiştirmek için, Player.HealthDisplayDistance özelliğini ayarlayabilirsiniz.
Bir Humanoid sağlık çubuğu görülebilirse, görüntüleme türünü 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 = 0LoadCharacterAppearance
Bu özellik, bir oyuncunun karakterinin görünümünün yüklenecek olup olmadığını belirler.
Bunu false olarak ayarlamak, oyuncunun hiç kıyafeti olmamasına (şapkalar dahil), vücut renkleri, vücut paketleri veya oyuncunun avatarının görünümüyle bağlantılı herhangi bir şeye neden olur.Varsayılan olarak, bu özellik true olarak ayarlanır.
Bunu true sonucuna ayarlamak, oyuncunun oyuncunun Player.CharacterAppearanceId ile eşleşen görünümünü yüklemesine neden olur.
kullanılırsa, oyuncunun avatarının tüm varlık kimliklerinin karakterde kullanılması gerekmediği için olarak yanlış ayarlanması avantajlı 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
Deneyime giren karakterlerin üzerinde bulunan katmanlı giyim aksesuarları olup olmadığını gösterir (Yine de da etkinleştirilmesi gerekir).
LuaCharacterController
NameDisplayDistance
Bu oyuncunun diğer Humanoid isimlerini göreceği mesafeyi ayarlar.0 olarak ayarlanırsa, isimler gizlenir.Bu özellik varsayılan olarak 100 vida ile ayarlanır.
Bir oyuncu oyuna katıldıktan sonra görüntü mesafesini değiştirmek için, Player.NameDisplayDistance özelliğini ayarlayabilirsiniz.
Bir Humanoid ismi görülebilirse, görüntüleme türünü 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 = 0RagdollDeath
UserEmotesEnabled
Bu özellik, kullanıcıya ait emojilerin avatarlar yüklendiğinde yüklenecek olup olmadığını belirler.Bu özelliği yanlış olarak ayarlamak yüklemeyi devre dışı bırakır.Geliştiriciler, özelliği doğrudan Studio'da veya Oyun Ayarları menüsü aracılığıyla ayarlayabilir.
İfade yükleme devre dışı bırakıldığında, geliştiriciler oyunlarında emote özelliğini kullanmayı seçtikleri sürece emote UI hala çalışacaktır.
Ayrıca bakın Avatar İfadeleri , avatar ifadelerini nasıl kontrol edeceğinizi, özelleştireceğinizi ve oynayacağınızı detaylandıran bir makale.