Converting Maps: Difference between revisions

From Goodblox Wiki
Jump to navigationJump to search
 
(31 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{CatUp|Tutorials}}
{{CatUp|Tutorials}}


This is a tutorial on how to convert newer Roblox maps to work with old Roblox clients (older than 2013). This is a very advanced tutorial, so please read it carefully.
This is a tutorial on how to convert newer Roblox maps to work with old Roblox clients (older than 2013).


Also, be sure to check the '''[[Converting Maps#Important Info|Important Info]]''' section below if you have any issues.
This is an advanced tutorial, so please read it carefully.


If you prefer, a [https://www.youtube.com/watch?v=n6gxLxy9jZw video tutorial] is available!


== Introduction and Requirements ==
== Introduction and Requirements ==


You cannot load .rbxl files (Roblox place files) saved in clients from 2014-present in any client version earlier than 2013. If a map was saved in a client version more recent than 2013, it will have to be converted in order to be opened in clients earlier than 2013. GoodBlox uses an early 2010 client, so newer maps will have to be converted to work with it.
You cannot load ''.rbxl'' files <small>(Roblox place files)</small> saved in clients from 2014-present in any client version earlier than 2013. If a map was saved in a client version more recent than 2013, it will have to be "converted" in order to be opened in clients earlier than 2013. GoodBlox uses a (modified) early 2010 client, so newer maps will have to be converted to work with it.
 
To "convert" a newer map, all you really have to do is load and save it in a 2013 client, but the problem is that not all data gets carried over to 2013, meaning that we would have to manually save and load this data separately.


First of all, you'll need these items:
First of all, you'll need these items:
* '''[http://www.mediafire.com/file/e1f1iexrpa69xd6/ConversionScripts.zip ConversionScripts]'''
* '''[https://www.mediafire.com/file/syxgsepg3fe6ya3/ConversionScripts_%2528September_2021%2529.zip/file ConversionScripts]'''
* '''[http://www.mediafire.com/file/jmtbca59999k5p7/Roblox_Late_2013_Studio.zip/file Roblox Late 2013 Studio]'''
* '''[https://www.mediafire.com/file/n0zhs3sjl3qqhbl/Roblox_Late_2013_Studio_%2528July_2021_Patch%2529.zip/file Roblox Late 2013 Studio]'''
* '''[http://www.mediafire.com/file/b5v6vyjn3jl22p9/Roblox_FIBv11.zip/file Roblox FIBv11 Studio]'''
* '''[https://www.mediafire.com/file/b5v6vyjn3jl22p9/Roblox_FIBv11.zip/file Roblox FIBv11 Studio]'''


'''ConversionScripts''' contains two important scripts: '''Save.txt''' and '''Load.txt'''. You'll need them.
'''ConversionScripts''' contains two important scripts: '''ConvSAVE<small>.lua</small>''' and '''ConvLOAD<small>.lua</small>'''. You'll need them.


You won't always need to use '''FIBv11 Studio''' for converting maps, but it's good to have for when you ''do'' need it.
You won't always need to use '''FIBv11 Studio''' for converting maps, but it's good to have for when you ''do'' need it.
<small>FIBv11 is an old development build of ''Future is Bright'', Roblox's modern lighting system. It has found to be useful for fixing some errors with map conversion.</small>


Once you have these items, you're ready to start converting.
Once you have these items, you're ready to start converting.
Line 24: Line 27:
== Directions ==
== Directions ==


# Open the map you want to convert in Modern Roblox Studio.
# Open the map you want to convert in modern Roblox Studio.
# At the top of the screen, click '''[MODEL]''', then '''[Run Script]''' (above the ''Advanced'' section). Locate '''Save.txt''', and open it. Wait a few seconds for the script to finish running. <small>''(If you have Output open, you can see when the script is finished.)''</small>
# At the top of the screen, click '''[MODEL]''', then '''[Run Script]''' (above the ''Advanced'' section). Locate '''ConvSAVE<small>.lua</small>''', and open it. A message box will tell you when the script is done saving conversion data.
# Save the map.
# Save the map. <small>(once the message goes away)</small>
# Now, open the Late 2013 Studio.
# Now, open the Late 2013 Studio. <small>(Find ''RobloxStudioBeta.exe'' in the 2013 directory)</small>
# In 2013, open the map you just saved. All the parts should have no color, and any GUI text will be really small. This is normal, don't worry. <small>''If you get an error, please check the bold text just below these directions.''</small>
# In 2013, open the map you just saved. All the parts should have no color, and any GUI text will be really small. Don't worry; this is normal. <small>''(If you get an error that prevents the map from opening, please check the bold text just below these directions.)''</small>
# At the top of the screen, click '''[Tools]''', then '''[Execute Script...]'''. Locate '''Load.txt''', and open it.
# At the top of the screen, click '''[Tools]''', then '''[Execute Script...]'''. Locate '''ConvLOAD<small>.lua</small>''', and open it.
# All the parts should have their colors returned, and GUIs should be fixed.
# All items should have their colors returned, and GUIs should be fixed.
# Save the map.
# Save the map.


You're done! Now you should be able to use the map in GoodBlox, and any other old client!
You're done! Now you should be able to use the map in GoodBlox, and any other old client!


'''If you get an error while trying to load the map in 2013, try saving the map in <u>FIBv11 Studio</u> instead of in Modern Roblox Studio, and then try loading the map in 2013 again.''' If this still doesn't work, please check the '''[[Converting Maps#Important Info|Important Info]]''' section below.
 
'''If you get an error while trying to load the map in 2013 Studio, try saving the map in <u>FIBv11 Studio</u> instead of in modern Roblox Studio, and then try loading the map in 2013 again.'''
 
<small>[https://wiki.goodblox.xyz/images/f/f3/ConversionError.png Such errors typically say things like ''"Error in opening file"'' and ''"Unexpected format 27 (expected 3)"'']</small>


== Converting Models ==
== Converting Models ==


If you'd like to simply convert a model, you must load the model through an ''.rbxl'' file in 2013. You cannot simply load ''.rbxm'' (model) files from Modern Roblox Studio in 2013. Follow the same steps as above to convert the ''.rbxl'' file.
If you'd like to simply convert a model, you must load the model through an ''.rbxl'' file in 2013 Studio. You cannot simply load ''.rbxm'' (model) files from modern Roblox Studio into 2013. Follow the same steps as above to convert the ''.rbxl'' file.


You can just save the model on an empty baseplate, convert the map, and grab the model while you're in 2013.
You can just save the model on an empty baseplate, convert the map, and export the model from the map in 2013 Studio.


Note: If you save an ''.rbxmx'' or ''.rbxlx'' file in Modern Roblox Studio (instead of an ''.rbxm'' or ''.rbxl''), you ''might'' be able to load it in older clients without having to convert, but the colors and other factors will still be reset. '''This will not always work''', and the colors will still be reset if it ''does'' work, so it's best to just convert it normally.
'''Note:''' If you save an ''.rbxmx'' or ''.rbxlx'' file in modern Roblox Studio (instead of an ''.rbxm'' or ''.rbxl''), you might be able to load it in older clients without having to convert, but the colors and other factors will still be reset. This will not always work, and the colors will still be reset if it ''does'' work, so it's best to just convert it normally.


== Important Info ==
== Important Info ==


If you have any issues with converting maps, you should check here.
This section contains extra notable information about converting maps.


* If you get an error while trying to load the map in 2013, try saving the map in '''FIBv11 Studio''' instead of in Modern Roblox Studio, and then try loading the map in 2013 again.
* If you get an error that prevents a map from loading in 2013, try saving the map in '''FIBv11 Studio''' instead of in modern Roblox Studio, and then try loading the map in 2013 again.
* If you still can’t open a map in 2013 after trying FIBv11, and you followed all the steps correctly, it could be some object in the place that’s preventing it.
* If you convert a map that uses objects added after 2013, such as ''UnionOperation'', ''MeshPart'', ''ParticleEmitter'', ''Accessory'', etc., then those objects will be automatically removed from the map in 2013, as they do not exist in that client. To maintain compatibility, in modern Studio you would have to substitute these objects. For example, you can separate ''UnionOperations'' into ''Parts'', replace ''MeshParts'' with ''SpecialMeshes'', ''Accessory'' with ''Hat/Accoutrement'', ''ParticleEmitter'' with ''Sparkles/Fire/Smoke'', etc.
* If your map has '''CharacterMesh''' objects in it, the map ''might'' not load in 2013. If the map doesn't load, delete them before converting and then re-add them after converting.
* If your map uses '''newer BrickColors''' added after 2016, then those colors will be converted to the closest available ''BrickColor'' when you run ''ConvLOAD<small>.lua</small>'' in 2013.
* If your map has '''KeyframeSequence''' objects in it, the map will not load in clients older than 2013. You can delete them in 2013 or in Modern Roblox Studio.
* Upon conversion, the '''formFactor''' properties of Parts might be reset to '''Brick'''.
* If you convert a map that uses features added after 2013, such as Unions, MeshParts, ParticleEmitters, Accessories, etc., then those items will be removed from the map. You can separate your Unions into Parts and replace MeshParts with Parts that use SpecialMeshes.
* Asset IDs that use the <small>'''rbxassetid://XXXXXX'''</small> format will not work in clients older than 2013. Change these asset IDs to use <small>'''<nowiki>http://www.roblox.com/asset/?id=XXXXXX</nowiki>'''</small> (the old format) instead, so that they will work after conversion. <small>''(Assets that use the old format might not work in 2013, but this will not affect map conversion.)''</small>
* Meshes uploaded to Roblox after April 2019 will not load in older clients. (This does not affect map conversion)
* GoodBlox's client only supports Roblox mesh format versions 1.00 and 2.00. In simple terms, this means that only meshes uploaded to Roblox '''before April 2019''' will load in the client. <small>''(This does not affect map conversion; newer meshes will just be invisible. [https://pastebin.com/5DJYWuB3 Click here] for a more detailed explanation.)''</small>
* If you convert a map that uses '''smooth Terrain''', all the Terrain will be removed. If you have an old blocky Terrain map that was last edited before January 2017 (when blocky Terrain was removed), you can still convert it.
* If your map has newer colors added after 2016, those colors will be changed to the closest available BrickColor when you run Load.txt in 2013.
* If your map has '''BodyColors''', '''SelectionBoxes''', or any type of '''Lasso''' objects in it, all the colors in them will be reset when you convert. We currently do not have a system for converting the colors inside these objects.
* Asset IDs that use the ''rbxassetid://XXXXXX'' format will not work in clients older than 2013. Change these asset IDs to use ''<nowiki>http://www.roblox.com/asset/?id=XXXXXX</nowiki>'' (the old format) instead, so that they will work after conversion.
* Upon conversion, the '''FormFactor''' properties of Parts may be reset to '''Brick'''.


[[Category:Tutorials]]
[[Category:Tutorials]]

Latest revision as of 23:37, 31 December 2021


This is a tutorial on how to convert newer Roblox maps to work with old Roblox clients (older than 2013).

This is an advanced tutorial, so please read it carefully.


Introduction and Requirements

You cannot load .rbxl files (Roblox place files) saved in clients from 2014-present in any client version earlier than 2013. If a map was saved in a client version more recent than 2013, it will have to be "converted" in order to be opened in clients earlier than 2013. GoodBlox uses a (modified) early 2010 client, so newer maps will have to be converted to work with it.

To "convert" a newer map, all you really have to do is load and save it in a 2013 client, but the problem is that not all data gets carried over to 2013, meaning that we would have to manually save and load this data separately.

First of all, you'll need these items:

ConversionScripts contains two important scripts: ConvSAVE.lua and ConvLOAD.lua. You'll need them.

You won't always need to use FIBv11 Studio for converting maps, but it's good to have for when you do need it.

FIBv11 is an old development build of Future is Bright, Roblox's modern lighting system. It has found to be useful for fixing some errors with map conversion.

Once you have these items, you're ready to start converting.

Directions

  1. Open the map you want to convert in modern Roblox Studio.
  2. At the top of the screen, click [MODEL], then [Run Script] (above the Advanced section). Locate ConvSAVE.lua, and open it. A message box will tell you when the script is done saving conversion data.
  3. Save the map. (once the message goes away)
  4. Now, open the Late 2013 Studio. (Find RobloxStudioBeta.exe in the 2013 directory)
  5. In 2013, open the map you just saved. All the parts should have no color, and any GUI text will be really small. Don't worry; this is normal. (If you get an error that prevents the map from opening, please check the bold text just below these directions.)
  6. At the top of the screen, click [Tools], then [Execute Script...]. Locate ConvLOAD.lua, and open it.
  7. All items should have their colors returned, and GUIs should be fixed.
  8. Save the map.

You're done! Now you should be able to use the map in GoodBlox, and any other old client!


If you get an error while trying to load the map in 2013 Studio, try saving the map in FIBv11 Studio instead of in modern Roblox Studio, and then try loading the map in 2013 again.

Such errors typically say things like "Error in opening file" and "Unexpected format 27 (expected 3)"

Converting Models

If you'd like to simply convert a model, you must load the model through an .rbxl file in 2013 Studio. You cannot simply load .rbxm (model) files from modern Roblox Studio into 2013. Follow the same steps as above to convert the .rbxl file.

You can just save the model on an empty baseplate, convert the map, and export the model from the map in 2013 Studio.

Note: If you save an .rbxmx or .rbxlx file in modern Roblox Studio (instead of an .rbxm or .rbxl), you might be able to load it in older clients without having to convert, but the colors and other factors will still be reset. This will not always work, and the colors will still be reset if it does work, so it's best to just convert it normally.

Important Info

This section contains extra notable information about converting maps.

  • If you get an error that prevents a map from loading in 2013, try saving the map in FIBv11 Studio instead of in modern Roblox Studio, and then try loading the map in 2013 again.
  • If you convert a map that uses objects added after 2013, such as UnionOperation, MeshPart, ParticleEmitter, Accessory, etc., then those objects will be automatically removed from the map in 2013, as they do not exist in that client. To maintain compatibility, in modern Studio you would have to substitute these objects. For example, you can separate UnionOperations into Parts, replace MeshParts with SpecialMeshes, Accessory with Hat/Accoutrement, ParticleEmitter with Sparkles/Fire/Smoke, etc.
  • If your map uses newer BrickColors added after 2016, then those colors will be converted to the closest available BrickColor when you run ConvLOAD.lua in 2013.
  • Upon conversion, the formFactor properties of Parts might be reset to Brick.
  • Asset IDs that use the rbxassetid://XXXXXX format will not work in clients older than 2013. Change these asset IDs to use http://www.roblox.com/asset/?id=XXXXXX (the old format) instead, so that they will work after conversion. (Assets that use the old format might not work in 2013, but this will not affect map conversion.)
  • GoodBlox's client only supports Roblox mesh format versions 1.00 and 2.00. In simple terms, this means that only meshes uploaded to Roblox before April 2019 will load in the client. (This does not affect map conversion; newer meshes will just be invisible. Click here for a more detailed explanation.)