Frictional Game Wiki

<h2>5. HPL Helper</h2> <div class="level2"> </div> <h3>5.1 General</h3> <div class="level3"> <p> HPL-Helper is a front-end for various programs and an editing tool for various engine purposes. Latest version of the .Net Framework must be installed to get it working. See <a href="/doku.php?id=hpl1:getting_started" class="wikilink1" title="hpl1:getting_started">Getting Started</a> for details and download location. </p> <pre class="code">\\ \\ ==== 5.2 Settings ==== </pre><p> </p> <p> Under this tab various settings can be altered. </p> <pre class="code">\\ \\ === 5.2.1 Resource Directories === </pre><p> </p> <p> The HPL-Engine doesn’t use paths when searching for files, it only searches after specific filename. The option lets you set what directories the engine will search for the files in. </p> <span class='np_break'> </span> <div class="table"><table class="inline"> <tr class="row0"> <td class="leftalign"><b>Add:</b> </td><td class="col1">Adds a new directory to the list. This MUST be a subdirectory of the folder that HPL Helper is in!</td> </tr> <tr class="row1"> <td class="leftalign"><b>Remove:</b> </td><td class="col1">Simply just removes a directory from the list.</td> </tr> <tr class="row2"> <td class="col0"><b>Save To File:</b> </td><td class="col1">Saves all the directories to a file, this button must be pressed for the resource directories to be used by the applications.</td> </tr> </table> <span class='np_break'> </span> </div> <p> <br/> <br/> </p> </div> <h3>5.3 Models</h3> <div class="level3"> <p> This part of the program is used to view and convert model files. <br/> </p> </div> <h4>5.3.1 Model File</h4> <div class="level4"> <p> Click browse and choose the file you want to work with. <em>You can open a .dae file directly or you can use a .ent file to get some/most of the ingame functionality for the model.</em> <br/> </p> </div> <h4>5.3.2 View</h4> <div class="level4"> <p> Click this button to open the model viewer. Inside the viewer hold the left mouse button and move the mouse around to change the view. Press middle button and move the mouse up and down to zoom in and out. If the model has colliders use the right mouse button to hook onto the model and then move the mouse while holding the button down to drag it around. </p> <p> For the time being there are no nice menus so one has to deal with using keys to toggle features. </p> <span class='np_break'> </span> <div class="table"><table class="inline"> <tr class="row0"> <td class="leftalign"><b>1:</b> </td><td class="col1">Turn shadows on /off.</td> </tr> <tr class="row1"> <td class="leftalign"><b>2.</b> </td><td class="col1">Show/hide colliders.</td> </tr> <tr class="row2"> <td class="col0"><b>3.</b> </td><td class="col1">Turn physics on /off.</td> </tr> <tr class="row3"> <td class="leftalign"><b>4.</b> </td><td class="col1">Change animation.</td> </tr> <tr class="row4"> <td class="leftalign"><b>5.</b> </td><td class="col1">Start/stop spinning lights.</td> </tr> <tr class="row5"> <td class="col0"><b>6.</b> </td><td class="col1">Show/hide bounding box.</td> </tr> <tr class="row6"> <td class="leftalign"><b>R</b> </td><td class="col1">Turn ragdoll on/off if present.</td> </tr> </table> <span class='np_break'> </span> </div> <p> <br/> <br/> </p> </div> <h3>5.4 Scenes</h3> <div class="level3"> <p> Under this tab a scene can be loaded and viewed. This works exactly the same way as with models (described the previous chapter) apart from a few small things. </p> <p> Beside the View button you can fill in the start pos. This will specify at what start point the camera will start at, you are using the _start entities for this, if you have a _ckgedit_QUOT<u>start_location1" entity in you map you enter "location1" to make that your starting point. If this is blank or the start position doesn’t exist the camera will be placed at (0,0,0). The following keys are used in side the viewer: |<b>W,A,S,D</b>|Movement.| |<b>Mouse</b> |Look around.| |<b>1.</b> |Toggles shadow modes, on, static only, off| |<b>2.</b> |Turn room/portal debug graphics on and off. In this mode the rooms are randomly colored according to the order they where created. The portals are colored red and have a normal in the same color to witch the room it belongs to. At the end of the portal normal is a sphere in the same color as the room the portal connects to.| |<b>3.</b> |Turns light bounding boxes on/off.| |<b>4.</b> |Turns collision geometry on/off.| |<b>5.</b> |Turns bounding boxes for entities on and off.| |<b>6.</b> |Turns sound colliders on / off.| |<b>7.</b> |Turns line rendering on / off. This is useful for optimizing portals.| |<b>8.</b> |Turns show areas on / off.| |<b>B</b> |Bloom on / off| <br/> <br/> ==== 5.5 Materials ==== There shouldn’t be anything strange in this part, the different settings are all explained in <a href="/doku.php?id=hpl1:documentation:content.creation.document#creatingmaterials" class="wikilink2" title="hpl1:documentation:content.creation.document" rel="nofollow">chapter 4</a>. Just remember that the changes aren’t updated until the file is saved! <br/> <br/> ==== 5.6 Physics Materials ==== <em>Later on there should be an editor for physical material, right now one has to write by hand. In the redist folder you'll find the <b>materials.cfg</b> file which you can edit and add materials to.</em> Physics materials are different from normal materials in that they describe physical properties of a surface/object rather can the visual. They describe what sounds are heard when two objects hit each other, how much they bounce, etc. If no material is set “Default” is used. There are several properties that need some explanation: <b>Name</b> <br/> Simply the name of the material, entities and texture refer to this. <br/> <br/> <b>Elasticity</b> <br/> How much of the energy that is conserved when the object hits another object. 0 = all is lost and 1 = no energy loss. This means 1 creates a bouncy surface or object and 0 creates a something that just stops at impact. <br/> <br/> <b>StaticFriction</b> <br/> The amount of energy required to get an object moving. The value can be between 0 and 1 (even up to 2 in special cases) and MUST be larger or equal to kinetic friction. <br/> <br/> <b>Priority</b> <br/> Gives materials different priorities, materials with the same priority will blend together while a higher priority for one material will make it dominant and the only one used. <br/> <br/> <b>KineticFriction</b> <br/> How fast the object stops sliding once it is moving (static describes how hard it is to get it start moving). This is a value between 0 and 1. <br/> <br/> <b>ElasticityMode</b> <br/> When two objects collide this describes how the elasticity values blend. See BlendMode for more information. <br/> <br/> <b>FrictionMode</b> <br/> When two objects collide this describes how the friction values blend. See BlendMode for more information. <br/> <br/> <b>BlendModes:</b> <br/> Each blendmode have a weight and when two objects collide the mode with the highest weight is used. Weight is written in front of the mode. |<b>0. Average:</b> |The average of the two values is used (r = (x+y)/2| |<b>1. Min:</b> |The smaller of the two values is used.| |<b>2. Multiply</b> |The two values are multiplied together. (r = x * y)| |<b>3. Max</b> |The largest value is used.| <br/> <b>StepType</b><br/> A game specific string meant to help specify what step sound to use. There are 3 kinds of steps: sneaking, walking and running. Make sure to name the sound entity files you want to use with the same ending, for example:player_step_sneak_dirt.snt,player_step_walk_dirt.snt,player_step_run_dirt.snt. This way the game will know what sound to use for the different kinds of steps. In the materials.cfg file make StepType = Last word in the name, meaning StepType = "dirt". This will point the game to the player_step_xxx_dirt.snt files and automatically load them all 3.<br/> <br/> <b>Scrape sound properties</b><br/> The following properties are used to set what sound is played when an object slides against some other object. Speed is in m/s and frequency is in percent / 100. This means that if frequency is 1 then the sound is played at normal (100%) speed. If it is 0.5 then the sound is played at half speed and 2 means double speed. |<b>MinScrapeSpeed</b> |The minimum speed at which the sound is played.<br/> 0 – infinity.| |<b>MinScrapeFreq</b> |The minimum frequency the sound will have.<br/> 0 – 1.| |<b>MinScrapeFreqSpeed</b> |The object speed at which the minimum frequency will be used.<br/> Frequency never goes lower once this speed is reached.<br/> 0 – infinity.| |<b>MaxScrapeFreq</b> |The maximum frequency the sound will have.<br/> 0 – infinity.| |<b>MaxScrapeFreqSpeed</b> |The object speed at which the minimum frequency will be used.<br/> Frequency never goes higher once this speed is reached.<br/> 0 – infinity.| |<b>MiddleScrapeSpeed</b> |The object speed at which normal frequency (1) is used| |<b>MinScrapeContacts</b> |The minimum number of contacts for a the scrape sound to play.<br/> 0 – infinity.| |<b>ScrapeSoundName</b> |The name of the sound entity played.| <br/> <b>Roll sound properties</b><br/> The following properties are used to set what sound is played when an object rolls. Speed is in m/s and frequency is in percent / 100. This means that if frequency is 1 then the sound is played at normal (100%) speed. If it is 0.5 then the sound is played at half speed and 2 means double speed. |<b>MinRollSpeed</b> |The minimum speed at which the sound is played.<br/> 0 – infinity.| |<b>MinRollFreq</b> |The minimum pitch frequency the sound will have.<br/> 0 – 1.| |<b>MinRollVolume</b> |The minimum volume the sound will have.<br/> 0 – 1.| |<b>MinRollFreqSpeed</b> |The object speed at which the minimum frequency will be used.<br/> Frequency never goes lower once this speed is reached.<br/> 0 – infinity.| |<b>MaxRollFreq</b> |The maximum pitch frequency the sound will have.<br/> 0 – infinity.| |<b>MaxRollVolume</b> |The volume the sound will have at maximum.<br/> 0 – 1.| |<b>MaxRollFreqSpeed</b> |The object speed at which the maximum frequency will be used.<br/> Frequency never goes higher once this speed is reached.<br/> 0 – infinity.| |<b>MiddleRollSpeed</b> |The object speed at which normal frequency (1) is used| |<b>RollSoundName</b> |The name of the sound entity played.| |<b>RollAxis</b> |Along which axis the roll is for, <em>X,Y,Z</em>.| <br/> <b>Impact properties</b><br/> The impact properties are used to define effects at impact. They are written like: <code xml> </u>GESHI_OPEN<u>Impact MinSpeed=</u>GESHI_QUOT<u>2.1</u>GESHI_QUOT<u> […] /> </u>GESHI_OPEN<u>Impact MinSpeed=</u>GESHI_QUOT<u>1.1</u>GESHI_QUOT<u> […] /> […] </code> <span class='np_break'> </span> The impacts must be written with the highest minimum speed first and then in dropping order. |<b>MinSpeed</b> |The minimum object speed at which this effect is used.| |<b>SoundName</b> |The name of the sound entity played.| |<b>PSName</b> |The name of the particle effect to use.| |<b>PSPrio</b> |What priority to use on the effect, the same uses all effects for all involved materials and higher uses only the highest.| <br/> <b>Hit properties</b><br/> The hit properties are used to define effects from hitting on an object. They are written like: <code xml> </u>GESHI_OPEN<u>Hit MinSpeed=</u>GESHI_QUOT<u>3</u>GESHI_QUOT<u> […] /> </u>GESHI_OPEN<u>Hit MinSpeed=</u>GESHI_QUOT<u>1</u>GESHI_QUOT<u> […] /> […] </code> <span class='np_break'> </span> The hits must be written with the highest minimum speed first and then in dropping order. |<b>MinSpeed</b> |The minimum object speed at which this effect is used.| |<b>SoundName</b> |The name of the sound entity played.| |<b>PSName</b> |The name of the particle effect to use.| |<b>PSPrio</b> |What priority to use on the effect, the same uses all effects for all involved materials and higher uses only the highest.| In closing a physical material entry looks somewhat like this: <code c++> </u>GESHI_OPEN<u>Material Name = </u>GESHI_QUOT<u>Name_Of_Material</u>GESHI_QUOT<u> Elasticity = </u>GESHI_QUOT<u>0</u>GESHI_QUOT<u> KineticFriction = </u>GESHI_QUOT<u>0.2</u>GESHI_QUOT<u> StaticFriction = </u>GESHI_QUOT<u>0.2</u>GESHI_QUOT<u> Priority=</u>GESHI_QUOT<u>0</u>GESHI_QUOT<u> ElasticityMode = </u>GESHI_QUOT<u>Min</u>GESHI_QUOT<u> FrictionMode = </u>GESHI_QUOT<u>Min</u>GESHI_QUOT<u> StepType=</u>GESHI_QUOT<u>The_Sound_For_Steps</u>GESHI_QUOT<u> MinScrapeSpeed = </u>GESHI_QUOT<u>0.04</u>GESHI_QUOT<u> MinScrapeFreq = </u>GESHI_QUOT<u>0.5</u>GESHI_QUOT<u> MinScrapeFreqSpeed = </u>GESHI_QUOT<u>0.7</u>GESHI_QUOT<u> MaxScrapeFreq = </u>GESHI_QUOT<u>0.8</u>GESHI_QUOT<u> MaxScrapeFreqSpeed = </u>GESHI_QUOT<u>2.5</u>GESHI_QUOT<u> MiddleScrapeSpeed = </u>GESHI_QUOT<u>1.5</u>GESHI_QUOT<u> MinScrapeContacts = </u>GESHI_QUOT<u>3</u>GESHI_QUOT<u> ScrapeSoundName = </u>GESHI_QUOT<u>The_Sound_For_Scrape</u>GESHI_QUOT<u> MinRollSpeed = </u>GESHI_QUOT<u>0.05</u>GESHI_QUOT<u> MinRollFreq = </u>GESHI_QUOT<u>0.5</u>GESHI_QUOT<u> MinRollVolume = </u>GESHI_QUOT<u>1</u>GESHI_QUOT<u> MinRollFreqSpeed = </u>GESHI_QUOT<u>0.5</u>GESHI_QUOT<u> MaxRollFreq = </u>GESHI_QUOT<u>0.8</u>GESHI_QUOT<u> MaxRollVolume = </u>GESHI_QUOT<u>1</u>GESHI_QUOT<u> MaxRollFreqSpeed = </u>GESHI_QUOT<u>1.5</u>GESHI_QUOT<u> MiddleRollSpeed = </u>GESHI_QUOT<u>1</u>GESHI_QUOT<u> RollSoundName = </u>GESHI_QUOT<u>The_Sound_For_Rolling</u>GESHI_QUOT<u> RollAxis = </u>GESHI_QUOT<u>y</u>GESHI_QUOT<u> > </u>GESHI_OPEN<u>Impact MinSpeed=</u>GESHI_QUOT<u>30</u>GESHI_QUOT<u> SoundName=</u>GESHI_QUOT<u>Hardest_Impact_Sound</u>GESHI_QUOT<u>/> </u>GESHI_OPEN<u>Impact MinSpeed=</u>GESHI_QUOT<u>20</u>GESHI_QUOT<u> SoundName=</u>GESHI_QUOT<u>Medium_Impact_Sound</u>GESHI_QUOT<u>/> </u>GESHI_OPEN<u>Impact MinSpeed=</u>GESHI_QUOT<u>10</u>GESHI_QUOT<u> SoundName=</u>GESHI_QUOT<u>Softest_Impact_Sound</u>GESHI_QUOT<u>/> </u>GESHI_OPEN<u>Hit MinSpeed=</u>GESHI_QUOT<u>3</u>GESHI_QUOT<u> SoundName=</u>GESHI_QUOT<u>Hit_Sound_Hard</u>GESHI_QUOT<u> PSName=</u>GESHI_QUOT<u>Hit_Particle_Effect_Hard</u>GESHI_QUOT<u> PSPrio=</u>GESHI_QUOT<u>10</u>GESHI_QUOT<u> /> </u>GESHI_OPEN<u>Hit MinSpeed=</u>GESHI_QUOT<u>1</u>GESHI_QUOT<u> SoundName=</u>GESHI_QUOT<u>Hit_Sound_Soft</u>GESHI_QUOT<u> PSName=</u>GESHI_QUOT<u>Hit_Particle_Effect_Soft</u>GESHI_QUOT<u> PSPrio=</u>GESHI_QUOT<u>10</u>GESHI_QUOT<u> /> </u>GESHI_OPEN__/Material> </code> <span class='np_break'> </span> </p> <p> <br/> <br/> </p> </div> <h3>5.7 Sound</h3> <div class="level3"> <p> This will allow you to create sound entity files, .snt. A sound entity file is a XML file that contains properties for a sound you want to play, for example if it should loop, at what volume, the radius and so on. It also contains information of what sound file to actually use, a valid sound file is in either .wav or .ogg. </p> <p> IMPORTANT:<br/> Sound names must be written in special way. The files must be named [name][number].[extension], for example: “mysound1.wav” and “test_sound1.ogg”. If you have several sounds that you want randomized you name them the same and with an increasing number (9 is maximum though). Example: “testsound1.wav”, “testsound2.wav” and so on. </p> <p> The names above are written <b>without</b> the extension and number. So if you have a sound called “testsound1.wav” you would write “testsound”. If there are more sounds named testsound with increasing number then writing “testsound” will take one of these at random. This part functions pretty much like Material. Below is an overview of the settings: </p> <p> <b>Main Sound</b><br/> The main sound played. <em>Remember delete the number and extension from the sound you choose, "testsound1.wav" should be entered "testsound".</em> </p> <p> <b>Start Sound</b><br/> If the sound is looping and interval is set to 0, then this will be played before main sounds start playing. <em>Remember delete the number and extension from the sound you choose, "testsound1.wav" should be entered "testsound".</em> </p> <p> <b>Stop Sound</b><br/> Just like start sound but will be played after the main sound stops. <em>Remember delete the number and extension from the sound you choose, "testsound1.wav" should be entered "testsound".</em> </p> <p> <b>Fade Start / Stop</b><br/> If the main sound should fade in/out when start / stop sound is playing. (Not implemented yet). </p> <p> <b>Loop</b><br/> If the sound should looped. </p> <p> <b>Use3D</b><br/> If the sound is heard in 3d or not affected by the player moving. Example: A sound coming from a leaking steam pipe should Use3D, but the ambient rumble in a level should not Use3D. </p> <p> <b>Stream</b><br/> If the sound is streamed. </p> <p> <b>Volume</b><br/> The volume of the sound. Valid values are 0 -1. </p> <p> <b>Min Distance</b><br/> The distance at which the sound starts getting lower. Valid values are 0 - infinitive. </p> <p> <b>Max Distance</b><br/> The distance at which the sound is quiet. Must be larger than min distance. </p> <p> <b>Interval</b><br/> If looped the sound is played in intervals. The interval is in seconds. Valid values are 0 -infinitive. </p> <p> <b>Random</b><br/> The chance of the sound playing at each interval. Valid values are 0 – 1. </p> <p> <b>Blockable</b><br/> This determines if the sound is blocked by sound blockers. </p> <p> <b>Block Volume</b><br/> This is the amount the volume is lowered when behind a sound blocker. Valid values are 0 – 1. 1 will not affect the sound and 0 will kill it completely, usually a value of about 0.5 to 0.8 gives a nice result. </p> <p> <b>Priority</b><br/> This sets what priority the sounds has in the game. The engine sets it’s own priority depending on where the sounds is.<br/> Outside max distance: 0<br/> Outside min distance: 10<br/> Inside min distance: 100<br/> </p> <p> The priority property is then added to this value. To make some collision sound more important then other collision sound the priority should be set to 0 – 100 depending on you want it to go before sounds inside min dist if it the sound itself is outside. If you have for example a radio message that must be heard and cannot be started over then set the prio to above 200. </p> <p> Valid values are 0 – 255. Higher value means higher priority. </p> <p> <b>Note:</b> When looped sounds are overridden by another, the looped sound is started over once a channel gets free. This shouldn’t be any problem for most sounds though. <br/> <br/> <br/> </p> </div>