Arkadaşlar Bulucu

Oyun içinde arkadaşları bulmak zor olabilir. FriendsLocator geliştirici modülü, oyuncuların bir yer içinde arkadaşlarını kolayca bulup onlara ışınlanmalarını sağlar.

Modül kullanımı

Kurulum

FriendsLocator modülünü bir oyunda kullanmak için:

1. Studio'nun Pencere menüsünden veya Ana Sayfa sekmesi araç çubuğundan Araç Kutusu'nu açın ve Yaratıcı Mağaza sekmesini seçin.

   

2. Modeller sıralamasının seçili olduğundan emin olun, ardından Kategorileri Görüntüle butonuna tıklayın.

   

3. Paketler kutucuğunu bulun ve tıklayın.

4. Arkadaşlar Bulucu modülünü bulun ve üzerine tıklayın veya 3D görünümüne sürükleyip bırakın.

   

5. Explorer penceresinde, tüm FriendsLocator modelini ReplicatedStorage içine taşıyın. Oyun çalıştırıldığında modül çalışmaya başlayacaktır.

Studio'da Test Etme

Modülü Studio'da test etmek için, FriendsLocator modülünün çoklu istemci simülasyonunda çalıştırılması gerekir, çünkü tek oyunculu testte arkadaşlar mevcut olmayacaktır.

1. StarterPlayerScripts içinde yeni bir LocalScript oluşturun ve adını ConfigureFriendsLocator olarak değiştirin.

   

2. Yeni ConfigureFriendsLocator script'ine aşağıdaki kodu yapıştırın. configure fonksiyonu içindeki showAllPlayers ayarı, Studio'da test ederken tüm kullanıcılar için lokatörlerin gösterilmesini sağlar, ancak yayımlanmış bir yerde göstermez.

   LocalScript - ConfigureFriendsLocator

   local RunService = game:GetService("RunService")
   local ReplicatedStorage = game:GetService("ReplicatedStorage")
   
   local FriendsLocator = require(ReplicatedStorage.FriendsLocator)
   
   FriendsLocator.configure({
   	showAllPlayers = RunService:IsStudio(), -- Studio'da hata ayıklamaya izin verir
   })

3. Studio'nun mezzanininden, 2 istemci ile bir çoklu istemci simülasyonu başlatın. Üç yeni Studio örneği açılacaktır; bir simüle edilmiş sunucu ve iki simüle edilmiş istemci.

   

4. İstemci Studio örneklerinden birine girin, diğer karakterden 100 birim uzaklaşın ve başının üzerinde bir lokatör simgesi belirdiğini görmelisiniz.

   

   Studio'da kullanıcı kimliklerinin işlenme şekli nedeniyle, test sırasında lokatör simgeleri üzerinde avatar resimleri görünmeyecektir.

   Varsayılan olarak, bir arkadaşın simgesine tıklamak/ dokunmak, karakterinizi o karakterin konumuna ışınlar. Bu varsayılan davranışı korursanız ve örnek akışı mimarisi altında akış duraklaması olduğunu fark ederseniz, ışınlanma konumu etrafında alan akışı talep etmek isteyebilirsiniz; bu, tıklanan olay kodu örneğinde gösterilmiştir.

Olaylara Bağlanma

FriendsLocator modülü, kullanıcıların bir lokatör simgesi ile etkileşime girdiğinde özel davranışlar eklemenizi sağlayan olaylar sunar.

1. Studio'da test etme bölümünde belirtilen ConfigureFriendsLocator script'ini oluşturduğunuzdan emin olun.

2. Script'e 8. ve 11-13. satırları ekleyin:

   LocalScript - ConfigureFriendsLocator

   local RunService = game:GetService("RunService")
   local ReplicatedStorage = game:GetService("ReplicatedStorage")
   
   local FriendsLocator = require(ReplicatedStorage.FriendsLocator)
   
   FriendsLocator.configure({
   	showAllPlayers = RunService:IsStudio(), -- Studio'da hata ayıklamaya izin verir
   	teleportToFriend = false, -- Simgeye tıklama/dokunma ile ışınlanmayı engelle
   })
   
   FriendsLocator.clicked:Connect(function(player, playerCFrame)
   	print("Lokasyon simgesine tıkladınız:", player.DisplayName)
   end)

3. Çoklu istemci testi gerçekleştirin ve başka bir karakterin lokatör simgesine tıklayın. Karakterinizin o konuma ışınlanmadığını ve simge tıklamalarının özel işlenmesine izin veren olayın tetiklendiğini fark edin.

Özel lokatör UI'si

Varsayılan stil oyununuz için uygun değilse, varsayılan avatar portre UI'sini kendi UI'nizle değiştirebilirsiniz.

Varsayılan UI'yi değiştirmek için:

1. StarterGui konteynerinin içine yeni bir ScreenGui örneği oluşturun.

   

2. Yeni ScreenGui'nin çocuğu olarak FriendLocator adında bir Frame örneği oluşturun, ardından özel UI'nizi tasarlamak için ImageLabels, TextLabels gibi öğeler ekleyin.

   

3. İşiniz bittiğinde, modülün özel lokatör UI'sini ihtiyaç duyulana kadar göstermemesi için üstteki ScreenGui'yi devre dışı bırakın.

   

4. İSTEĞE BAĞLI

   Arkadaşın avatar portresinin ve DisplayName'in özel UI'de bir yerde görünmesini istiyorsanız, FriendLocator çerçevesinin içine aşağıdaki örnekleri yerleştirebilirsiniz.

   • Portrait adında bir ImageLabel.
   • DisplayName adında bir TextLabel.

   

   Modül, bu öğeleri arayacak ve arkadaşın avatar portresini ve/veya görüntü adını sırasıyla gösterecektir.

API referansı

Fonksiyonlar

configure

config tablosundaki aşağıdaki anahtar/değerler aracılığıyla varsayılan yapılandırma seçeneklerini geçersiz kılar.

local ReplicatedStorage = game:GetService("ReplicatedStorage")

local FriendsLocator = require(ReplicatedStorage.FriendsLocator)

FriendsLocator.configure({
	alwaysOnTop = true,
	showAllPlayers = false,
	teleportToFriend = true,
	thresholdDistance = 100,
	maxLocators = 10
})

Olaylar

clicked

Bir lokatör simgesine yerel oyuncu tarafından tıklanıldığında/aktif hale getirildiğinde tetiklenir. Bu olay yalnızca bir LocalScript içinde bağlanabilir.

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local Players = game:GetService("Players")
local Workspace = game:GetService("Workspace")

local FriendsLocator = require(ReplicatedStorage.FriendsLocator)

local localPlayer = Players.LocalPlayer

FriendsLocator.clicked:Connect(function(player, playerCFrame)
	-- Hedef konum etrafında akış talep et
	if Workspace.StreamingEnabled then
		local success, errorMessage = pcall(function()
			localPlayer:RequestStreamAroundAsync(playerCFrame.Position)
		end)
		if not success then
			print(errorMessage)
		end
	end

	print("Lokasyon simgesine tıkladınız:", player.DisplayName, "konumda", playerCFrame.Position)
end)

visibilityChanged

Bir lokatör simgesinin yerel oyuncunun ekranında gösterildiğinde/gizlendiğinde tetiklenir. Bu olay yalnızca bir LocalScript içinde bağlanabilir.

local ReplicatedStorage = game:GetService("ReplicatedStorage")

local FriendsLocator = require(ReplicatedStorage.FriendsLocator)

FriendsLocator.visibilityChanged:Connect(function(player, playerCFrame, isVisible)
	print("Lokasyon simgesinin görünürlüğü:", player.DisplayName, ":", isVisible)
end)