StarterPlayer
*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.
Layanan yang memungkinkan default dari proporsi di objek Player untuk di atur. Saat seorang pemain memasuki server, setiap proporsi dari objek pemain di set ke nilai proporsi yang sesuai dalam StarterPlayer .
Selain itu, Anda dapat menambahkan empat objek ke layanan ini:
- Sebuah StarterPlayerScripts instance dengan skrip yang dijalankan sekali untuk setiap pemain.
- Sebuah Class.StarterCharacterScripts instansi dengan skrip untuk ditambahkan ke setiap karakter pemain setiap kali mereka bertelur.
- Sebuah instansi Humanoid bernama StarterHumanoid yang akan digunakan sebagai humanoid default untuk setiap karakter pemain.
- Sebuah Class.Model instansi bernama Model yang akan digunakan sebagai model karakter untuk semua pemain.
Rangkuman
Properti
Menggambarkan tingkat izin game saat ini tentang animasi avatar khusus dari situs web.
Mengatur apakah karakter akan secara otomatis melompat saat menghantam rintangan di perangkat seluler.
Jarak maksimum yang dapat ditarik kamerasikan pemain secara default diizinkan untuk mengekstraksi.
Jarak minimum dalam studs kamera pemain boleh ditrunking.
Mengubah mode kamera default menjadi pertama atau ketiga orang.
Mengubah nilai awal Humanoid.JumpHeight untuk Player.Character .
Mengubah nilai awal Humanoid.JumpPower untuk Player.Character .
Mengubah nilai awal Humanoid.MaxSlopeAngle untuk Player.Character .
Mengukur status pemuluan Humanoid.UseJumpPower untuk Player.Character .
Mengubah nilai awal Humanoid.WalkSpeed untuk Player.Character .
Mengatur cara penanganan kamera default menangani objek di antara kamera dan pemain.
Mari pengembang mengambil alih mode kamera default untuk setiap pemain jika pemain berada di komputer.
Mari pengembang mengambil alih mode gerakan pemain jika pemain berada di komputer.
Mari pengembang mengambil alih mode gerakan kamera default untuk setiap pemain jika pemain berada di perangkat seluler.
Mari pengembang menulis mode gerakan pemain jika pemain berada di perangkat sentuh.
Menentukan apakah seorang pemain dapat menyalakan kunci mouse secara default.
Tetapkan jarak di mana pemain ini akan melihat bar kesehatan Humanoid lainnya. Jika diatur ke 0, bar kesehatan tidak akan ditampilkan.
Apakah tampilan karakter pemain harus dimuat atau tidak.
Menunjukkan apakah karakter yang muncul ke dalam pengalaman akan memiliki aksesori pakaian berlapis.
Tetapkan jarak di mana pemain ini akan melihat nama Humanoid lainnya. Jika diatur ke 0, nama diblokir.
Mendeterminasikan apakah emote pengguna dimuat saat memuat avatar.
Properti
AllowCustomAnimations
Properti AllowCustomAnimations menggambarkan tingkat izin game saat ini terkait avatar khusus Animations dari situs web.
Sebagai value, value ini tidak dapat diubah dari dalam game. Itu hanya dapat diubah dengan mengubah tingkat izin game dalam halaman pengaturan game di situs web.
Properti ini tidak dimaksudkan untuk digunakan dalam game.
AutoJumpEnabled
Properti AutoJumpEnabled menentukan apakah karakter akan secara otomatis melompat saat menghantam rintangan di perangkat seluler.
Properti ini diambil dari StarterPlayer ke Class.Player ketika mereka bergabung dengan game. Setelah itu, nilai properti ini diambil ke Humanoid.AutoJumpEnabled property dari karakter's 1>Class.Humanoid
Contoh Kode
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
Propiedad CameraMaxZoomDistance mengatur jarak maksimum dalam studs kamera dapat dari karakter dengan kamera default.
Properti ini menetapkan nilai default dari Player.CameraMaxZoomDistance untuk setiap pemain yang bergabung dengan game. Jika nilai ini di tetapkan ke nilai yang lebih rendah dari StarterPlayer.CameraMinZoomDistance itu akan di tingkatkan ke CameraMinZoomDistance.
Contoh Kode
local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.CameraMaxZoomDistance = 50
player.CameraMinZoomDistance = 75
CameraMinZoomDistance
Propiedad CameraMinZoonDistance menetapkan jarak minimum dalam studs kamera dapat berasal dari karakter dengan kamera default.
Item ini menetapkan nilai default dari Player.CameraMinZoomDistance untuk setiap pemain yang bergabung dengan game. Jika nilai ini di tetapkan ke nilai yang lebih tinggi dari StarterPlayer.CameraMaxZoomDistance itu akan di kurangi ke 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
Pada mode orang pertama, kamera pemain diperbesar sepanjang jalan. Kecuali ada presentasi GUI yang terlihat dengan set kepemilikan GuiButton.Modal , mouse akan dikunci dan kamera pemain akan berputar saat mouse bergerak.
Orang Ketiga
Pada mode orang ketiga (default), karakter dapat dilihat di kamera. Sementara dalam mode orang ketiga pada Roblox:
- Anda dapat menekan dan menyeret untuk memutar kamera Anda, atau menggunakan tombol panah di sudut kanan bawah layar.
- Ketika Anda menggerakkan mouse Anda, kamera Anda tidak berubah (kecuali Anda menggerakkan mouse ke ujung layar).
- Ketika Anda menekan salah satu tombol panah, karakter pengguna akan menghadapi arah tombol unityang sesuai.
- Anda dapat menggeser masuk dan keluar secara bebas.
Contoh Kode
local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.CameraMode = Enum.CameraMode.LockFirstPerson
CharacterJumpHeight
CharacterJumpHeight menentukan nilai awal dari Humanoid.JumpHeight untuk Class.Player.Character|Character pemain.Nilai property ini bervariasi di 7,2 stud.
Properti ini hanya terlihat di jendela Propinsi jika StarterPlayer.CharacterUseJumpPower di set ke false , karena itu tidak akan relevan jika tidak.
Karena kepemilikan ini hanya berlaku untuk karakter yang akan dibuat di masa depan, mengubahnya tidak akan mengubah karakter pemain yang ada. Perubahan kepemilikan ini hanya akan berlaku saat seorang pemain respawn.
CharacterJumpPower
CharacterJumpPower menentukan nilai awal dari Humanoid.JumpPower untuk pemain Character .Nilai property ini bervariasi antara 50 dan ketika diterapkan ke pemain 0> Class.Humanoid0> akan dibatasi antara 0 dan 1000.
Properti ini hanya terlihat di jendela Propinsi jika StarterPlayer.CharacterUseJumpPower di set ke true , karena itu tidak akan relevan jika tidak.
Karena kepemilikan ini hanya berlaku untuk karakter yang akan dibuat di masa depan, mengubahnya tidak akan mengubah karakter pemain yang ada. Perubahan kepemilikan ini hanya akan berlaku saat seorang pemain respawn.
CharacterMaxSlopeAngle
CharacterMaxSlopeAngle menentukan nilai awal dari Humanoid.MaxSlopeAngle untuk pemain. Ini bergantung pada 89°, sehingga humanoid dapat menaiki hampir setiap jalan yang mereka inginkan secara default. Saat diterapkan ke Class.Humanoid pemain, it
Karena kepemilikan ini hanya berlaku untuk karakter yang akan dibuat di masa depan, mengubahnya tidak akan mengubah karakter pemain yang ada. Perubahan kepemilikan ini hanya akan berlaku saat seorang pemain respawn.
CharacterUseJumpPower
CharacterUseJumpPower menentukan nilai awal dari Humanoid.UseJumpPower untuk Character pemain. Menggesernya akan mengubah prop yang terlihat di jendela prop: 0> Class.St
Karena kepemilikan ini hanya berlaku untuk karakter yang akan dibuat di masa depan, mengubahnya tidak akan mengubah karakter pemain yang ada. Perubahan kepemilikan ini hanya akan berlaku saat seorang pemain respawn.
CharacterWalkSpeed
CharacterWalkSpeed menentukan nilai awal dari Humanoid.WalkSpeed untuk pemain Character . Propinsi ini bervariasi dengan 16.
Karena kepemilikan ini hanya berlaku untuk karakter yang akan dibuat di masa depan, mengubahnya tidak akan mengubah karakter pemain yang ada. Perubahan kepemilikan ini hanya akan berlaku saat seorang pemain respawn.
DevCameraOcclusionMode
Mendefinisikan cara skrip kamera default menangani objek di 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
Propinsi DevComputerCameraMovementMode memungkinkan pengembang untuk menulis mode kamera pemain jika pemain berada di komputer.
Ini adalah property default untuk pemain yang bergabung dengan game. Ini dapat diubah untuk pemain individual dengan menetapkan 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 ini akan ditentukan berdasarkan property ini.
Lihat Enum.DevComputerCameraMovementMode untuk berbagai mode kamera yang tersedia.
Properti ini tidak berpengaruh pada pemain yang tidak ada 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 DevComputerMovementMove memungkinkan pengembang untuk menulis ulang mode gerakan pemain jika pemain berada di komputer.
Ini adalah property default untuk pemain yang bergabung dengan game. Ini dapat diubah untuk pemain individual dengan menetapkan Player.DevComputerMovementMode .
Jika diatur ke UserChoice maka mode gerakan pemain akan ditentukan oleh apa pun yang dipilih pemain dalam pengaturan permainan. Jika tidak, mode akan ditentukan berdasarkan property ini.
Lihat Enum.DevComputerMovementMode untuk berbagai mode gerakan yang tersedia. Mari pengembang menulis mode gerakan pemain jika pemain berada di komputer.
Properti ini tidak berpengaruh pada pemain yang tidak ada 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
Propriété DevTouchCameraMovementMode memungkinkan pengembang untuk menulis mode kamera pemain jika pemain berada di perangkat sentuh.
Ini adalah property default untuk pemain yang bergabung dengan game. Ini dapat diubah untuk pemain individual dengan menetapkan 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 ini akan ditentukan berdasarkan property ini.
Lihat Enum.DevTouchCameraMovementMode untuk berbagai mode kamera yang tersedia.
Properti ini tidak mempengaruhi pemain yang tidak ada di perangkat mobile.
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 DevTouchMovementMode memungkinkan pengembang untuk menulis ulang mode gerakan pemain jika pemain berada di perangkat sentuh.
Ini adalah property default untuk pemain yang bergabung dengan game. Ini dapat diubah untuk pemain individual dengan menetapkan Player.DevTouchMovementMode .
Jika diatur ke UserChoice maka mode gerakan pemain akan ditentukan oleh apa pun yang dipilih pemain dalam pengaturan permainan. Jika tidak, mode akan ditentukan berdasarkan property ini.
Lihat Enum.DevTouchMovementMode untuk berbagai mode gerakan yang tersedia. Mari pengembang menulis mode gerakan pemain jika pemain berada di perangkat sentuh.
Properti ini tidak berpengaruh pada pemain yang tidak ada di perangkat yang didukung sentuh.
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 EnableMouseLockOption menentukan apakah seorang pemain dapat mengubah kunci mouse secara default.
Mouselock akan menempatkan kurungan pemain ke tengah layar. Menggerakkan mouse akan mengubah Camera dan Player akan bergerak relatif terhadap rotasi saat ini dari kamera.
Properti ini menetapkan nilai dari Player.DevEnableMouseLock .
Catat bahwa API terkait geser-lock sedang dalam proses dihapus, jadi disarankan untuk menggunakan UserInputService.MouseBehavior alih-alih 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 HealthDisplayDistance mengatur jarak dalam studs di mana pemain ini akan melihat bar kesehatan lainnya Humanoid. Jika diatur ke 0, bar kesehatan tidak akan ditampilkan. Propperti ini diatur ke 100 studs secara default.
Untuk mengubah jarak tampilan untuk pemain setelah mereka bergabung dengan game, Anda dapat menetapkan propperti Player.HealthDisplayDistance.
Jika bar 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 LoadCharacterAppearance menentukan apakah tampilan karakter pemain harus dimuat atau tidak.
Mengatur ini menjadi false menghasilkan pemain tidak memiliki pakaian (termasuk topi), warna tubuh, paket tubuh, atau apa pun yang terkait dengan penampilan avatar pemain. Secara default, property ini diatur menjadi true .
Mengatur ini menjadi true menghasilkan pemain memuat tampilan yang sesuai dengan Player.CharacterAppearanceId pemain.
Jika Player:LoadCharacterWithHumanoidDescription() digunakan, itu bisa menjadi menguntungkan untuk menetapkan StarterPlayer.LoadCharacterAppearance ke false sebagai avatar pemain tidak diperlukan karena semua ID aset untuk dilengkapi pada karakter akan berasal dari pas yang diberikan dalam HumanoidDescription .
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 di atas mereka (Sebagai Workspace.MeshPartHeadsAndAccessories juga perlu diaktifkan di Workspace ).
LuaCharacterController
NameDisplayDistance
Tetapkan jarak di mana pemain ini akan melihat nama Humanoid lainnya. Jika diatur ke 0, nama diblokir.
HUDNameDisplay StarterPlayer property menyetel jarak dalam studs di mana pemain ini akan melihat nama Humanoid lainnya. Jika diatur ke 0, nama disembunyikan. Prop ini diatur ke 100 studs secara default.
Untuk mengubah jarak tampilan untuk pemain setelah mereka bergabung dengan game, Anda dapat menetapkan propperti 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
UserEmotesEnabled
Item ini menentukan apakah emote pengguna diaktifkan saat memuat avatar. Mengatur item ini ke false menonaktifkan pemuatan. Pengembang dapat menetapkan item ini di Studio secara langsung atau melalui menu Pengaturan permainan.
Ketika pemuatan emote dinonaktifkan, emotes UI masih akan bekerja sebagai long as pengguna memilih untuk menggunakan fitur emote dengan menambahkan emotes dalam gamemereka.
Lihat juga Emotes Avatar, artikel yang merinci cara mengontrol, menyesuaikan, dan bermain emotes avatar.