Frictional Game Wiki

<h1>Importing Models from HPL2</h1> <div class="level1"> <p> &lt;note>Errors may come up when your models are exported to your custom story. Looking into it. </p> <p> - Romulator (11 Oct 2015)&lt;/note> </p> <p> Importing models from HPL2 to HPL3 is not a complex process but will involve needing to "convert" textures to a format that HPL3 understands. There are some problems which you may 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 entirety 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> <hr /> <p> <b><span style = "color:#333333"><span style = "font-size:24.0pt"><span style = "font-family:arial,sans-serif"><span style = "background-color:inherit">Converting HPL2 Textures to HPL3</span></span></span></span> </b> </p> <p> <span style = "color:#333333"><span style = "font-size:10.5pt"><span style = "font-family:arial,sans-serif"><span style = "background-color:inherit">Not too long ago, Frictional released the</span></span></span></span> <a href="http://steamcommunity.com/sharedfiles/filedetails/?id=570600440" class="urlextern" title="http://steamcommunity.com/sharedfiles/filedetails/?id=570600440" rel="nofollow">Amnesia: The Dark Descent Asset Pack</a><span style = "color:#333333"><span style = "font-size:10.5pt"><span style = "font-family:arial,sans-serif"><span style = "background-color:inherit">, giving us the wealth of A:TDD assets to use in HPL3, which is great news if you are an Amnesia modder looking to venture into the (albeit, semi-scary) world of HPL3 scripting. However, if you are planning on making a mod that doesn’t involve underwater stations and bloodthirsty anglerfish, then you’ll probably be pulling assets from Penumbra and Machine for Pigs as well.</span></span></span></span> </p> <p> <span style = "color:#333333"><span style = "font-size:10.5pt"><span style = "font-family:arial,sans-serif"><span style = "background-color:inherit">When loading a Machine for Pigs asset (for example) into the HPL3 Model Viewer, you’ll likely be confronted with this:</span></span></span></span> </p> <p> <img src="/lib/exe/fetch.php?w=500&h=594&tok=948e1f&media=https%3A%2F%2Fwiki.frictionalgames.com%2F_media%2Fhpl3%2Fcommunity%2Fhpl2_asset_tut_01.jpg" class="media" title="hpl2_asset_tut_01.jpg" alt="hpl2_asset_tut_01.jpg" width="500" height="594" /> </p> <p> <span style = "color:inherit"><span style = "font-size:9px"><span style = "font-family:inherit"><span style = "background-color:inherit">(Assets placed into a single folder before loading the model):</span></span></span></span> </p> <p> <span style = "color:inherit"><span style = "font-size:9px"><span style = "font-family:inherit"><span style = "background-color:inherit">Machine for Pigs\static_objects\new_church\pillar:</span></span></span></span> </p> <p> <span style = "color:inherit"><span style = "font-size:9px"><span style = "font-family:inherit"><span style = "background-color:inherit">NC_pillar_arch_heavy.dae</span></span></span></span> </p> <p> <span style = "color:inherit"><span style = "font-size:9px"><span style = "font-family:inherit"><span style = "background-color:inherit">Machine for Pigs\static_objects\new_church:</span></span></span></span> </p> <p> <span style = "color:inherit"><span style = "font-size:9px"><span style = "font-family:inherit"><span style = "background-color:inherit">NC_wall_details.dds</span></span></span></span> </p> <p> <span style = "color:inherit"><span style = "font-size:9px"><span style = "font-family:inherit"><span style = "background-color:inherit">NC_wall_details_nrm.dds</span></span></span></span> </p> <p> <span style = "color:inherit"><span style = "font-size:9px"><span style = "font-family:inherit"><span style = "background-color:inherit">NC_wall_details_spec.dds</span></span></span></span> </p> <p> <span style = "color:#333333"><span style = "font-size:10.5pt"><span style = "font-family:arial,sans-serif"><span style = "background-color:inherit">You’ll notice that the lighting reacts very strangely when using “Keylight on Camera” and that an odd green sheen can be seen tween the edges in the scene. This is because of a change over the way that specular textures (file_spec.dds) and normal textures (file_nrm.dds) are interpreted in HPL3.</span></span></span></span> </p> <p> <span style = "color:#333333"><span style = "font-size:10.5pt"><span style = "font-family:arial,sans-serif"><span style = "background-color:inherit">This section will present a guide of how to convert these specular and normal textures from HPL2 format to HPL3 format using Photoshop CS6 with the</span></span></span></span> <a href="https://developer.nvidia.com/nvidia-texture-tools-adobe-photoshop" class="urlextern" title="https://developer.nvidia.com/nvidia-texture-tools-adobe-photoshop" rel="nofollow">Nvidia DDS Exporter</a> <span style = "color:#333333"><span style = "font-size:10.5pt"><span style = "font-family:arial,sans-serif"><span style = "background-color:inherit">plugin</span></span></span></span> <span style = "color:#333333"><span style = "font-size:10.5pt"><span style = "font-family:arial,sans-serif"><span style = "background-color:inherit">. GIMP users can also follow the manual process below provided the GIMP DDS exporter is installed.</span></span></span></span> </p> <p> <b><span style = "color:#333333"><span style = "font-size:24.0pt"><span style = "font-family:arial,sans-serif"><span style = "background-color:inherit">Converting a Specular Texture</span></span></span></span> </b> </p> <p> <b><u><span style = "color:#333333"><span style = "font-size:10.5pt"><span style = "font-family:arial,sans-serif"><span style = "background-color:inherit">Method 1: Photoshop Script</span></span></span></span> </u> </b> </p> <ol> <li class="level1"> <span style = "color:#333333"><span style = "font-size:10.5pt"><span style = "font-family:arial,sans-serif"><span style = "background-color:inherit">Save the following block of code in an administrative-level text editor as <u> HPL2specConvert.jsx </u> under</span></span></span></span></li> </ol> <p> <span style = "color:#333333"><span style = "font-size:10.5pt"><span style = "font-family:arial,sans-serif"><span style = "background-color:inherit">C:\Program Files\Adobe\Adobe Photoshop CS6 (64 Bit)\Presets\Scripts\</span></span></span></span> <span style = "color:#333333"><span style = "font-size:10.5pt"><span style = "font-family:arial,sans-serif"><span style = "background-color:inherit">(or wherever your Photoshop installation is…)</span></span></span></span> </p> <pre class="code">if (documents.length&gt; 0) { alert("Document is open, press ok to convert."); var theImage = app.activeDocument; // Unlock background layer var layers = activeDocument.layers; var layer = layers[layers.length - 1]; // rename Background layer if (layer.isBackgroundLayer) { layer.name = 'Background'; } // Save channel names var red = theImage.channels.getByName("Red"); var green = theImage.channels.getByName("Green"); var blue = theImage.channels.getByName("Blue"); if (theImage.channels.length&gt; 3){ // If there are 4 channels, alpha is probably last one var alpha = theImage.channels[theImage.channels.length - 1] alert(alpha); } else{ var alpha = theImage.channels.add(); alpha.name = "Alpha 1"; } var aChannelArray = new Array(); // Set only GREEN channel active aChannelArray = new Array(); aChannelArray[0] = green; theImage.activeChannels = aChannelArray; // Select all theImage.selection.selectAll(); // Copy theImage.selection.copy(); // Set alpha channel active aChannelArray = new Array(); aChannelArray[0] = alpha; theImage.activeChannels = aChannelArray; // Paste theImage.paste(); // Set only RED channel active aChannelArray = new Array(); aChannelArray[0] = red; theImage.activeChannels = aChannelArray; // Select all theImage.selection.selectAll(); // Copy theImage.selection.copy(); // Set GREEN active and paste aChannelArray = new Array(); aChannelArray[0] = green; theImage.activeChannels = aChannelArray; theImage.paste(); // Set BLUE active and paste aChannelArray = new Array(); aChannelArray[0] = blue; theImage.activeChannels = aChannelArray; theImage.paste(); // REACTIVATE ALL CHANNELS aChannelArray = new Array(); aChannelArray[0] = red; aChannelArray[1] = green; aChannelArray[2] = blue; // now activate them for realz theImage.activeChannels = aChannelArray; } else { alert("No doc open"); } </pre><p> </p> <p> <span style = "color:#333333"><span style = "font-size:10.5pt"><span style = "font-family:arial,sans-serif"><span style = "background-color:inherit">2. Open the specular texture in Photoshop and run the script from File > Scripts > HPL2specConvert</span></span></span></span> </p> <p> <span style = "color:#333333"><span style = "font-size:10.5pt"><span style = "font-family:arial,sans-serif"><span style = "background-color:inherit">3. Save as a .DDS file of type DXT5, preferably with “_spec” still appended to the end of the filename</span></span></span></span> </p> <p> <b><u><span style = "color:#333333"><span style = "font-size:10.5pt"><span style = "font-family:arial,sans-serif"><span style = "background-color:inherit">Method 2: Manual</span></span></span></span> </u> </b> </p> <ol> <li class="level1"> <span style = "color:#333333"><span style = "font-size:10.5pt"><span style = "font-family:arial,sans-serif"><span style = "background-color:inherit">Open the specular texture in Photoshop.</span></span></span></span></li> </ol> <p> <img src="/lib/exe/fetch.php?w=500&h=289&tok=6a5fa3&media=https%3A%2F%2Fwiki.frictionalgames.com%2F_media%2Fhpl3%2Fcommunity%2Fhpl2_asset_tut_03.jpg" class="media" title="hpl2_asset_tut_03.jpg" alt="hpl2_asset_tut_03.jpg" width="500" height="289" /> </p> <p> <span style = "color:#333333"><span style = "font-size:10.5pt"><span style = "font-family:arial,sans-serif"><span style = "background-color:inherit">An HPL2 image such as this AAMFP texture will appear as green, because HPL2 relies on the individual channels for specular information, where <u> Red = Intensity, Green = Power, and Blue = Unused (black) </u> . The HPL3 format relies on Red, Green, and Blue for Intensity, and relies on the Alpha channel for Power.</span></span></span></span> </p> <p> <span style = "color:#333333"><span style = "font-size:10.5pt"><span style = "font-family:arial,sans-serif"><span style = "background-color:inherit">For more information, look at the</span></span></span></span> <a href="https://wiki.frictionalgames.com/hpl3/tutorials/basic_modeling" class="urlextern" title="https://wiki.frictionalgames.com/hpl3/tutorials/basic_modeling" rel="nofollow">HPL3 Modeling Tutorial</a> </p> <p> <span style = "color:#333333"><span style = "font-size:10.5pt"><span style = "font-family:arial,sans-serif"><span style = "background-color:inherit">Our goal is to create a copy of the intensity channel on the Red, Green, and Blue channels, and move the power channel to the Alpha channel.</span></span></span></span> </p> <p> <span style = "color:#333333"><span style = "font-size:10.5pt"><span style = "font-family:arial,sans-serif"><span style = "background-color:inherit">2. Go to the “Channels” tab next to Layers, and select only the green channel. Select with Ctrl-A and copy the channel to the clipboard.</span></span></span></span> </p> <p> <span style = "color:#333333"><span style = "font-size:10.5pt"><span style = "font-family:arial,sans-serif"><span style = "background-color:inherit">3. If an “Alpha” channel already exists, select it, otherwise create a new channel using the button at the bottom of the pane and paste into the Alpha layer.</span></span></span></span> </p> <p> <img src="/lib/exe/fetch.php?w=500&h=293&tok=d002d9&media=https%3A%2F%2Fwiki.frictionalgames.com%2F_media%2Fhpl3%2Fcommunity%2Fhpl2_asset_tut_04.jpg" class="media" title="hpl2_asset_tut_04.jpg" alt="hpl2_asset_tut_04.jpg" width="500" height="293" /> </p> <p> <span style = "color:#333333"><span style = "font-size:10.5pt"><span style = "font-family:arial,sans-serif"><span style = "background-color:inherit">4. Select the Red channel, Ctrl-A, copy, then select the Green channel and Blue channel individually, pasting the same (red channel) clipboard image each time</span></span></span></span> </p> <p> <span style = "color:#333333"><span style = "font-size:10.5pt"><span style = "font-family:arial,sans-serif"><span style = "background-color:inherit"></span></span></span></span> </p> <p> <span style = "color:#333333"><span style = "font-size:10.5pt"><span style = "font-family:arial,sans-serif"><span style = "background-color:inherit">5. Save as a .DDS file of type DXT5, preferably with “_spec” still appended to the end of the filename</span></span></span></span> </p> <p> <b><span style = "color:#333333"><span style = "font-size:24.0pt"><span style = "font-family:arial,sans-serif"><span style = "background-color:inherit">Converting a Normal Texture</span></span></span></span> </b> </p> <ol> <li class="level1"> <span style = "color:#333333"><span style = "font-size:10.5pt"><span style = "font-family:arial,sans-serif"><span style = "background-color:inherit">Simply open the normal texture (typically _nrm appended to filename) and save using the NVIDIA exporter in the <u> 3DC format </u> . Do not forget to switch this back to DXT5 when exporting other DDS textures.</span></span></span></span></li> </ol> <p> <img src="/lib/exe/fetch.php?w=500&h=323&tok=07c50d&media=https%3A%2F%2Fwiki.frictionalgames.com%2F_media%2Fhpl3%2Fcommunity%2Fhpl2_asset_tut_06.jpg" class="media" title="hpl2_asset_tut_06.jpg" alt="hpl2_asset_tut_06.jpg" width="500" height="323" /> </p> <p> <span style = "color:#333333"><span style = "font-size:10.5pt"><span style = "font-family:arial,sans-serif"><span style = "background-color:inherit">If all is well and good, you should have an asset with working lighting and proper specular highlights, ready for you to place in your HPL3 map.</span></span></span></span> </p> <p> <img src="/lib/exe/fetch.php?w=600&h=468&tok=184cdd&media=https%3A%2F%2Fwiki.frictionalgames.com%2F_media%2Fhpl3%2Fcommunity%2Fhpl2_asset_tut_07.jpg" class="media" title="hpl2_asset_tut_07.jpg" alt="hpl2_asset_tut_07.jpg" width="600" height="468" /> <br/> <span style = "color:#333333"><span style = "font-size:10.5pt"><span style = "font-family:arial,sans-serif"><span style = "background-color:inherit">Note that if the object is an entity, you might have to open the .ent file with the Model Editor and save the file again, then test to see that the entity is still functioning properly and make adjustments- see the below sections.</span></span></span></span> </p> <hr /> </div> <h2><span style = "color:#333333"><span style = "font-size:24.0pt"><span style = "font-family:arial,sans-serif"><span style = "background-color:inherit">Importing to the Level Editor</span></span></span></span></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. After converting the textures, it is more or less just a copy and paste of the static_objects in question (plus their textures) into SOMA's static_objects folder, or your mod's directory. 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, then modify the textures. 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> &lt;note>The Manpigs from Amnesia: A Machine For Pigs are currently untested. I will look into this at a later time.&lt;/note> </p> <p> &lt;note>At current, because I am not fully aware of making custom classes, monsters you import will not have the sounds they usually had in their previous games. I will look into this at a later time.&lt;/note> </p> <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 Brute, 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="level1"> <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>