Frictional Game Wiki

<h1>Setting up a basic item in SOMA</h1> <div class="level1"> <p> Items in SOMA work quite a bit differently, this tutorial will show how to do a basic item. this guide is written minutes after I made my first item so it will be updated by me or others in the future. </p> <p> <b>STEP 1</b> Open the model editor </p> <p> <b>STEP 2</b> import your item's .dae 3d model as you would when setting up any other kind of entity. give it a body, and set up physics and such if you want to. </p> <p> <b>STEP 3</b> Go to Entity Settings → Class </p> <p> <b>STEP 4</b> Set the class as prop_tool </p> <p> <b>STEP 5</b> Expand the tool tab and configure the following: </p> <p> <b>HudObjectEntity:</b> Not sure if this is needed for item to work, but type in the name of your item, and add _hud.ent at the end of its name. fx if I had an item named lighter_item.ent, I would type in lighter_item_hud.ent. we will create this file later </p> <p> <b>InventoryIcon</b> write the name including the filetype of your inventory icon. I have only confirmed .tga files to be supported so far, and they should have a size of 128×128 with alpha(transparancy) around the object icon unless it fill all 128×128 pixels. the standard SOMA inventory only uses black white and alpha, but you can use colors if you want to as well. </p> <p> <b>STEP 6</b>(possibly optional, will have to test it) Save your file as an entity in mods/mymodfolder/assets. After saving you click SAVE AS again, and save a copy of your item in the same place, but name it with _hud.ent after its name this time. </p> <p> <b>STEP 7</b> Delete bodies and other interactive stuff from you entity, leave only the things that are visual which will usually only be the model itself. </p> <p> <b>STEP 8</b> Go to Entity setting → Class and change the class to Prop_HudObject and make sure to save. </p> <p> <b>STEP 9</b> </p> <p> <b>Method 1:</b> Open your level editor. Place a standard SOMA entity in your map where you want your item to be. Click on entity file and using the file broswer locate your item. Note this method will only work if your item is located in "mods"/mymodfolder/"assets"/ </p> <p> <b>Method 2:</b> Go to SOMA/entities and add a folder just for your own entities. Open your level editor and locate the entity from your folder, then place it where you want it. This method has the risk of causing conflicts with where the map points to the files, and is not recommended, unless you have a lot of items and cannot afford to repeat method 1 many times. </p> <p> <b>STEP 10</b> voula! you now have an item you can place in your mod. When you pick it up the generic hand animation should play with your item in the hand, though it will probably be a little misplaced and floating. Should be a way to set the item to fit the hand though. As well if you press tab your inventory icon should appear. </p> </div>