StarterPlayer
*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.
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
Menggambarkan tingkat izin gamesaat ini mengenai animasi avatar khusus dari situs web.
Mengatur apakah karakter akan secara otomatis melompat saat menabrakkan hambatan di perangkat seluler.
Jarak maksimum kamera default pemain diizinkan untuk diperbesar dalam stud.
Jarak minimum dalam studs kamera default pemain diizinkan untuk diperbesar.
Mengubah mode kamera default ke orang pertama atau ketiga.
Menentukan nilai awal dari Humanoid.JumpHeight untuk Player.Character .
Menentukan nilai awal dari Humanoid.JumpPower untuk Player.Character .
Menentukan nilai awal dari Humanoid.MaxSlopeAngle untuk Player.Character .
Menentukan status awal Humanoid.UseJumpPower untuk Player.Character .
Menentukan nilai awal dari Humanoid.WalkSpeed untuk Player.Character .
Mengatur bagaimana kamera default menangani objek di antara kamera dan pemain.
Biarkan pengembang menulis ulang mode kamera default untuk setiap pemain jika pemain berada di komputer.
Biarkan pengembang menulis ulang mode gerakan pemain jika pemain berada di komputer.
Biarkan pengembang menulis ulang mode gerakan kamera default untuk setiap pemain jika pemain berada di perangkat seluler.
Biarkan pengembang menulis ulang mode gerakan pemain jika pemain berada di perangkat sentuh.
Menentukan apakah pemain dapat menyalakan kunci mouse secara default.
Tetapkan jarak di mana pemain ini akan melihat bar kesehatan lain Humanoid. Jika diatur ke 0, bar kesehatan tidak akan ditampilkan.
Apakah atau tidak penampilan karakter pemain harus dimuat.
Menunjukkan apakah karakter yang muncul ke dalam pengalaman akan memiliki aksesori pakaian bertingkat yang dilengkapi pada mereka.
Tetapkan jarak di mana pemain ini akan melihat nama lain Humanoid .
Menentukan apakah emote milik pengguna dimuat saat memuat avatar.
Properti
AllowCustomAnimations
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
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
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
CameraMaxZoomDistance
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
local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.CameraMaxZoomDistance = 50
player.CameraMinZoomDistance = 75
CameraMinZoomDistance
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
local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.CameraMaxZoomDistance = 50
player.CameraMinZoomDistance = 75
CameraMode
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
local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.CameraMode = Enum.CameraMode.LockFirstPerson
CharacterJumpHeight
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
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
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
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
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
DevCameraOcclusionMode
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
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
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
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
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
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
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
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
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
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
local Players = game:GetService("Players")
local player = Players.LocalPlayer
while true do
player.DevEnableMouseLock = not player.DevEnableMouseLock
task.wait(5)
end
HealthDisplayDistance
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
local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.HealthDisplayDistance = 0
player.NameDisplayDistance = 0
LoadCharacterAppearance
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
local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.CanLoadCharacterAppearance = false
LoadCharacterLayeredClothing
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
NameDisplayDistance
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
local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.HealthDisplayDistance = 0
player.NameDisplayDistance = 0
RagdollDeath
UserEmotesEnabled
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.