StarterPlayer

Tampilkan yang Tidak Digunakan Lagi

*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.

Tidak Dapat Dibuat
Layanan

Sebuah layanan yang memungkinkan default properti di objek Player untuk ditetapkan.Ketika pemain memasuki server, setiap properti objek pemain diatur ke nilai saat ini dari properti yang sesuai di StarterPlayer .

Selain itu, Anda dapat menambahkan empat objek ke layanan ini:

  • Sebuah instansi StarterPlayerScripts dengan skrip yang berjalan sekali untuk setiap pemain.
  • Sebuah instansi StarterCharacterScripts dengan skrip untuk menambahkan ke karakter setiap pemain setiap kali mereka muncul.
  • Sebuah instansi Humanoid yang bernama StarterHumanoid yang akan digunakan sebagai humanoid default untuk karakter setiap pemain.
  • Sebuah instansi Model yang bernama StarterCharacter yang akan digunakan sebagai model karakter untuk semua pemain.

Rangkuman

Properti

Lihat semua yang diwarisi dari Instance
Lihat semua yang diwarisi dari Object

Properti

AllowCustomAnimations

boolean
Tersembunyi
Keamanan Skrip Roblox
Baca Paralel

Properti ini menggambarkan tingkat izin gamesaat ini mengenai avatar kustom dari situs web.

Dengan demikian, nilai ini tidak dapat diubah dari dalam game.Ini hanya dapat diubah dengan mengubah tingkat izin gamedalam halaman pengaturan gamedi situs web.

Properti ini tidak dimaksudkan untuk digunakan dalam game.

AutoJumpEnabled

boolean
Baca Paralel

Properti ini menentukan apakah karakter akan secara otomatis melompat saat menabrakkan hambatan di perangkat seluler.

Properti ini dicopy dari StarterPlayer ke Player ketika mereka bergabung dengan permainan.Setelah itu.nilai properti ini dicopy ke properti karakter pada saat spawn.Dengan kata lain, adalah mungkin untuk mengatur perilaku lompat otomatis pada basis per karakter, per pemain, dan per game menggunakan tiga properti ini.

Contoh Kode

Sampel kode ini dimaksudkan untuk Tombol Teks. Ini memungkinkan pemain untuk menyalakan perilaku lompat otomatis saat berada di perangkat seluler.

Toggle Lompat Otomatis
local Players = game:GetService("Players")



local player = Players.LocalPlayer

local button = script.Parent



local function update()

	-- Teks tombol pembaruan

	if player.AutoJumpEnabled then

		button.Text = "Auto-Jump is ON"

	else

		button.Text = "Auto-Jump is OFF"

	end

	-- Tampilkan properti dalam karakter pemain, jika mereka memilikinya

	if player.Character then

		local human = player.Character:FindFirstChild("Humanoid")

		if human then

			human.AutoJumpEnabled = player.AutoJumpEnabled

		end

	end

end



local function onActivated()

	-- Aktifkan lompat otomatis

	player.AutoJumpEnabled = not player.AutoJumpEnabled

	-- Perbarui semua yang lain

	update()

end



button.Activated:Connect(onActivated)

update()

AvatarJointUpgrade

Enum.RolloutState
Tidak Direplikasi
Tidak Dapat Ditulis Skripnya
Tidak Dapat Dijelajahi
Baca Paralel

CameraMaxZoomDistance

number
Baca Paralel

Properti ini mengatur jarak maksimum dalam stud kamera dapat dari karakter dengan kamera default.

Properti ini menetapkan nilai default Player.CameraMaxZoomDistance untuk setiap pemain yang bergabung dengan game.Jika nilai ini ditetapkan ke nilai yang lebih rendah dari StarterPlayer.CameraMinZoomDistance maka akan ditingkatkan ke CameraMinZoomDistance.

Contoh Kode

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.

Setting Camera Zoom Distance
local Players = game:GetService("Players")



local player = Players.LocalPlayer



player.CameraMaxZoomDistance = 50

player.CameraMinZoomDistance = 75

CameraMinZoomDistance

number
Baca Paralel

Properti ini menetapkan jarak minimum dalam stud kamera dapat dari karakter dengan kamera default.

Properti ini menetapkan nilai default Player.CameraMinZoomDistance untuk setiap pemain yang bergabung dengan game.Jika nilai ini ditetapkan ke nilai yang lebih tinggi dari StarterPlayer.CameraMaxZoomDistance maka akan dikurangi menjadi CameraMaxZoomDistance.

Contoh Kode

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.

Setting Camera Zoom Distance
local Players = game:GetService("Players")



local player = Players.LocalPlayer



player.CameraMaxZoomDistance = 50

player.CameraMinZoomDistance = 75

CameraMode

Enum.CameraMode
Baca Paralel

Tetapkan nilai default untuk Player.CameraMode untuk setiap pemain dalam game. Kamera memiliki dua mode:

Orang Pertama

Di mode orang pertama, kamera pemain diperbesar sepanjang jalan.Kecuali ada GUI yang terlihat hadir dengan set properti , mouse akan dikunci dan kamera pengguna akan berubah saat mouse bergerak.

Orang Ketiga

Dalam mode orang ketiga (默认), karakter dapat dilihat di kamera. Sementara dalam mode orang ketiga di Roblox:

  • Anda dapat mengklik kanan dan seret untuk memutar kamera Anda, atau gunakan tombol panah di sudut kanan bawah layar.
  • Ketika Anda menggerakkan mouse, kamera Anda tidak berubah (kecuali jika Anda menggerakkan mouse ke ujung layar).
  • Ketika Anda menekan salah satu tombol panah, karakter pengguna akan menghadap ke arah tombol unityang sesuai.
  • Anda dapat memperbesar dan memperkecil dengan bebas.

Contoh Kode

This example demonstrates how to change the character's CameraMode to first person using the LockFirstPerson value of the Enum.CameraMode enum.

Playing in First Person
local Players = game:GetService("Players")



local player = Players.LocalPlayer



player.CameraMode = Enum.CameraMode.LockFirstPerson

CharacterJumpHeight

number
Baca Paralel

Properti ini menentukan nilai awal dari Humanoid.JumpHeight untuk pemain Player.Character . Nilai properti ini default ke 7,2 stud.

Properti ini hanya terlihat di jendela Properti jika StarterPlayer.CharacterUseJumpPower diatur ke false , karena tidak akan relevan jika tidak demikian.

Karena properti ini hanya relevan untuk karakter yang dibuat di masa depan, mengubahnya tidak akan mengubah karakter pemain yang ada.Perubahan pada properti ini hanya akan berlaku saat pemain bereinkarnasi.

CharacterJumpPower

number
Baca Paralel

Properti ini menentukan nilai awal dari Humanoid.JumpPower untuk pemain Player.Character .Nilai properti ini default ke 50 dan saat diterapkan ke Humanoid pemain, itu akan dibatasi antara 0 dan 1000.

Properti ini hanya terlihat di jendela Properti jika StarterPlayer.CharacterUseJumpPower diatur ke true , karena tidak akan relevan jika tidak demikian.

Karena properti ini hanya relevan untuk karakter yang dibuat di masa depan, mengubahnya tidak akan mengubah karakter pemain yang ada.Perubahan pada properti ini hanya akan berlaku saat pemain bereinkarnasi.

CharacterMaxSlopeAngle

number
Baca Paralel

Properti ini menentukan nilai awal dari Humanoid.MaxSlopeAngle untuk pemain Player.Character .Ini default ke 89°, sehingga humanoid dapat naik hampir semua lereng yang mereka inginkan secara default.Ketika diterapkan ke Humanoid pemain, itu akan dibatasi antara 0 dan 89.

Karena properti ini hanya relevan untuk karakter yang dibuat di masa depan, mengubahnya tidak akan mengubah karakter pemain yang ada.Perubahan pada properti ini hanya akan berlaku saat pemain bereinkarnasi.

CharacterUseJumpPower

boolean
Baca Paralel

CharacterUseJumpPower menentukan nilai awal dari Humanoid.UseJumpPower untuk pemain Player.Character .Mengalihkann akan mengubah properti mana yang terlihat di jendela properti: CharacterJumpHeight (salah) atau StarterPlayer.CharacterJumpPower (benar).Default ke benar.

Karena properti ini hanya relevan untuk karakter yang dibuat di masa depan, mengubahnya tidak akan mengubah karakter pemain yang ada.Perubahan pada properti ini hanya akan berlaku saat pemain bereinkarnasi.

CharacterWalkSpeed

number
Baca Paralel

Properti ini menentukan nilai awal dari Humanoid.WalkSpeed untuk pemain Player.Character . Properti ini default ke 16.

Karena properti ini hanya relevan untuk karakter yang dibuat di masa depan, mengubahnya tidak akan mengubah karakter pemain yang ada.Perubahan pada properti ini hanya akan berlaku saat pemain bereinkarnasi.

ClassicDeath

boolean
Tidak Dapat Dijelajahi
Baca Paralel

DevCameraOcclusionMode

Enum.DevCameraOcclusionMode
Baca Paralel

Mendefinisikan bagaimana skrip kamera default menangani objek antara kamera dan subjek kamera.Berlaku untuk semua pemain saat mereka bergabung dengan pengalaman dan tidak dapat diubah untuk pemain individual.

Nilai default adalah Zoom (0). Lihat Enum.DevCameraOcclusionMode untuk daftar mode yang tersedia.

DevComputerCameraMovementMode

Enum.DevComputerCameraMovementMode
Baca Paralel

Properti ini memungkinkan pengembang menulis ulang mode kamera pemain jika pemain berada di komputer.

Ini adalah properti default untuk pemain yang bergabung dengan game. Ini dapat diubah untuk pemain individu dengan mengatur Player.DevComputerCameraMode .

Jika diatur ke UserChoice maka mode gerakan kamera pemain akan ditentukan oleh apa pun yang dipilih pemain dalam pengaturan permainan.Jika tidak, mode akan ditetapkan berdasarkan properti ini.

Lihat Enum.DevComputerCameraMovementMode untuk berbagai mode kamera yang tersedia.

Properti ini tidak mempengaruhi pemain yang tidak berada di komputer.

Contoh Kode

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.

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

Enum.DevComputerMovementMode
Baca Paralel

Properti ini memungkinkan pengembang menulis ulang mode gerakan pemain jika pemain berada di komputer.

Ini adalah properti default untuk pemain yang bergabung dengan game. Ini dapat diubah untuk pemain individu dengan mengatur Player.DevComputerMovementMode .

Jika ditetapkan ke UserChoice maka mode gerakan pemain akan ditentukan oleh apa pun yang dipilih pemain dalam pengaturan permainan.Jika tidak, mode akan ditetapkan berdasarkan properti ini.

Lihat Enum.DevComputerMovementMode untuk berbagai mode gerakan yang tersedia. Biarkan pengembang menulis ulang mode gerakan pemain jika pemain berada di komputer.

Properti ini tidak mempengaruhi pemain yang tidak berada di komputer.

Contoh Kode

Demonstrates how to set the movement mode for players on computers using the Player.DevComputerMovementMode property.

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

Enum.DevTouchCameraMovementMode
Baca Paralel

Properti ini memungkinkan pengembang menulis ulang mode kamera pemain jika pemain berada di perangkat sentuh.

Ini adalah properti default untuk pemain yang bergabung dengan game. Ini dapat diubah untuk pemain individu dengan mengatur Player.DevTouchCameraMode .

Jika diatur ke UserChoice maka mode gerakan kamera pemain akan ditentukan oleh apa pun yang dipilih pemain dalam pengaturan permainan.Jika tidak, mode akan ditetapkan berdasarkan properti ini.

Lihat Enum.DevTouchCameraMovementMode untuk berbagai mode kamera yang tersedia.

Properti ini tidak mempengaruhi pemain tidak di perangkat seluler.

Contoh Kode

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.

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

Enum.DevTouchMovementMode
Baca Paralel

Properti ini memungkinkan pengembang menulis ulang mode gerakan pemain jika pemain berada di perangkat sentuh.

Ini adalah properti default untuk pemain yang bergabung dengan game. Ini dapat diubah untuk pemain individu dengan mengatur Player.DevTouchMovementMode .

Jika ditetapkan ke UserChoice maka mode gerakan pemain akan ditentukan oleh apa pun yang dipilih pemain dalam pengaturan permainan.Jika tidak, mode akan ditetapkan berdasarkan properti ini.

Lihat Enum.DevTouchMovementMode untuk berbagai mode gerakan yang tersedia. Biarkan pengembang menulis ulang mode gerakan pemain jika pemain berada di perangkat sentuh.

Properti ini tidak mempengaruhi pemain yang tidak berada di perangkat yang dapat disentuh.

Contoh Kode

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.

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

Enum.LoadDynamicHeads
Tidak Dapat Ditulis Skripnya
Baca Paralel

EnableMouseLockOption

boolean
Baca Paralel

Properti ini menentukan apakah pemain dapat menyalakan kunci mouse secara default.

Mouselock akan mengunci kursor pemain ke tengah layar.Memindahkan mouse akan memutar Camera dan Player akan bergerak relatif terhadap rotasi kamera saat ini.

Properti ini mengatur nilai Player.DevEnableMouseLock .

Perhatikan bahwa API terkait shift-lock berada dalam proses dihapuskan, jadi disarankan untuk menggunakan UserInputService.MouseBehavior sebagai gantinya untuk mengunci mouse.

Contoh Kode

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.

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

number
Baca Paralel

Properti ini menetapkan jarak dalam stud di mana pemain ini akan melihat bar kesehatan lain Humanoid.Jika diatur ke 0, bilah kesehatan tidak akan ditampilkan.Properti ini diatur ke 100 studs secara default.

Untuk mengubah jarak tampilan untuk pemain setelah mereka bergabung dengan game, Anda dapat mengatur properti Player.HealthDisplayDistance.

Jika bilah kesehatan Humanoid terlihat, Anda dapat mengatur jenis tampilan menggunakan Humanoid.DisplayDistanceType .

Contoh Kode

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.

Hiding Player Health and Names
local Players = game:GetService("Players")



local player = Players.LocalPlayer



player.HealthDisplayDistance = 0

player.NameDisplayDistance = 0

LoadCharacterAppearance

boolean
Baca Paralel

Properti ini menentukan apakah tampilan karakter pemain harus dimuat atau tidak.

Mengatur ini ke false hasil pemain tidak memiliki pakaian (termasuk topi), warna tubuh, paket tubuh, atau apa pun yang terkait dengan penampilan avatar pemain.Secara default, properti ini diatur ke true .

Mengatur ini ke true hasil pemain memuat penampilan yang sesuai dengan penampilan pemain Player.CharacterAppearanceId .

Jika Player:LoadCharacterWithHumanoidDescription() digunakan, bisa menjadi menguntungkan untuk mengatur StarterPlayer.LoadCharacterAppearance ke false karena avatar pemain tidak diperlukan sebagai semua ID aset untuk dilengkapi pada karakter berasal dari HumanoidDescription yang dikirimkan.

Contoh Kode

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.

Disabling a Player's Appearance
local Players = game:GetService("Players")



local player = Players.LocalPlayer



player.CanLoadCharacterAppearance = false

LoadCharacterLayeredClothing

Enum.LoadCharacterLayeredClothing
Tidak Direplikasi
Tidak Dapat Ditulis Skripnya
Baca Paralel

Menunjukkan apakah karakter yang muncul ke dalam pengalaman akan memiliki aksesori pakaian berlapis yang dilengkapi pada mereka (Meskipun Workspace.MeshPartHeadsAndAccessories juga perlu diaktifkan di Workspace ).

LuaCharacterController

Enum.CharacterControlMode
Tidak Dapat Dijelajahi
Baca Paralel

NameDisplayDistance

number
Baca Paralel

Tetapkan jarak di mana pemain ini akan melihat nama lain Humanoid .Jika ditetapkan ke 0, nama disembunyikan.Properti ini diatur ke 100 studs secara default.

Untuk mengubah jarak tampilan untuk pemain setelah mereka bergabung dengan game, Anda dapat mengatur properti Player.NameDisplayDistance.

Jika nama Humanoid terlihat, Anda dapat mengatur jenis tampilan menggunakan Humanoid.DisplayDistanceType .

Contoh Kode

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.

Hiding Player Health and Names
local Players = game:GetService("Players")



local player = Players.LocalPlayer



player.HealthDisplayDistance = 0

player.NameDisplayDistance = 0

RagdollDeath

boolean
Tidak Dapat Dijelajahi
Baca Paralel

UserEmotesEnabled

boolean
Baca Paralel

Properti ini menentukan apakah emote milik pengguna dimuat saat memuat avatar.Mengatur properti ini ke false menonaktifkan pemuatan.Pengembang dapat mengatur properti di Studio langsung atau melalui menu Pengaturan Permainan.

Saat emote loading dinonaktifkan, UI emote akan tetap berfungsi selama pengembang memilih untuk menggunakan fitur emote dengan menambahkan emote dalam game mereka.

Lihat juga Emote Avatar, sebuah artikel yang merinci cara mengustomisasi, menyesuaikan, dan memainkan emote avatar.

Lihat semua yang diwarisi dari Instance
Lihat semua yang diwarisi dari Object

Metode

Lihat semua yang diwarisi dari Instance
Lihat semua yang diwarisi dari Object

Acara

Lihat semua yang diwarisi dari Instance
Lihat semua yang diwarisi dari Object