Frictional Game Wiki

<h1>Importing Models from HPL2</h1> <div class="level1"> <p> Importing models has become much easier than what I had originally thought. There are some problems which you are likely to face, and this tutorial is here to try and tackle some of the errors and give you a basic idea of importing models from Amnesia: The Dark Descent and Amnesia: A Machine For Pigs. </p> </div> <h3>Legal Information</h3> <div class="level3"> <p> Please refrain from importing these models and releasing the entireity of them. By following this tutorial, it is assumed you have a legally purchased copy of Amnesia: The Dark Descent and/or Amnesia: A Machine For Pigs. While I cannot stop you from performing these steps, please consider some respect for the modellers and their works by purchasing the games. </p> </div> <h2>Importing to the Level Editor</h2> <div class="level2"> </div> <h3>How can I import Static Objects?</h3> <div class="level3"> <p> Static Objects are arguably, very easy to import. It is more or less just a copy and paste of the static_objects you require in question into SOMA's static_objects folder. For the sake of examples, I will use mansionbase, since mansionbase is probably the most common. </p> <p> Create a new folder in your SOMA's static_objects directory and call it amnesia. If you are using Steam on a Windows system, this is the directory you should be making: </p> <pre class="file">C:\Program Files (x86)\Steam\steamapps\common\SOMA\static_objects\amnesia </pre><p> </p> <p> Paste any Amnesia static_object folder(s) into there. In my particular case, I have only added mansionbase, thus I have this layout right now. </p> <p> <a href="/lib/exe/fetch.php?tok=e9a34d&media=http%3A%2F%2Fpuu.sh%2Fkz7uV%2F67a16f19a7.png" class="media" title="http://puu.sh/kz7uV/67a16f19a7.png"><img src="/lib/exe/fetch.php?w=800&tok=e90fa8&media=http%3A%2F%2Fpuu.sh%2Fkz7uV%2F67a16f19a7.png" class="media" alt="" width="800" /></a> </p> <p> That should be it! However, some static_objects may not work correctly; for example, their texture may not appear in the editor or in game. Check out the troubleshooting heading below for how to fix those kinds of problems! </p> </div> <h3>How can I import Entities?</h3> <div class="level3"> <p> Entities are imported by a similar method to static_objects, however there is an additional step. For this example, I will use the furniture > bath model from Amnesia: A Machine For Pigs. </p> <p> Create a new folder in your SOMA's entities directory and call it amnesia. If you are using Steam on a Windows system, this is the directory you should be making: </p> <pre class="file">C:\Program Files (x86)\Steam\steamapps\common\SOMA\entities\amnesia </pre><p> </p> <p> Paste any Amnesia entity folder(s) into there. In my particular case, I have enemies and the furniture, thus I have this layout right now. Within furniture, I have the bath entity. Just like the static objects however, you may have problems with textures loading incorrectly, check the troubleshooting below. </p> <p> <a href="/lib/exe/fetch.php?tok=bd2e96&media=http%3A%2F%2Fpuu.sh%2Fkz94u%2Fc5e26e29c1.png" class="media" title="http://puu.sh/kz94u/c5e26e29c1.png"><img src="/lib/exe/fetch.php?w=800&tok=56cbf6&media=http%3A%2F%2Fpuu.sh%2Fkz94u%2Fc5e26e29c1.png" class="media" alt="" width="800" /></a> </p> <p> Now because you are dealing with entities, you can specify the behaviour it has. You can define if you can grab the entity, push it, make it an item or even into an enemy (with no animations). </p> <p> To get started, open it up with the Model Editor. You can do this by running the Model Editor from the SOMA folder and using File > Open to open the .ent file of the imported model(s). For this particular example, I opened the bath model. </p> <p> <a href="/lib/exe/fetch.php?tok=4a0bb8&media=http%3A%2F%2Fpuu.sh%2Fkz8Ux%2F1ff56e70d6.jpg" class="media" title="http://puu.sh/kz8Ux/1ff56e70d6.jpg"><img src="/lib/exe/fetch.php?w=800&tok=3bb456&media=http%3A%2F%2Fpuu.sh%2Fkz8Ux%2F1ff56e70d6.jpg" class="media" title="1ff56e70d6.jpg" alt="1ff56e70d6.jpg" width="800" /></a> </p> <p> In the top left corner, click Entity settings > Class. It will load up a window similar to the one in the next image. </p> <p> To show off what you can do to any entity in the game, I decided to make the bath a prop_grab. Which means, I can hold the bath like if it were a chair in SOMA. I also added the bloody bath model to show that I cannot grab it (because it is a StaticProp object, which, most entities will be by default when imported). </p> <p> <a href="/lib/exe/fetch.php?tok=6d8898&media=http%3A%2F%2Fpuu.sh%2Fkz8XK%2F1c12c96cc7.jpg" class="media" title="http://puu.sh/kz8XK/1c12c96cc7.jpg"><img src="/lib/exe/fetch.php?w=800&tok=cc927c&media=http%3A%2F%2Fpuu.sh%2Fkz8XK%2F1c12c96cc7.jpg" class="media" title="1c12c96cc7.jpg" alt="1c12c96cc7.jpg" width="800" /></a> </p> <p> Then I created a terrible map to test it with. Notice how I have both Amnesia: The Dark Descent mansionbase static objects and Amnesia: A Machine For Pigs entities? </p> <p> <a href="/lib/exe/fetch.php?tok=8fb639&media=http%3A%2F%2Fpuu.sh%2Fkz9o6%2F08bf47f3cd.jpg" class="media" title="http://puu.sh/kz9o6/08bf47f3cd.jpg"><img src="/lib/exe/fetch.php?w=800&tok=b69f1d&media=http%3A%2F%2Fpuu.sh%2Fkz9o6%2F08bf47f3cd.jpg" class="media" title="08bf47f3cd.jpg" alt="08bf47f3cd.jpg" width="800" /></a> </p> <p> Then I tested the map and I have a bath which I can lift with one hand, and one I cannot lift at all. </p> <p> <a href="/lib/exe/fetch.php?tok=c50c6b&media=http%3A%2F%2Fpuu.sh%2FkzamV%2F4ec0e48d62.jpg" class="media" title="http://puu.sh/kzamV/4ec0e48d62.jpg"><img src="/lib/exe/fetch.php?w=400&tok=e06098&media=http%3A%2F%2Fpuu.sh%2FkzamV%2F4ec0e48d62.jpg" class="media" title="4ec0e48d62.jpg" alt="4ec0e48d62.jpg" width="400" /></a><a href="/lib/exe/fetch.php?tok=236c5f&media=http%3A%2F%2Fpuu.sh%2Fkzalf%2Fda0de3b82e.jpg" class="media" title="http://puu.sh/kzalf/da0de3b82e.jpg"><img src="/lib/exe/fetch.php?w=400&tok=a00ba5&media=http%3A%2F%2Fpuu.sh%2Fkzalf%2Fda0de3b82e.jpg" class="media" title="da0de3b82e.jpg" alt="da0de3b82e.jpg" width="400" /></a> </p> <p> And that's how you import Entities into the game! Have fun! </p> </div> <h3>How can I import Enemies?</h3> <div class="level3"> <p> Import the enemies just like in the entity tutorial above until you get to the Model Editor step. Load up the enemy. You may get a prompt when loading up the enemy. Just press OK and you should be good to go. In the case of Amnesia's notorious Servant Brunt, we will load it up and be greeted by this. </p> <p> <a href="/lib/exe/fetch.php?tok=22bbfa&media=http%3A%2F%2Fpuu.sh%2FkzcJr%2Ffa220f02f7.jpg" class="media" title="http://puu.sh/kzcJr/fa220f02f7.jpg"><img src="/lib/exe/fetch.php?w=800&tok=4cd0d3&media=http%3A%2F%2Fpuu.sh%2FkzcJr%2Ffa220f02f7.jpg" class="media" title="fa220f02f7.jpg" alt="fa220f02f7.jpg" width="800" /></a> </p> <p> Load up the Class prompt by clicking Entity Settings > Class. For now, change the Class to Agent_Infected_Robot as it is the closest class to the Brute's (and the grunt for that matter) behaviour. If you are importing one of the suitors from Justine, to keep them blind, use the Agent_Puppet class. </p> <p> <a href="/lib/exe/fetch.php?tok=2be9e9&media=http%3A%2F%2Fpuu.sh%2FkzcQj%2F6adb3f1d04.jpg" class="media" title="http://puu.sh/kzcQj/6adb3f1d04.jpg"><img src="/lib/exe/fetch.php?w=800&tok=c33582&media=http%3A%2F%2Fpuu.sh%2FkzcQj%2F6adb3f1d04.jpg" class="media" title="6adb3f1d04.jpg" alt="6adb3f1d04.jpg" width="800" /></a> </p> <p> In the bottom, click on the gears, then in the bottom left corner, click Edit Animations. We will get a window like this: </p> <p> <a href="/lib/exe/fetch.php?tok=9d68ec&media=http%3A%2F%2Fpuu.sh%2FkzdqL%2F96d8da1ab2.jpg" class="media" title="http://puu.sh/kzdqL/96d8da1ab2.jpg"><img src="/lib/exe/fetch.php?w=800&tok=aa3579&media=http%3A%2F%2Fpuu.sh%2FkzdqL%2F96d8da1ab2.jpg" class="media" title="96d8da1ab2.jpg" alt="96d8da1ab2.jpg" width="800" /></a> </p> <p> SOMA does not use all of these animations. It uses only a few of them. What we have to do is show SOMA where these animations can be found. Using the Entity > Class window, scroll down to CharMover and expand the tab. Fill it with the animation entries as they appear on the right side - case sensitive. And if you want, and understand how head turning works, you can try editting the options below. </p> <p> <a href="/lib/exe/fetch.php?tok=8d73b0&media=http%3A%2F%2Fpuu.sh%2FkzdHY%2F5e0c2f2a44.jpg" class="media" title="http://puu.sh/kzdHY/5e0c2f2a44.jpg"><img src="/lib/exe/fetch.php?w=800&tok=2edcc9&media=http%3A%2F%2Fpuu.sh%2FkzdHY%2F5e0c2f2a44.jpg" class="media" title="5e0c2f2a44.jpg" alt="5e0c2f2a44.jpg" width="800" /></a> </p> </div> <h2>Exporting in a Campaign or Mod</h2> <div class="level2"> <p> Just make sure to include them in your mod in some way. The filename of the model has to match the "mesh filename" which you can see in the Level Editor, which should be okay if you don't suddenly change the file names. Make sure the folder you put the assets in is referenced in the resources.cfg file. </p> </div> <h2>Troubleshooting</h2> <div class="level2"> </div> <h3>My Model is not appearing correctly. Why?</h3> <div class="level3"> <p> <a href="/lib/exe/fetch.php?tok=284aa1&media=http%3A%2F%2Fpuu.sh%2Fkz9f7%2F43cf656364.jpg" class="media" title="http://puu.sh/kz9f7/43cf656364.jpg"><img src="/lib/exe/fetch.php?w=800&tok=f42904&media=http%3A%2F%2Fpuu.sh%2Fkz9f7%2F43cf656364.jpg" class="media" title="43cf656364.jpg" alt="43cf656364.jpg" width="800" /></a> </p> <p> This will generically be caused by one of two things: </p> <ol> <li class="level1"> <b>The model cannot find all connected submeshes.</b> <br/> This means that there is a model or .dae file missing. You will know this is the case if when you place down a model and it does not appear in the editor (see the image above), and upon clicking where it is placed, does not actually select the model. To fix this, you'll need to open the model in the HPL2 Model Editor and locate where the referenced models are located in The Dark Descent or in Machine For Pigs. Make sure you copy all of them over into your SOMA directory, and it would be a good idea to try and keep them as close to the original directory as possible.</li> <li class="level2"> <b>The model has all of its components but not its material (or all of its textures).</b> <br/> This means you do not have the material or the textures (or even just the diffuse texture) in a recognisable location for your entity or static object. An example that comes to mind is the towels in A Machine For Pigs, as they base their texture off a carpet material file. To check what material it uses, you can open up the model in the HPL2 Model Editor and press the [+] button next to the mesh. It should show you the name of the .dds textures. Most of the time, all the materials and .dds files will appear there, but you can get all of them.</li> </ol> </div> <h3>When testing my level, my model appears at XYZ = 0.</h3> <div class="level3"> <p> This is a problem caused by the meshes of some Amnesia: A Machine For Pigs models. I do not know if these problems will persist in HPL3, but if it does, the simplest way is to delete the .msh and the .anm files if there are any included with that particular model. That will generate a new .msh file which HPL3 can recognise. </p> </div> <h2>Other problems? Questions?</h2> <div class="level2"> <p> If you have any questions or face other problems, please, feel free to start a thread in <a href="https://www.frictionalgames.com/forum/forum-82.html" class="urlextern" title="https://www.frictionalgames.com/forum/forum-82.html" rel="nofollow">SOMA's Development support forum</a>, or drop a <a href="https://www.frictionalgames.com/forum/private.php?action=send&uid=27667" class="urlextern" title="https://www.frictionalgames.com/forum/private.php?action=send&uid=27667" rel="nofollow">Personal Message to Romulator</a> on the forum. I may not be able to solve all problems, but if I cannot, I'll just ask you create a thread. </p> </div>