Soziale Interaktionen

Dein Avatar ist deine Identität in jedem Raum, in den du eingebenbist. Das SocialInteractions-Entwicklermodul lässt jeden Benutzer besser ausdrücken und seine natürlichen Bewegungen hinzufügen, indem er dem Erlebnis ein Hauch von Realismus verleiht.

Dieses Modul enthält die folgenden Funktionen:

Modul-Einsatz

Installation

Um das SocialInteractions -Modul in einem Erlebnis zu verwenden:

1. Von der Ansicht-Registerkarte öffnen Sie die Werkzeugkiste und wählen Sie die Creator-Store -Registerkarte.

   

2. Stellen Sie sicher, dass die Models Sortierung ausgewählt ist, dann klicken Sie auf die Alle anzeigen Schaltfläche für Kategorien .

   

3. Suchen Sie die Dev-Module -Kachel und klicken Sie darauf.

   

4. Suchen Sie das Social Interactions -Modul und klicken Sie darauf, oder ziehen Sie es in die 3D-Ansicht.

   

5. In dem Explorer-Fenster bewegen Sie das gesamte SocialInteractions-Modell in ServerScriptService . Nach dem Laufen der Erlebniswird das Modul auf verschiedene Dienste verteilt und beginnt zu laufen.

   

Konfiguration

Durch das Einfügen des SocialInteractions Moduls werden sowohl die Körperorientierung als auch die Chat-Animationen -Funktionen in deinem Ortaktiviert. Um das Standardverhalten anzupassen:

1. In StarterPlayerScripts erstellen Sie ein neues LocalScript und benennen Sie es zu KonfigurierenSozialenInteraktionen um.

   

2. Fügen Sie den folgenden Code in das neue Skript, das. PL: die Skriptsein, verwenden Sie die configure-Funktion, um das Verhalten des Moduls anzupassen.

   Lokales Skript
   local ReplicatedStorage = game:GetService("ReplicatedStorage")
   
   local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))
   
   -- Stellen Sie die Taille-Rotation stärker aus und deaktivieren Sie die Funktion
   SocialInteractions.configure({
   	waistOrientationWeight = 0.75,
   	useChatAnimations = false,
   })

Chat-Animation Trigger Wörter

Die Liste der "Trigger-Wörter", die jede Chat-Animation aktivieren, ist konfigurierbar und Lua-String-Muster werden verwendet, um anerkennbare Wörter zu erhöhen. Zum Beispiel ist eine Kombination, die von der Animationenverwendet wird,

Beachten Sie auch, dass Trigger-Wörter kassounempfindlich sind, sodass das Schreiben von hey dasselbe ist wie HEY , 2> Hey2> und andere Variationen.

Die Liste der Trigger-Wörter, die jede Animation aktivieren, ist konfigurierbar, und zus

Lokales Skript
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))

-- Registrieren Sie das Muster für die "Tilt"Animationen
SocialInteractions.setTriggerWordsForChatAnimation("rbxassetid://3334538554", {"cra+zy"})

-- Registrieren Sie ein zusätzliches Strickmuster für die Animationen"Applaud"
SocialInteractions.setTriggerWordsForChatAnimation("rbxassetid://5911729486", {"coo+l"})

API-Referenz

Funktionen

konfigurieren

Überschreibt Standard-Konfigurationsoptionen durch die folgenden Schlüssel/ Werte in der config Tabelle. Diese Funktion kann nur von einem LocalScript ausgerufen werden.

Lokales Skript
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))

-- Stellen Sie die Taille-Rotation stärker aus und deaktivieren Sie die Funktion
SocialInteractions.configure({
	waistOrientationWeight = 0.75,
	useChatAnimations = false,
})

setTriggerWordsFürChatAnimation

Registert eine neue Animation in der Funktion. Wenn Sie jedes Wort eingeben, das einer Zeichenfolge entspricht, die in der triggerWords -Tabelle enthalten ist, wird die Animation aktiviert, deren ID als erster Parameter übergeben wird.

Beachten Sie, dass Trigger-Wörter sind case-insensitive für Spieler, so dass ein Muster von woah wird akzeptieren Chat Phrasen von woah , 1> woah1> , 4> Woah4> und anderen Variationen.

Lokales Skript
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))

-- Registrieren Sie ein neues Strickmuster für eine benutzerdefinierte Animationen
SocialInteractions.setTriggerWordsForChatAnimation(
	"rbxassetid://3334538554",
	{"cra+zy", "woah+"}
)

Ereignisse

aufChatAnimationGespielt

Feuert ab, wenn eine Chat-Animation abgespielt wird. Die verbundene Funktion erhält die Animations-ID und das Wort, das die Animation als seine Argumente ausgibt. Dieses Ereignis kann nur in einem LocalScript verbunden werden.

Lokales Skript
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))

SocialInteractions.onChatAnimationPlayed:Connect(function(animationId, triggerWord)
	print(animationId, triggerWord)
end)