Post by Spottedpath on Aug 18, 2016 19:38:33 GMT
Custom Uploads Guide
By: Spottedpath
So you're a new minihost, or you're Generic and don't know how to upload a custom mode or map. Well, this guide will tell you exactly how to do that, and what you should do if the custom mode/map doesn't appear to be uploading.
Custom Modes
Custom modes should always be uploaded dependency first, then the original MS file, followed by Music, then by the Picture File. If you are uploading dependencies in bulk, you should name the file [mode] dependencies and zip it. However, as uploading dependencies in bulk does not seem to work all the time, simply uploading the dependencies one at a time will also do.
After you are certain you have uploaded all of the dependencies, you may upload the main MS file. If the game mode has no music file, you can upload it with the MS file and Picture, if it has no Picture file, you can upload it with the Music, if it has all three, you choose the option to upload with Music and Picture. The order here is important, as you must upload them in this order: .MS, MUSIC, PICTURE, or the mode may not upload properly.
Once that is done, assuming on what you've uploaded, the mode should upload and ask you to choose a mode, you should select the mode you have uploaded. If it does not load, and simply reverts to the mode you were on before (EG. Normal, if normal was the mode before you selected Custom), then you have uploaded it wrong, or there is a potential problem in the Mode.ms file.
Alternatively, if you are the host of a server, you can simply copy the files from the folder and paste them into the file that you are hosting Misuterii from. Then, you can opt to choose one from the existing custom modes. You may also do this if the mode you are trying to upload has already been uploaded to the server.
Custom Maps
Custom maps should be uploaded by dependency first, in dependencies exist. Generally, if a custom map does not have a dependency, then it probably will not spawn objects, as currently custom maps do not generate items in relation to the set spawn rate, and only spawn items that are forcespawned (EG. ? ? ? papers and placed items). You should always upload MapNameStart.ms first.
After you have uploaded any map dependencies, you should upload the map. It will prompt you to upload the Map.mhm file, followed by the Map.obj file. Both of these are mandatory, as the Map file is the build file and the Object file is the icon file. Lacking either will alert you that you have uploaded the wrong file and tell you that the map has failed to upload.
Maps cannot be selected from existing, as for some reason they do not save in the host's folder upon being uploaded.
Custom Modes with Custom Maps
When running a custom map during a custom mode, you should always upload the map before the custom mode, and let the map load. Once the map has finished loading, you may upload the custom mode. Otherwise it can throw up nasty, unwanted errors, some of which include nullifying mstags, blanking out custom icons, destroying map objects, and even completely destroying the mode and not allowing it to run.
Also, if a map has a spawn seed generator (a MapStart.ms), it is preferable that you wait until the map has fully loaded until moving, otherwise you could cause unwanted lag. This is worse in custom modes, where the combined loading of custom code mixes with the custom code of the map and can cause CPU spikes of 1140%. So wait patiently.
So you're a new minihost, or you're Generic and don't know how to upload a custom mode or map. Well, this guide will tell you exactly how to do that, and what you should do if the custom mode/map doesn't appear to be uploading.
Custom Modes
Custom modes should always be uploaded dependency first, then the original MS file, followed by Music, then by the Picture File. If you are uploading dependencies in bulk, you should name the file [mode] dependencies and zip it. However, as uploading dependencies in bulk does not seem to work all the time, simply uploading the dependencies one at a time will also do.
After you are certain you have uploaded all of the dependencies, you may upload the main MS file. If the game mode has no music file, you can upload it with the MS file and Picture, if it has no Picture file, you can upload it with the Music, if it has all three, you choose the option to upload with Music and Picture. The order here is important, as you must upload them in this order: .MS, MUSIC, PICTURE, or the mode may not upload properly.
Once that is done, assuming on what you've uploaded, the mode should upload and ask you to choose a mode, you should select the mode you have uploaded. If it does not load, and simply reverts to the mode you were on before (EG. Normal, if normal was the mode before you selected Custom), then you have uploaded it wrong, or there is a potential problem in the Mode.ms file.
Alternatively, if you are the host of a server, you can simply copy the files from the folder and paste them into the file that you are hosting Misuterii from. Then, you can opt to choose one from the existing custom modes. You may also do this if the mode you are trying to upload has already been uploaded to the server.
Custom Maps
Custom maps should be uploaded by dependency first, in dependencies exist. Generally, if a custom map does not have a dependency, then it probably will not spawn objects, as currently custom maps do not generate items in relation to the set spawn rate, and only spawn items that are forcespawned (EG. ? ? ? papers and placed items). You should always upload MapNameStart.ms first.
After you have uploaded any map dependencies, you should upload the map. It will prompt you to upload the Map.mhm file, followed by the Map.obj file. Both of these are mandatory, as the Map file is the build file and the Object file is the icon file. Lacking either will alert you that you have uploaded the wrong file and tell you that the map has failed to upload.
Maps cannot be selected from existing, as for some reason they do not save in the host's folder upon being uploaded.
Custom Modes with Custom Maps
When running a custom map during a custom mode, you should always upload the map before the custom mode, and let the map load. Once the map has finished loading, you may upload the custom mode. Otherwise it can throw up nasty, unwanted errors, some of which include nullifying mstags, blanking out custom icons, destroying map objects, and even completely destroying the mode and not allowing it to run.
Also, if a map has a spawn seed generator (a MapStart.ms), it is preferable that you wait until the map has fully loaded until moving, otherwise you could cause unwanted lag. This is worse in custom modes, where the combined loading of custom code mixes with the custom code of the map and can cause CPU spikes of 1140%. So wait patiently.