User Tools

Site Tools


hpl3:community:editors:blender_to_hpl3

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
hpl3:community:editors:blender_to_hpl3 [2019/05/02 22:28]
cadely
hpl3:community:editors:blender_to_hpl3 [2020/07/02 01:23] (current)
cadely
Line 1: Line 1:
 ====== [Add-on] Blender to HPL3 ====== ====== [Add-on] Blender to HPL3 ======
  
-<​code>​ +---- 
-https://​github.com/​cadehaley/​BlenderHPL3export ​  ​("​Clone or Download" ​-> "​Download ZIP") + 
-</​code>​+{{https://​i.imgur.com/​1PrPPuD.jpg?​nolink&​546x345}} 
 + 
 +[[https://​github.com/​cadehaley/​BlenderHPL3export|https://​github.com/​cadehaley/​BlenderHPL3export]] 
 + 
 +To Download: ​(GitHub → "Clone or Download" ​→ "​Download ZIP")
  
-**HPL3 Exporter Version ​1.2** \\+**HPL3 Exporter Version ​3.1** \\
 \\ \\
 This addon allows you to model anything from single assets\\ This addon allows you to model anything from single assets\\
Line 11: Line 15:
 automatically creating and configuring textures, material, and entity files\\ automatically creating and configuring textures, material, and entity files\\
 for a fast iteration process. The script is also capable of removing objects\\ for a fast iteration process. The script is also capable of removing objects\\
-from the HPL3 map which have been removed in the Blender scene, and baking\\+from the HPL3 map which have been removed in the Blender scene,\\ 
 +exporting rigged and animated objects, and baking\\
 lighting onto scene objects. lighting onto scene objects.
  
-===== INSTALLATION (Requires Blender 2.80 or later) =====+===== INSTALLATION (Requires Blender 2.80 Beta or later) ===== 
 + 
 +----
  
-\\ 
 1. Copy "​io_export_hpl3.py"​ and the "​nvidia"​ folder to Blender'​s addons\\ 1. Copy "​io_export_hpl3.py"​ and the "​nvidia"​ folder to Blender'​s addons\\
 directory ("​…/​Blender/​2.80/​scripts/​addons"​)\\ directory ("​…/​Blender/​2.80/​scripts/​addons"​)\\
Line 27: Line 33:
 the width of the Tools bar out to set fields, and press T to hide the tools\\ the width of the Tools bar out to set fields, and press T to hide the tools\\
 bar at any time. Have fun! bar at any time. Have fun!
 +
 +===== Important usage notes =====
  
 ---- ----
  
-===== Important usage notes =====+On export, the subdirectory and mesh file will take this name ("​Suzanne.dae"​),​ and having name conflicts in HPL3 can cause the wrong textures to load. The "​Object Name" does not matter as much, and will be used to name that instance of the object when placed in the map.
  
-\\ +  * **Rigged Meshes**: Use "Single Export" ​when you have an animated mesh broken into separate objects ​(e.gshirt, headhair) that are deformed by the same armature ​(skeleton)Exporting meshes that are deformed by different armatures ​to one file/entity is not supported by HPL3 and will produce unexpected results
-– Give each object a unique name in the asset'​s ​"Object Data" ​panel\\ +  * **Baking Modes**: 
-(under the poly triangle icon, not to be confused with the "​Object"​ panel\\ +      * Textures Per Material: ​\\ Think of each material as having its own UV set. Faces assigned to Material A \\ cannot overlap in the UV editor with other Material A faces, though it is ok \\ (even recommended) for faces assigned to Material B to use up the full UV space, ​\\ since it won't matter if a face from Material A overlaps with a face from Material B. 
-under the cube icon).\\ +  * **Instancing**: ​Use ''​Alt+D''  ​to create copies of an object in Blender to place around a map, since they will point to the same "​Mesh"​ datablock. Using Copy/Paste or Shift+D creates a new "​Mesh"​ datablock every time, and therefore a new .dae and .dds file on export, leaving you with multiple repeat numbered .dae and/or .dds files taking unnecessary space on export. 
-Example: Object name = "​evil_suzanne_by_doorway.005"​\\ +===== Troubleshooting =====
-Mesh Datablock name = "​Suzanne"​\\ +
-\\ +
-On export, the subdirectory and mesh file will take this name ("​Suzanne.dae"​),​\\ +
-and having name conflicts in HPL3 can cause the wrong textures ​to load.\\ +
-The "​Object Name" does not matter as much, and will be used to name that\\ +
-instance of the object when placed in the map.\\ +
-\\ +
-– If texture is black or has black parts, make sure UV faces are\\ +
-within the square UV boundary. Texture baking requires that each material use\\ +
-a single "​Principled BSDF" node and that all UV faces lie within UV\\ +
-coordinate bounds.\\ +
-\\ +
-– When baking multi-material,​ think of each material as having\\ +
-its own UV set. Faces assigned to Material A cannot overlap in the UV editor\\ +
-with other Material A faces, though it is ok (even recommended) for faces\\ +
-assigned to Material B to use up the full UV space, since it won't matter\\ +
-if a face from Material A overlaps with a face from Material B. Just make\\ +
-sure your mesh only uses one UV map. Check this by going to\\ +
-[Object Data (Poly Triangle Icon) > UV Maps], located under Vertex Groups\\ +
-and Shape Keys.\\ +
-\\ +
-– Use Alt+D to create copies of an object in Blender to place\\ +
-around a map, since they will point to the same "​Mesh"​ datablock. Using\\ +
-Copy/Paste or Shift+D creates a new "​Mesh"​ datablock every time, and therefore\\ +
-a new .dae and .dds file on export, leaving you with multiple repeat numbered\\ +
-.dae and/or .dds files taking unnecessary space on export.\\ +
-\\ +
-– In the Level Editor, if objects fail to appear after pressing\\ +
-the button to reload static object or entity changes, try exiting out of the\\ +
-editor and reloading your map to make objects appear properly again.+
  
 ---- ----
 +
 +  * Hover your pointer over options for more in-depth info on how to use them
 +  * When using "​Textures Per Material",​ if texture is black or has black parts, \\ make sure objects are UV unwrapped and UV faces are within the UV boundary. \\ This mode requires that all UV faces lie within UV image bounds.
 +  * If materials are failing to export properly, try switching between \\ "​Textures Per Material"​ and "​Textures Per Object",​ as one mode may \\ work better with your material setup than the other. Also, keep in mind that \\ texture baking requires that each material use a single `Principled BSDF` node
 +  * In the Level Editor, if objects fail to appear after pressing \\ the button to reload static object or entity changes, try exiting out of the \\ editor and reloading your map to make objects appear properly again.
  
 ===== BUGS ===== ===== BUGS =====
  
-\\ +---- 
-For any questions or to report any bugs, message me @cadely on the Frictional\\ + 
-Games unofficial Discord ([[https://discord.gg/sXKZ9R2|https://discord.gg/sXKZ9R2]]) or on frictionalgames.com/​forum+For any questions or to report any bugs, message me @cadely on the [[https://discordapp.com/invite/​frictionalgames|Frictional Games Discord]] or on [[http://frictionalgames.com/forum|frictionalgames.com/​forum]]
  
hpl3/community/editors/blender_to_hpl3.1556836097.txt.gz · Last modified: 2019/05/02 22:28 by cadely