Difference between revisions of "Collision Painting"

From Wolfire Games Wiki
Jump to: navigation, search
(How To Use: Added Image of the Collision Paint window)
m (How To Use: Corrected formatting on the arrow in the View step.)
 
(27 intermediate revisions by 3 users not shown)
Line 1: Line 1:
The Collision Paint tool is used to set an object ('''TODO: Terrain?''') trangle's behaviour upon impact with the player. '''TODO: What about NPCs?'''
+
The Collision Paint tool is used to ''"label"'' objects or parts of objects to change how they interact with characters that collide with it. You can not paint collision on a level's terrain object.
  
 
==How To Use==
 
==How To Use==
 +
The Collision Paint window can be accessed in Edit Mode by navigating in the menu bar to ''Windows'' -> ''Collision Paint''.
 
[[File:Coll_Paint_Window.jpg|thumb|alt=Collision Paint window|Collision Paint window]]
 
[[File:Coll_Paint_Window.jpg|thumb|alt=Collision Paint window|Collision Paint window]]
The Collision Paint window can be accessed in Edit Mode by navigating in the menu bar to ''Windows'' -> ''Collision Paint''.
 
  
* View the collision by checking ''View Collision''
+
* View the collision by checking ''View -> Collision paint visualization''
 
* To paint whatever the cursor hovers over press B
 
* To paint whatever the cursor hovers over press B
 
* To paint the whole object check ''Per-object''
 
* To paint the whole object check ''Per-object''
Line 11: Line 11:
 
** To only paint the hovered triangle check ''Don't Spread''
 
** To only paint the hovered triangle check ''Don't Spread''
 
** To paint the hovered triangle and adjacent triangles with the same orientation check ''Spread across flat surfaces''
 
** To paint the hovered triangle and adjacent triangles with the same orientation check ''Spread across flat surfaces''
** To spread to Triangles with similar normals check ''Spread across similar normals'' '''TODO: Does this only include triangles of the same object or not?'''
+
** To spread to Triangles with similar orientation on the same object check ''Spread across similar normals''
* To load press ''Load''
+
*** The ''Range'' decides how similar the normals of each triangle need to be to spread, 1 spreads almost nothing, -1 spreads to everything
* To save press ''Save'' '''TODO: Does this work? Does it save to an extra file?'''
+
* The ''Load'' button loads any currently existing collision paint to Data/Levels/[mod-folder].
 +
* The ''Save'' button saves the current collision paint to Data/Levels/[mod-folder].
 +
 
 +
The collision painting for a level is saved next to the level's XML file with the file name ''*.col_norm.zip'' where the * is the name of the level's file.
 +
 
 +
'''Something to keep in mind is that ''*.col_norm.zip'' files are saved to your game's Data/Levels folder. You will have to move it into your Mod directory, otherwise the collision paint will not be included with your mod.'''
 +
 
 +
==Labels==
 +
[[File:Collision_paint.jpg|thumb|alt=Collision Paint window|Collision Paint color chart]]
  
==Configuration==
+
The label checked in the lower box will be applied to the triangles by painting. The painted surfaces will indicate its parameter with a specific color when ''View Collision'' is checked.
The parameter checked in the lower box will be applied to the triangles by painting.
+
Each label's color is written between parentheses below.
'''TODO: What's up with the semi transparent Triangles? Is it possible to apply a property with a specific "strength"? how?'''
 
  
 
===Floor===
 
===Floor===
'''TODO: add and confirm the effects'''
+
* '''Walkable:''' (Green) The surface is treated as if it is facing upward, so it's easier and faster to move around on, useful for stairs and for making bumpy areas easier to move around on.
* '''Walkable:'''
+
* '''Balance:''' (Light-Green) When painted on very thin surfaces the character's feet will stand better on the object. '''This is not functional; Using this type will cause issues.'''
* '''Balance:'''
+
* '''Slide:''' (Cyan) Makes characters slide off of the surface. If a character jumps while on this surface, they always jump straight upwards. If a character slides into the ground, there will be some audio issues.
* '''Slide:'''
 
  
 
===Wall===
 
===Wall===
'''TODO: add and confirm the effects'''
+
* '''Wallrun:''' (Red) Allows wall running on those triangles if they're steep enough.
* '''Wallrun:'''
+
* '''No wallrun:''' (Orange) Won't allow wall running and climbing on those triangles.
* '''No wallrun:'''
+
* '''Ledge:''' (Pink) Forces the triangles to be treated as a ledge that can be grabbed, some constraints still apply, but this marking makes the system more lenient.
* '''Ledge:'''
+
* '''Ragdoll:''' (Blue) Character ragdolls if it touches the surface.
* '''Ragdoll:'''
+
* '''Ragdoll-death:''' (Blue) Character dies if it touches the surface.
* '''Ragdoll-death:'''
+
 
 
===Ceiling===
 
===Ceiling===
'''TODO: add and confirm the effects'''
+
* '''Ceiling:''' (Blue) The surface is regarded as if it's facing downwards, so you can't land on it, and you will bounce down if you jump up into it.
* '''Ceiling:'''
+
 
 
===Unlabled===
 
===Unlabled===
'''TODO: add and confirm the effects'''
+
* '''Clear:''' (No color) Resets to the default collision behavior which is based on the triangles normal.
* '''Clear:'''
+
* '''No climb:''' (Grey) Has default collision behavior except that the edges can't be grabbed.
* '''No climb:'''
+
** You can paint the 'no-climb' label to all unlabled triangles by clicking the ''Apply 'no climb' to all unlabled surfaces'' button
 +
 
 +
[[Category: Overgrowth]]
 +
[[Category: Modding]]

Latest revision as of 20:37, 12 July 2022

The Collision Paint tool is used to "label" objects or parts of objects to change how they interact with characters that collide with it. You can not paint collision on a level's terrain object.

How To Use

The Collision Paint window can be accessed in Edit Mode by navigating in the menu bar to Windows -> Collision Paint.

Collision Paint window
Collision Paint window
  • View the collision by checking View -> Collision paint visualization
  • To paint whatever the cursor hovers over press B
  • To paint the whole object check Per-object
  • To paint per-triangle check per-triangle
    • To only paint the hovered triangle check Don't Spread
    • To paint the hovered triangle and adjacent triangles with the same orientation check Spread across flat surfaces
    • To spread to Triangles with similar orientation on the same object check Spread across similar normals
      • The Range decides how similar the normals of each triangle need to be to spread, 1 spreads almost nothing, -1 spreads to everything
  • The Load button loads any currently existing collision paint to Data/Levels/[mod-folder].
  • The Save button saves the current collision paint to Data/Levels/[mod-folder].

The collision painting for a level is saved next to the level's XML file with the file name *.col_norm.zip where the * is the name of the level's file.

Something to keep in mind is that *.col_norm.zip files are saved to your game's Data/Levels folder. You will have to move it into your Mod directory, otherwise the collision paint will not be included with your mod.

Labels

Collision Paint window
Collision Paint color chart

The label checked in the lower box will be applied to the triangles by painting. The painted surfaces will indicate its parameter with a specific color when View Collision is checked. Each label's color is written between parentheses below.

Floor

  • Walkable: (Green) The surface is treated as if it is facing upward, so it's easier and faster to move around on, useful for stairs and for making bumpy areas easier to move around on.
  • Balance: (Light-Green) When painted on very thin surfaces the character's feet will stand better on the object. This is not functional; Using this type will cause issues.
  • Slide: (Cyan) Makes characters slide off of the surface. If a character jumps while on this surface, they always jump straight upwards. If a character slides into the ground, there will be some audio issues.

Wall

  • Wallrun: (Red) Allows wall running on those triangles if they're steep enough.
  • No wallrun: (Orange) Won't allow wall running and climbing on those triangles.
  • Ledge: (Pink) Forces the triangles to be treated as a ledge that can be grabbed, some constraints still apply, but this marking makes the system more lenient.
  • Ragdoll: (Blue) Character ragdolls if it touches the surface.
  • Ragdoll-death: (Blue) Character dies if it touches the surface.

Ceiling

  • Ceiling: (Blue) The surface is regarded as if it's facing downwards, so you can't land on it, and you will bounce down if you jump up into it.

Unlabled

  • Clear: (No color) Resets to the default collision behavior which is based on the triangles normal.
  • No climb: (Grey) Has default collision behavior except that the edges can't be grabbed.
    • You can paint the 'no-climb' label to all unlabled triangles by clicking the Apply 'no climb' to all unlabled surfaces button