Difference between revisions of "ChangeOutfit (CMS)"

From The Official Visionaire Studio: Adventure Game Engine Wiki
m
 
(2 intermediate revisions by the same user not shown)
Line 7: Line 7:
  
 
This small function allows you to quickly change the outfit of a character.
 
This small function allows you to quickly change the outfit of a character.
 +
  
 
== Instructions ==
 
== Instructions ==
Line 23: Line 24:
 
<syntaxhighlight lang="lua">
 
<syntaxhighlight lang="lua">
 
function changeOutfit(c, o)
 
function changeOutfit(c, o)
  if c ~= nil then c = Characters[c] else c = game.CurrentCharacter end
+
  if c == nil then c = game.CurrentCharacter else c = Characters[c] end -- store character
  c.CurrentOutfit = c.Outfits[o]
+
  c.CurrentOutfit = c.Outfits[o] -- update outfit
 
end
 
end
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
  
 
== Syntax Breakdown ==
 
== Syntax Breakdown ==
Line 35: Line 37:
 
| c || "string" or nil || This should be a "string" value containing the name of the character you want to affect; if c equals nil then it will default to current character.
 
| c || "string" or nil || This should be a "string" value containing the name of the character you want to affect; if c equals nil then it will default to current character.
 
|-
 
|-
| t || "string" || This should be a "string" value containing the name of the outfit you want to change to.
+
| o || "string" || This should be a "string" value containing the name of the outfit you want to change to.
|}
+
|}{{toc}}

Latest revision as of 14:53, 23 August 2022

Name Type By
changeOutfit("c", "o") Definition AFRLme

This small function allows you to quickly change the outfit of a character.


Instructions

1. Add the main script to the Visionaire Studio Script Editor & set the script as a definition script.
2a. To change the outfit of the current character...

changeOutfit(nil, "outfit_name")

2b. To change the outfit of a specific character...

changeOutfit("character_name", "outfit_name")


Main Script

function changeOutfit(c, o)
 if c == nil then c = game.CurrentCharacter else c = Characters[c] end -- store character
 c.CurrentOutfit = c.Outfits[o] -- update outfit
end


Syntax Breakdown

Name Type Description
c "string" or nil This should be a "string" value containing the name of the character you want to affect; if c equals nil then it will default to current character.
o "string" This should be a "string" value containing the name of the outfit you want to change to.