Animacje transferowe

W Roblox animacje są zablokowane dla doświadczeń posiadanych przez użytkowników, którzy również posiadają te animacje.Aby zapobiec przerwaniu animacji, gdy przeniesiesz swoje doświadczenie do grupa, musisz opublikować zasoby animacji do nowego właściciela grupy doświadczeń.

Jeśli masz dużą liczbę animacji do przesyłać, możesz użyć narzędzia wspieranego przez społeczność Przeniesienie animacji Roblox, aby ponownie przesłać animacje i przypisać ich stare AnimationIds do nowego odpowiedniego AnimationIds.

Przewymagania

Zanim przeniesiesz swoje animacje, musisz mieć npx zainstalowane.npx pozwala uruchamiać komendy z pakietów bez konieczności instalowania tych pakietów na swoim systemie.Aby sprawdzić npx, zainstaluj node.js i uruchom npx –version w oknie terminalowym.

Aby uzyskać więcej informacji o wymaganiach, zobacz Roblox Animation Transfer README.

Mapuj animacje ID do nazw

Jeśli twoje animacje są przechowywane jako instancje animacji w ramach wcześniej przygotowanych modeli postaci w twoim doświadczeniu, możesz wygenerować plik tekstowy, aby przekazać AnimationIds do ich odpowiednich nazw.

1. W Roblox Studio uruchom następujący skrypt. Studio wyświetla wynik jako pojedynczą długą ciąg.

   local Workspace = game:GetService("Workspace")
   
   local ANIMSTRING = ""
   
   for _, character in Workspace:GetChildren() do
   	  if not character:IsA("Model") then
   		  continue
   	  end
   
   	  local animations = character:FindFirstChild("Animations")
   	  if not animations then
   		  continue
   	  end
   
   	  for _, animation in animations:GetChildren() do
   		  local animationId = string.match(animation.AnimationId, "%d+")
   		  if animationId then
   			  ANIMSTRING ..= (animationId .. " " .. character.Name .. "_" .. string.gsub(animation.Name, " ", "_") .. "\n")
   		  end
   	  end
   end
   
   print(ANIMSTRING)

2. Stwórz nowy plik tekstowy na swoim komputerze.

3. Wklej wyjście ciągu przez Studio do pliku tekstowego.

4. Wyczyść wszelkie rozbieżności, takie jak dodatkowe -Edit i -Studio linie, które zostały automatycznie dodane do zawartości pliku.

5. Zastąp wszystkie spacje podświetleniami, aby ograniczyć ogólną liczbę nazw moderowanych.

(Opcjonalnie) Przygotuj pliki tekstowe

Roblox ma wewnętrzną ograniczoną prędkość dla przesyłania animacji.Narzędzie transferu animacji Roblox nie respektuje tego limitu szybkości, co może powodować problemy podczas procesu transferu i zniszczyć twój ostateczny plik tekstowy.Na przykład możesz przesłać 1200 animacji, ale skończy się tylko 900 z nich i nie ma sposobu określenia, które nie udało się przesłać.

Aby upewnić się, że ostateczny plik nie zostanie zniszczony, możesz:

1. Podziel plik tekstowy na wiele plików z maksymalnie 200 animacjami w każdym.
2. Użyj narzędzia do przenoszenia animacji Roblox na każdą pojedynczą plik. Aby zapobiec jakimkolwiek poważnym problemom z ograniczeniem szybkości, poczekaj kilka minut pomiędzy każdą partią.

Animacje transferowe

Po zakończeniu przygotowania plików tekstowych rozpocznij proces transferu:

1. Otwórz okno terminalowe.
2. Wykonaj npx roblox-animation-transfer --inFile animations.txt --group YOUR_GROUP_ID --outFile newAnimations.txt.

   • --inFile musi wskazać na plik z animacjami, które chcesz przesyłać.Plik ten może być dużym plikiem tekstowym, który pierwotnie utworzyłeś, lub pierwszą z kilku mniejszych plików, jeśli zdecydujesz się złamać większy plik.
   • --group musi wskazać na GroupId grupę otrzymującą transfer animacji.Możesz znaleźć ID grupy w URL grupy na stronie internetowej Roblox.
   • --outFile musi wskazać na plik, do którego chcesz umieścić nowe animacje.

Jeśli proces transferu zakończy się sukcesem, animacje w outFile są wymienione w tej samej kolejności, w jakiej zostały dostarczone w inFile.Jeśli wiele animacji nie zostanie przeniesionych, narzędzie próbuje je ponownie przesłać; jeśli ta druga próba zakończy się sukcesem, animacje te zostaną dodane na końcu listy w outFile.

Ładowanie animacji podczas uruchamiania

Po przekazaniu animacji nowemu właścicielowi grupy musisz zamienić stare animacje na nowe animacje.

1. W Studio utwórz moduł Animations .

2. Stwórz dwa moduły dziecięce, jeden odpowiadający użytkownikowi, lub oryginalnemu właścicielowi, a drugi odpowiadający grupalub nowemu właścicielowi.

3. Aby zapobiec przerwaniu doświadczenia, jeśli zdecydujesz się opublikować je w innym miejscu, uruchom następujący skrypt.Domyślnie skrypt zwraca animacje użytkownika.

   local module = {}
   local GROUP_ID = 12345678
   local gameContext = {
   	["User"] = require(script:WaitForChild("Animations_User")),
   	["Group"] = require(script:WaitForChild("Animations_Group"))
   }
   
   local function getAnimationMapForGameContext()
   	if game.CreatorType == Enum.CreatorType.Group and game.CreatorId == GROUP_ID then
   		return gameContext.Group
   	end
   	return gameContext.User
   end
   
   local animationMap = getAnimationMapForGameContext()
   function module.getAnimation(animName: string)
   	return animationMap[animName]
   end
   
   return module

4. Przekształć generowane pliki tekstowe w mapy animacji w Studio.

   1. Zastąp listę animacji w zmiennej animFileText przez zawartość pliku tekstowego, który chcesz zmienić na mapę animacji.
   2. Wykonaj następny skrypt, aby zwrócić ciąg znaków:

   local animFileText = [[
   4215167 Animation_Name_1
   6171235 Animation_Name_2
   1251267 Animation_Name_3
   ]]
   
   local function convertFileToAnimationMap(animFileText: string)
   	local NEW_ANIMATION_MAP = ""
   
   	local lines = string.split(animFileText, "\n")
   	for _, line in lines do
   		local components = string.split(line, " ")
   		if #components ~= 2 then
   			continue
   		end
   
   		local animationId = components[1]
   		local animationName = components[2]
   
   		NEW_ANIMATION_MAP = string.format("%s\t[\"%s\"] = \"rbxassetid://%s\",\n", NEW_ANIMATION_MAP, animationName, animationId)
   	end
   
   	return string.format("return {\n%s}", NEW_ANIMATION_MAP)
   end
   
   print(convertFileToAnimationMap(animFileText))

5. Stwórz nowy ModuleScript rodzica dla twojego modułu Animations.

6. Umieść zwróconą strunę animFileText wewnątrz ModuleScript.

7. Aktualizuj doświadczenie, aby zgromadzić wszystkie animacje za pośrednictwem modułu Animations poprzez uruchomienie następującego skryptu:

   local Animations = require(PATH.TO.ANIMATIONS)
   local warriorWalk = Instance.new("Animation")
   warriorWalk.AnimationId = Animations.getAnimation("Warrior_Walk")