Wolfire Games Wiki - User contributions [en]

Control Reference

2013-08-22T22:54:09Z

Endoperez: /* Change Object Properties */ -> added explanation of character spawn box colors

This '''control reference''' page is a comprehensive list of all actions available in the [[Portal:Overgrowth|Overgrowth]] alpha. The main goal of this page is to detail all main functions and discrete maneuvers that can be executed. Please review this page with each alpha release.

=Player Controls=

These functions are used when controlling a Player Character.

'Cmd' refers to the '⌘' key on Macs, and the 'Ctrl' key on PCs.

==Character Movement==

{| class="wikitable"
|-
! Action !! Control !! Behavior
|-
! Forward
| W || Moves player forward.
|-
! Backward
| S || Moves player backward.
|-
! Left
| A || Moves player left.
|-
! Right
| D || Moves player right.
|-
! Crouch
| Shift || Makes player crouch.
|-
! Roll
| Shift while Moving || Makes player roll along the ground, somersault while airborne, and regain control of its body when 'ragdolled.'
|-
! Jump
| Space || Makes player jump.
|-
! Wall Jump
| Space or Shift || Player jumps (space) or somersaults (shift) away from the wall.
|-
! Wall Run
| Hold space while running on a wall || Player runs up a wall when coming at it straight on; runs along a wall if coming at it from an angle.
|-
! Ledge Grab
| Hold right Mousebutton || Makes player grab horizontal ledges.
|-
! Pick Up a Weapon/Item
| Press Q || If close to a weapon or item, picks it up.
|-
! Drop a Weapon/Item
| Press Shift + Q || Drops weapon.
|-
! Sheath/Unsheath a Weapon/Item
| Press E || Sheaths the item or weapon (only one-handed weapons can be sheathed). Sheathing allows for better movement around the environment.
|-
! Switch hand holding Weapon
| Press B || Switches which hand the player holds the weapon with. Only weapons in the right hand are used to fight.
|}

==Attack and Defense==

Note: You need a live and hostile character less than around one meter away from you in order to be able to attack.
{| class="wikitable"
|-
! Action !! Control !! Behavior
|-
! Punch/Kick
| Left mouse button || Context sensitive. Depends on whether or not the character is in motion and their distance. Exact attack may change depending on the controlled character.
|-
! Throw a Weapon
| Press Q || If close to an enemy, the weapon will be thrown. The larger the weapon, the worse accuracy you will have. Knives work best.
|-
! Slash
| (While holding weapon) Left mouse button || Makes the player slash with a weapon in the hands.
|-
! Active Block
| Right mouse button || If you tap right mouse button as you're being attacked, you'll perform an active block that will leave your opponent open for a moment.
|-
! Active Dodge
| Movement Keys || If you move in a direction as you're being attacked, you'll perform an active dodge that will work against weapons while unarmed.
|-
! Judo Throw
| Hold right mouse button || If you press and hold right mouse button as you're being attacked, you'll perform a counter throw on your opponent, in a136 this was changed to only be possible after a successful block.
|-
! Choke Hold
| Hold right mouse button || Choke holds are only possible if an enemy has not yet detected your presence.
|-
! Throat Cut
| (While in choke hold) Press Left mouse button || Quickly cuts the throat of enemy in choke hold.
|-
! Leg Cannon
| (While airborne) Left mouse button || You'll kick with both legs towards the enemy's chest area, launching you towards the sky and your opponent to the ground.
|-
! Sweep
| (While crouching) Left mouse button || Makes the player sweep the feet of enemies.
|-
|}

==Alpha Keys==

{| class="wikitable"
|-
! Action !! Control !! Behavior
|-
! Restore characters
| X || Restores all characters to full health and wakes up any "unconscious" ones.
|-
! Reload Level
| L || Restart the current level from the beginning.
|-
! Change character
| 1 to 8 || Changes the playable character into one of seven possible characters. The first four are different rabbits, the fifth one is a wolf, the sixth is Rabbot 2.0, the seventh is a cat and the eighth is a raider rabbit.
|-
! Active ragdoll
| Z || Puts all characters into ragdoll mode. At the moment, in Alpha 114, the ragdolls are the world famous Active ragdolls, which try to protect themselves from nearby objects. In previous alphas, Z button put all characters into normal ragdoll mode.
|-
! Pain ragdoll
| N || Makes the player and A.I fall to the ground in agony until you let go of the button. Added in Alpha 113, may disappear or change in future versions.
|-
! Floppy ragdoll
| M || Makes the player and A.I fall to the ground like normal until you let go. This shortcut was added in Alpha 114 and was 'Z' previously. It may be changed back to '>' in a future alpha.
|-
! Animal voice Test
| V || Plays a test voice phrase with lip sync. This shortcut was added in Alpha 117 and may disappear or change in future versions.
|-
! Combat mode toggle
| C || The A.I added with the editor will now attack any hostiles assinged to them.
|-
! Neck Wound
| , || The player suffers from a neck wound with blood gushing from it. Added in alpha 128 and may disappear in future versions. (press X or L to get up again)
|-
! Slo-Motion
| Tab || Slows down the whole game.
|-
! Insta-kill
| F || Instantly kills the nearest enemy.
|}
<br>

=Editor Controls=

These functions are used when the [[Editor Interface]] is active.

'Cmd' refers to the '⌘' key on Macs, and the 'Ctrl' key on PCs.

See the [http://blog.wolfire.com/2009/03/map-editor-controls/ original blog post].

==Camera Movement==

{| class="wikitable"
|-
! Action !! Control !! Behavior
|-
! Forward
| 'w' || Moves camera forward.
|-
! Backward
| 's' || Moves camera backward.
|-
! Left
| 'a' || Moves camera left.
|-
! Right
| 'd' || Moves camera right.
|-
! Up
| shift + 'w' || Moves camera up.
|-
! Down
| shift + 's' || Moves camera down.
|}

==Tool/Mode Selection==

{| class="wikitable"
|-
! Action !! Control !! Behavior
|-
! Translate
| Click 'translate' button or press '4' || Sets tool to translate tool. When hovering over a selected object, cursor will indicate the currently chosen tool.
|-
! Scale
| Click 'scale' button or press '5' || Sets tool to scale tool.
|-
! Rotate
| Click 'rotate' button or press '6' || Sets tool to rotate tool.
|-
! Paintbrush
| Click 'paintbrush' button or press '3' || Sets tool to paintbrush tool.
|-
! Omni
| press '7' || Sets tool to omni tool. The omni tool combines the translation, scale, and rotate tools. See 'Transformation' section for details on how the omni tool decides which of its states to act in.
|-
! Game mode
| press '8' || Sends in Rabbot!
|-
! Editor mode
| press '9' || Back to editor mode.
|-
! In game webbrowser
| press 'F1' || Open the in game webbrowser.
|-
! Object browser
| press 'cmd-l' || To enter object browser menu
|-
! Decal Selection tool /decal editor mode
| press 'cmd-2' || To enter Decal selection/editor tool
|-
! Parameter Editor
| Press U || Allows you to modify character parameters. Added in a159.
|-
! Palette Editor
| Press 'cmd-shift-p' || Allows you to modify character colors. Added in a161.
|-
Pressing escape while in rigging mode, get's you
not only back to editor mode but also gives you a different topbar!
|}

==Object Creation==

{| class="wikitable"
|-
! Action !! Control !! Behavior
|-
! Load Object
| cmd-l (or click 'load' button) + left-mouse-click || Opens up a dialogue box in which the user may specify an xml file containing object data (anything in "./Data/Objects" or "./Data/Levels"). Places selected objects in scene, centered at mouse click.
|-
! Copy Objects
| cmd-c || Copies all selected objects (and their relative placement) into a copy buffer.
|-
! Paste Objects
| cmd-v || Adds to scene all objects in the copy buffer. Centers objects at mouse location.
|-
!Paintbrush
| Set tool to 'paintbrush' + hold 'p' + left-click-and-drag || Quickly adds semi-randomized objects to the scene, centered about mouse location. Let go of 'b' to move camera. Control paintbrush properties with sliders and checkboxes in the 'Misc' UI panel. [http://blog.wolfire.com/2009/02/editor-paintbrush/ More info here].
|}

==Object Selection==

{| class="wikitable"
|-
! Action !! Control !! Behavior
|-
! Select single object
| double-left-click on object || Selects clicked on object and deselects all other objects. If the object is part of a group, the whole group is selected. Bounding box and slight glow indicate object is selected.
|-
! Toggle-select objects
| shift + double-left-click on objects || Toggles whether or not clicked on object is selected. Preserves other existing selections.
|-
! Box select objects
| left-click + right-click + drag, or left-click + 'b' + drag || Selects all objects whose centers lie within box drawn on screen. Deselects all other objects.
|-
! Box toggle-select objects
| shift + left-click + right-click + drag, or shift + left-click + 'b' + drag || Toggles selection state for all objects whose centers lie within box drawn on screen. Preserves other existing selections.
|-
! Select decal that is under another decal
| mouse wheel up/down || This onley works when you have atleast 2 decalsand one is on top of another. You need to select atleast 1 decal first and your mouse cursor needs to be on top of that one you want to select to do it
|-
! Select all
| cmd-a || Selects all objects.
|-
! Deselect all
| double-left-click away from all objects || Deselects all objects.
|}

==Change Object Properties==
{| class="wikitable"
|-
! Action !! Object type !! Control !! Behavior
|-
! Make player-controlled
| Characters (character spawn boxes) || Shift+P || Toggles whether a character is controlled by a human or by AI. A human-controlled character's spawn box has white outlines, an AI-controlled character's box has white outlines.
|}

==Transformations==

For all transformations:

* In order to transform an object you must first select it.
* Hold ctrl to make movements snap by discrete increments.
* Hold alt to transform a clone of an object (or multiple objects), leaving the original object behind
* Left-click controls a 'generic' version of the transformation; right-click controls a version of the transformation contextually specific to the clicked on face. Holding shift locks the transformation to a single axis.
* Groups are transformed about the group center. Ungrouped objects, even if multiple are selected and transformed at once, are transformed about their own individual centers.

===Translation===

Set tool to 'translation', or set tool to 'omni tool' and hover mouse over central region of a bounding box face, or set tool to 'omni tool' and hold 't'.

{| class="wikitable"
|-
! Action !! Control !! Behavior
|-
! Camera relative
| left-click + drag || Translates clicked on object along plane parallel to the screen.
|-
! Locked to plane
| right-click + drag || Translates clicked on object along plane of clicked on face.
|-
! Locked to line
| shift + right-click + drag || Translates clicked on object along normal of clicked on face.
|-
! force decal(s) to map onley one object/group
| hold i || selected decal will onley map with that object that is directly underneath your mouse
|-
! force decal(s) to project onley those object(s) that you want them to
| press o || selected decal will onley map with that object that is directly underneath your mouse
|-
! projection pox/angel
| press p || to make projection box for decal
|}

===Scale===

Set tool to 'scale', or set tool to 'omni tool' and hover mouse near bounding box vertices, or set tool to 'omni tool' and hold 'e'.

{| class="wikitable"
|-
! Action !! Control !! Behavior
|-
! All dimensions
| left-click + drag || Scales clicked on object in all dimensions (x, y, and z) at once.
|-
! Locked to plane
| right-click + drag || Extends clicked on object along plane of clicked on face.
|-
! Locked to line
| shift + right-click + drag || Extrudes clicked on object along normal of clicked on face.
|}

===Mirror===

Just use the right-click scale tool, and scale down the object until it flips and its mirror image begins scaling up!

===Rotation===

Set tool to 'rotation', or set tool to 'omni tool' and hover mouse near bounding box edges, or set tool to 'omni tool' and hold 'r'.

{| class="wikitable"
|-
! Action !! Control !! Behavior
|-
! Free
| left-click + drag || Rotates clicked on object as if you are pushing the surface of a ball.
|-
! Locked to axis
| right-click + drag || Rotates clicked on object about normal of clicked on face.
|}

==Grouping==

{| class="wikitable"
|-
! Action !! Control !! Behavior
|-
! Group objects
| cmd-g || All selected objects and groups are joined into a new group. Groups are hierarchical, so grouped groups are treated as subgroups. Objects in a group are selected as a unit and transform as a unit.
|-
! Ungroup objects
| cmd-shift-g || All selected groups are disbanded at their outermost level.
|}

==Undo/Redo==

{| class="wikitable"
|-
! Action !! Control !! Behavior
|-
! Undo action
| cmd-z || Undoes the last completed action.
|-
! Redo action
| cmd-shift-z || Redoes the last undone action. Redo-able actions are cleared whenever the user completes a new action..
|}

==Object Removal==

{| class="wikitable"
|-
! Action !! Control !! Behavior
|-
! Delete object
| delete or backspace || Deletes all selected objects
|}

==Saving==

{| class="wikitable"
|-
! Action !! Control !! Behavior
|-
! Auto-save
| Automatic || Every 30 seconds or so the program automatically saves the entire level to the file "./Data/Levels/autosave.xml".
|-
! Save level
| cmd-s || Saves entire level to the same path as the level was opened from, overwriting the old level file.
|-
! Save selected objects
| cmd-shift-s || Saves-as all selected objects to a path specified by the user in a dialogue box.
|}

[[Category: Tutorials]]
[[Category: Modding]]
[[Category: Overgrowth]]

Control Reference

2013-08-22T22:52:02Z

Endoperez: removed rigging mode shortcut, added a group for "change object properties", added shortcut for player/AI control toggle

This '''control reference''' page is a comprehensive list of all actions available in the [[Portal:Overgrowth|Overgrowth]] alpha. The main goal of this page is to detail all main functions and discrete maneuvers that can be executed. Please review this page with each alpha release.

=Player Controls=

These functions are used when controlling a Player Character.

'Cmd' refers to the '⌘' key on Macs, and the 'Ctrl' key on PCs.

==Character Movement==

{| class="wikitable"
|-
! Action !! Control !! Behavior
|-
! Forward
| W || Moves player forward.
|-
! Backward
| S || Moves player backward.
|-
! Left
| A || Moves player left.
|-
! Right
| D || Moves player right.
|-
! Crouch
| Shift || Makes player crouch.
|-
! Roll
| Shift while Moving || Makes player roll along the ground, somersault while airborne, and regain control of its body when 'ragdolled.'
|-
! Jump
| Space || Makes player jump.
|-
! Wall Jump
| Space or Shift || Player jumps (space) or somersaults (shift) away from the wall.
|-
! Wall Run
| Hold space while running on a wall || Player runs up a wall when coming at it straight on; runs along a wall if coming at it from an angle.
|-
! Ledge Grab
| Hold right Mousebutton || Makes player grab horizontal ledges.
|-
! Pick Up a Weapon/Item
| Press Q || If close to a weapon or item, picks it up.
|-
! Drop a Weapon/Item
| Press Shift + Q || Drops weapon.
|-
! Sheath/Unsheath a Weapon/Item
| Press E || Sheaths the item or weapon (only one-handed weapons can be sheathed). Sheathing allows for better movement around the environment.
|-
! Switch hand holding Weapon
| Press B || Switches which hand the player holds the weapon with. Only weapons in the right hand are used to fight.
|}

==Attack and Defense==

Note: You need a live and hostile character less than around one meter away from you in order to be able to attack.
{| class="wikitable"
|-
! Action !! Control !! Behavior
|-
! Punch/Kick
| Left mouse button || Context sensitive. Depends on whether or not the character is in motion and their distance. Exact attack may change depending on the controlled character.
|-
! Throw a Weapon
| Press Q || If close to an enemy, the weapon will be thrown. The larger the weapon, the worse accuracy you will have. Knives work best.
|-
! Slash
| (While holding weapon) Left mouse button || Makes the player slash with a weapon in the hands.
|-
! Active Block
| Right mouse button || If you tap right mouse button as you're being attacked, you'll perform an active block that will leave your opponent open for a moment.
|-
! Active Dodge
| Movement Keys || If you move in a direction as you're being attacked, you'll perform an active dodge that will work against weapons while unarmed.
|-
! Judo Throw
| Hold right mouse button || If you press and hold right mouse button as you're being attacked, you'll perform a counter throw on your opponent, in a136 this was changed to only be possible after a successful block.
|-
! Choke Hold
| Hold right mouse button || Choke holds are only possible if an enemy has not yet detected your presence.
|-
! Throat Cut
| (While in choke hold) Press Left mouse button || Quickly cuts the throat of enemy in choke hold.
|-
! Leg Cannon
| (While airborne) Left mouse button || You'll kick with both legs towards the enemy's chest area, launching you towards the sky and your opponent to the ground.
|-
! Sweep
| (While crouching) Left mouse button || Makes the player sweep the feet of enemies.
|-
|}

==Alpha Keys==

{| class="wikitable"
|-
! Action !! Control !! Behavior
|-
! Restore characters
| X || Restores all characters to full health and wakes up any "unconscious" ones.
|-
! Reload Level
| L || Restart the current level from the beginning.
|-
! Change character
| 1 to 8 || Changes the playable character into one of seven possible characters. The first four are different rabbits, the fifth one is a wolf, the sixth is Rabbot 2.0, the seventh is a cat and the eighth is a raider rabbit.
|-
! Active ragdoll
| Z || Puts all characters into ragdoll mode. At the moment, in Alpha 114, the ragdolls are the world famous Active ragdolls, which try to protect themselves from nearby objects. In previous alphas, Z button put all characters into normal ragdoll mode.
|-
! Pain ragdoll
| N || Makes the player and A.I fall to the ground in agony until you let go of the button. Added in Alpha 113, may disappear or change in future versions.
|-
! Floppy ragdoll
| M || Makes the player and A.I fall to the ground like normal until you let go. This shortcut was added in Alpha 114 and was 'Z' previously. It may be changed back to '>' in a future alpha.
|-
! Animal voice Test
| V || Plays a test voice phrase with lip sync. This shortcut was added in Alpha 117 and may disappear or change in future versions.
|-
! Combat mode toggle
| C || The A.I added with the editor will now attack any hostiles assinged to them.
|-
! Neck Wound
| , || The player suffers from a neck wound with blood gushing from it. Added in alpha 128 and may disappear in future versions. (press X or L to get up again)
|-
! Slo-Motion
| Tab || Slows down the whole game.
|-
! Insta-kill
| F || Instantly kills the nearest enemy.
|}
<br>

=Editor Controls=

These functions are used when the [[Editor Interface]] is active.

'Cmd' refers to the '⌘' key on Macs, and the 'Ctrl' key on PCs.

See the [http://blog.wolfire.com/2009/03/map-editor-controls/ original blog post].

==Camera Movement==

{| class="wikitable"
|-
! Action !! Control !! Behavior
|-
! Forward
| 'w' || Moves camera forward.
|-
! Backward
| 's' || Moves camera backward.
|-
! Left
| 'a' || Moves camera left.
|-
! Right
| 'd' || Moves camera right.
|-
! Up
| shift + 'w' || Moves camera up.
|-
! Down
| shift + 's' || Moves camera down.
|}

==Tool/Mode Selection==

{| class="wikitable"
|-
! Action !! Control !! Behavior
|-
! Translate
| Click 'translate' button or press '4' || Sets tool to translate tool. When hovering over a selected object, cursor will indicate the currently chosen tool.
|-
! Scale
| Click 'scale' button or press '5' || Sets tool to scale tool.
|-
! Rotate
| Click 'rotate' button or press '6' || Sets tool to rotate tool.
|-
! Paintbrush
| Click 'paintbrush' button or press '3' || Sets tool to paintbrush tool.
|-
! Omni
| press '7' || Sets tool to omni tool. The omni tool combines the translation, scale, and rotate tools. See 'Transformation' section for details on how the omni tool decides which of its states to act in.
|-
! Game mode
| press '8' || Sends in Rabbot!
|-
! Editor mode
| press '9' || Back to editor mode.
|-
! In game webbrowser
| press 'F1' || Open the in game webbrowser.
|-
! Object browser
| press 'cmd-l' || To enter object browser menu
|-
! Decal Selection tool /decal editor mode
| press 'cmd-2' || To enter Decal selection/editor tool
|-
! Parameter Editor
| Press U || Allows you to modify character parameters. Added in a159.
|-
! Palette Editor
| Press 'cmd-shift-p' || Allows you to modify character colors. Added in a161.
|-
Pressing escape while in rigging mode, get's you
not only back to editor mode but also gives you a different topbar!
|}

==Object Creation==

{| class="wikitable"
|-
! Action !! Control !! Behavior
|-
! Load Object
| cmd-l (or click 'load' button) + left-mouse-click || Opens up a dialogue box in which the user may specify an xml file containing object data (anything in "./Data/Objects" or "./Data/Levels"). Places selected objects in scene, centered at mouse click.
|-
! Copy Objects
| cmd-c || Copies all selected objects (and their relative placement) into a copy buffer.
|-
! Paste Objects
| cmd-v || Adds to scene all objects in the copy buffer. Centers objects at mouse location.
|-
!Paintbrush
| Set tool to 'paintbrush' + hold 'p' + left-click-and-drag || Quickly adds semi-randomized objects to the scene, centered about mouse location. Let go of 'b' to move camera. Control paintbrush properties with sliders and checkboxes in the 'Misc' UI panel. [http://blog.wolfire.com/2009/02/editor-paintbrush/ More info here].
|}

==Object Selection==

{| class="wikitable"
|-
! Action !! Control !! Behavior
|-
! Select single object
| double-left-click on object || Selects clicked on object and deselects all other objects. If the object is part of a group, the whole group is selected. Bounding box and slight glow indicate object is selected.
|-
! Toggle-select objects
| shift + double-left-click on objects || Toggles whether or not clicked on object is selected. Preserves other existing selections.
|-
! Box select objects
| left-click + right-click + drag, or left-click + 'b' + drag || Selects all objects whose centers lie within box drawn on screen. Deselects all other objects.
|-
! Box toggle-select objects
| shift + left-click + right-click + drag, or shift + left-click + 'b' + drag || Toggles selection state for all objects whose centers lie within box drawn on screen. Preserves other existing selections.
|-
! Select decal that is under another decal
| mouse wheel up/down || This onley works when you have atleast 2 decalsand one is on top of another. You need to select atleast 1 decal first and your mouse cursor needs to be on top of that one you want to select to do it
|-
! Select all
| cmd-a || Selects all objects.
|-
! Deselect all
| double-left-click away from all objects || Deselects all objects.
|}

==Change Object Properties==
{| class="wikitable"
|-
! Action !! Object type !! Control !! Behavior
|-
! Make player-controlled
| Characters (character spawn boxes) || Shift+P || Toggles whether a character is controlled by a human or by AI
|}

==Transformations==

For all transformations:

* In order to transform an object you must first select it.
* Hold ctrl to make movements snap by discrete increments.
* Hold alt to transform a clone of an object (or multiple objects), leaving the original object behind
* Left-click controls a 'generic' version of the transformation; right-click controls a version of the transformation contextually specific to the clicked on face. Holding shift locks the transformation to a single axis.
* Groups are transformed about the group center. Ungrouped objects, even if multiple are selected and transformed at once, are transformed about their own individual centers.

===Translation===

Set tool to 'translation', or set tool to 'omni tool' and hover mouse over central region of a bounding box face, or set tool to 'omni tool' and hold 't'.

{| class="wikitable"
|-
! Action !! Control !! Behavior
|-
! Camera relative
| left-click + drag || Translates clicked on object along plane parallel to the screen.
|-
! Locked to plane
| right-click + drag || Translates clicked on object along plane of clicked on face.
|-
! Locked to line
| shift + right-click + drag || Translates clicked on object along normal of clicked on face.
|-
! force decal(s) to map onley one object/group
| hold i || selected decal will onley map with that object that is directly underneath your mouse
|-
! force decal(s) to project onley those object(s) that you want them to
| press o || selected decal will onley map with that object that is directly underneath your mouse
|-
! projection pox/angel
| press p || to make projection box for decal
|}

===Scale===

Set tool to 'scale', or set tool to 'omni tool' and hover mouse near bounding box vertices, or set tool to 'omni tool' and hold 'e'.

{| class="wikitable"
|-
! Action !! Control !! Behavior
|-
! All dimensions
| left-click + drag || Scales clicked on object in all dimensions (x, y, and z) at once.
|-
! Locked to plane
| right-click + drag || Extends clicked on object along plane of clicked on face.
|-
! Locked to line
| shift + right-click + drag || Extrudes clicked on object along normal of clicked on face.
|}

===Mirror===

Just use the right-click scale tool, and scale down the object until it flips and its mirror image begins scaling up!

===Rotation===

Set tool to 'rotation', or set tool to 'omni tool' and hover mouse near bounding box edges, or set tool to 'omni tool' and hold 'r'.

{| class="wikitable"
|-
! Action !! Control !! Behavior
|-
! Free
| left-click + drag || Rotates clicked on object as if you are pushing the surface of a ball.
|-
! Locked to axis
| right-click + drag || Rotates clicked on object about normal of clicked on face.
|}

==Grouping==

{| class="wikitable"
|-
! Action !! Control !! Behavior
|-
! Group objects
| cmd-g || All selected objects and groups are joined into a new group. Groups are hierarchical, so grouped groups are treated as subgroups. Objects in a group are selected as a unit and transform as a unit.
|-
! Ungroup objects
| cmd-shift-g || All selected groups are disbanded at their outermost level.
|}

==Undo/Redo==

{| class="wikitable"
|-
! Action !! Control !! Behavior
|-
! Undo action
| cmd-z || Undoes the last completed action.
|-
! Redo action
| cmd-shift-z || Redoes the last undone action. Redo-able actions are cleared whenever the user completes a new action..
|}

==Object Removal==

{| class="wikitable"
|-
! Action !! Control !! Behavior
|-
! Delete object
| delete or backspace || Deletes all selected objects
|}

==Saving==

{| class="wikitable"
|-
! Action !! Control !! Behavior
|-
! Auto-save
| Automatic || Every 30 seconds or so the program automatically saves the entire level to the file "./Data/Levels/autosave.xml".
|-
! Save level
| cmd-s || Saves entire level to the same path as the level was opened from, overwriting the old level file.
|-
! Save selected objects
| cmd-shift-s || Saves-as all selected objects to a path specified by the user in a dialogue box.
|}

[[Category: Tutorials]]
[[Category: Modding]]
[[Category: Overgrowth]]

Particle Effects

2011-06-21T05:54:45Z

Endoperez:

= Particle Effects =
There isn't much information released about Overgrowth's particle system. Running or jumping on the ground creates small dust clouds at the characters' feet, and particle streams were added in [http://blog.wolfire.com/2011/04/Overgrowth-a128-video-changelog A128] along with blood dripping. Particles are controlled through scripts, examples below:

== Simple Particle Example ==

MakeParticle("Data/Particles/impactfast.xml",pos,vec3(0.0f));

== Particle Stream Example ==
float blood_force = sin(time*_spurt_frequency)*0.5f+0.5f;
uint32 id = MakeParticle("Data/Particles/blooddrop.xml",bleed_pos,(head_transform*vec3(0.0f,blood_amount*blood_force,0.0f)+this_mo.velocity));
if(last_blood_particle_id != 0){
ConnectParticles(last_blood_particle_id, id);
}
last_blood_particle_id = id;

= Post Processing Effects =
''Post processing effects are image filters that are applied as a final step before each rendered frame is drawn to the screen -- much like Photoshop filters.'' This explanation is lifted word-for-word from David's blog post on the subject. He doesn't go into much detail about it in his blog posts, but here's links to [http://blog.wolfire.com/2009/04/post-processing-part-one/ part one] and [http://blog.wolfire.com/2009/04/post-processing-part-two/ part two] any way.

= Shaders =
Overgrowth uses GLSL shader language, and the users can create custom shaders. Some blog posts explain how some of the shaders work, such as the posts about [http://blog.wolfire.com/2008/12/object-lighting-part-1/ Object Lightning], [http://blog.wolfire.com/2009/09/character-rim-lighting/ Character Rim Lighting] and [http://blog.wolfire.com/2009/09/trees-in-the-breeze/ Trees in the Breeze]. Overgrowth's character animation is also done through a shader, as David mentioned in [http://blog.wolfire.com/2009/10/character-normal-maps/#comment-18448230 a blog comment].

The skeletal animation is done in the vertex shader anyway, so it's actually
faster and smoother-looking to just apply the bone matrices to the object-space
normal map than it is to recalculate transformed normals and tangents for
each vertex.

= Motion Blur for Weapons =
Overgrowth's weapons use motion blur based on stippling. Stippling is also used to render soft shadows, and the technique of stippling is explained in [http://blog.wolfire.com/2009/10/transparent-shadows-using-stippling/ this old blog post]. The motion blur for weapons works by drawing the weapon several times along it spath using different stipple patterns for each instance, as mentioned in the [http://blog.wolfire.com/2011/06/Overgrowth-a135-video-changelog A135 video].

= Relevant blog posts =

[http://blog.wolfire.com/2010/12/Overgrowth-graphics-overview A summary] of most blog posts explaining Overgrowth's graphical features, focusing on more technical details. There are additional links below, some of which are not mentioned in the summary.

http://blog.wolfire.com/2008/12/object-lighting-part-1/
http://blog.wolfire.com/2010/02/Gamma-correct-lighting

http://blog.wolfire.com/2009/09/character-rim-lighting/
http://blog.wolfire.com/2009/10/character-normal-maps/
http://blog.wolfire.com/2009/09/soft-normal-maps-for-fur/

http://blog.wolfire.com/2009/09/trees-in-the-breeze/
http://blog.wolfire.com/2010/10/Imposters

http://blog.wolfire.com/2009/05/decals-editor-part-one/
http://blog.wolfire.com/2009/05/decals-editor-part-two/
http://blog.wolfire.com/2009/06/decals-editor-part-three/

[[Category: Overgrowth]]

Introduction To Overgrowth Modding

2011-06-21T05:54:13Z

Endoperez:

Here is the current modding situation, based on [http://forums.wolfire.com/memberlist.php?mode=viewprofile&u=13814| this post] by Endoperez.

Here's a short and dirty list of what's possible at the moment.

Scripting - Possible, limits are still quite vague.

Custom GUI - Possible, not documented. Done through CSS.

[[Custom Terrain| Terrains and levels]] - there's not much documentation for how it works and how to do it, but with some trial and error it should be possible to convert a grayscale heightmap into a custom Overgrowth level.

[[Importing Models & Textures| Mesh Objects]] - houses, walls, towers, trees, fruit, any static object is possible. The normal maps should preferably be in Object space format, but Tangent space works too, it just needs a different shader. The files should be exported in OBJ format, check scale by opening one of the OBJ files that come with Overgrowth. Custom weapons work as well as the official weapons, (pretty poorly at the moment, but they're easy to update as more weapon features appear). If you are new to modeling, check [[Making New Models & Textures]].

[[Effects System| Special effects, animated objects]] - there's a shader for plants moving in the wind. There's no shader for water of any kind. Creating custom particle textures is easy, but since particle movement and spawning has to be done through code anything more complex than a dust cloud created on point of impact takes some experimentation. Shaders themselves come with the game in GLSL text format, so someone familiar with writing shaders shouldn't have problems coming up with new shaders.

[[Rigging and Animation| Animated characters, custom animations for existing characters]] - If you use Blender 2.56, the animation exporting scripts should work. You get the scripts and the .blend files with the alphas. Theoretically, it should be possible to create and animate a custom character, but the scripts are written to only use the default animations at the default paths I think, so it wouldn't really be worth the effort ATM.

[[Category: Modding]]
[[Category: Overgrowth]]

Portal:Overgrowth

2011-06-21T05:53:40Z

Endoperez:

Portal:Overgrowth

2011-06-21T05:43:54Z

Endoperez: Moved the "Introduction to Overgrowth Modding" to a new page, added "outdated" next to the rigging/anim link

Introduction To Overgrowth Modding

2011-06-21T05:42:52Z

Endoperez: New page: Here is the current modding situation, based on [http://forums.wolfire.com/memberlist.php?mode=viewprofile&u=13814| this post] by Endoperez. Here's a short and dirty list of what's possib...

Rigging and Animation

2011-06-21T05:30:26Z

Endoperez:

{{stub}}

NOTE: THE BUILT-IN RIGGING AND ANIMATION TOOLS DEMONSTRATED IN THE VIDEO ARE CURRENTLY DISABLED. They might be enabled eventually, but since the developers [http://blog.wolfire.com/2010/07/Blender-as-an-animation-editor aren't using them] any more they are very low in the to-do list.

http://www.moddb.com/games/overgrowth/news/initial-rigging-and-animation-tech-demo-hd-video

[[Category: Tutorials]]
[[Category: Modding]]
[[Category: Overgrowth]]

Portal:Overgrowth

2011-06-21T05:27:51Z

Endoperez: added a link to a new page: Effects System

<noinclude>[[Category:Portals|{{PAGENAME}}]] [[Category:Overgrowth|{{PAGENAME}}]] </noinclude>
{{Overgrowth Portal Header}}
{{Not Whaleman Friendly | This page had been neglected for too long}}

-----

[http://www.wolfire.com/overgrowth Overgrowth] takes place in the savage world of Lugaru where rabbits, wolves and other animals are forced to use paws, claws and medieval weaponry to engage each other in battle. Combining 3rd person adventure platforming with intricate melee combat, Overgrowth achieves a unique feel.

Overgrowth also benefits from [http://www.wolfire.com/ Wolfire]'s brand new Phoenix Engine which has been built from the ground up to allow the use of cutting edge graphics, animation, and physics. Add to these exciting features Overgrowth’s realistic artificial intelligence and streamlined control system and the result is an astoundingly immersive experience.

=The Game=
*[[If_you_just_pre-ordered_overgrowth,_read_this_first | If you've just pre-ordered Overgrowth, read this first]]
*[[Character Control]]
*[[Effects System]]
*[[Phoenix Engine]]

== Overgrowth Universe ==
* [[Races]]
* [[Locations]]
* [[Characters]]
* [[Equipment and Weapons]]

=Alpha Testing=
[[Overgrowth tests]]

{{stub}}
==Introduction to Mods==
Here is the current modding situation:

by [http://forums.wolfire.com/memberlist.php?mode=viewprofile&u=13814| Endoperez] » Fri Jun 17, 2011

Here's the non-script, non-UI stuff for now.

Terrains and levels - the lack of documentation hurts, but it should be possible to convert a grayscale heightmap into a custom Overgrowth level.

Mesh objects - houses, walls, towers, trees, fruit, any static object is possible. The normal maps should preferably be in Object space format, but Tangent space works too, it just needs a different shader. The files should be exported in OBJ format, check scale by opening one of the OBJ files that come with Overgrowth. Custom weapons work as well as the official weapons, (pretty poorly at the moment, but they're easy to update as more weapon features appear).

Special effects, animated objects - there's a shader for plants moving in the wind. There's no shader for water of any kind. Particle systems might be possible but the examples are so few that anything beyond a dust cloud on impact takes some experimentation. Shaders all come with the game in readable format, so any shader wizards shouldn't have major problems coming up with new shaders if they want to.

Animated characters, custom animations for existing characters - If you use Blender 2.56, the animation exporting scripts should work. You get the scripts and the .blend files with the alphas. Theoretically, it should be possible to create and animate a custom character, but the scripts are written to only use the default animations at the default paths I think, so it wouldn't really be worth the effort ATM.

* [[Wolfire Games Wiki:Community Portal]]

== Getting Started ==
* [[Overgrowth Alpha FAQ| Overgrowth FAQ]]
* [[Alpha List]]
* [[How to download the game]]
* [[How to modify the game's configuration]]

== Getting your hands dirty ==
* [[Basic Controls]]
* [[Overgrowth Map Editing]]
* [[Custom Terrain]]
* [[Making New Models & Textures]]
* [[Importing Models & Textures]]
* [[Custom Decals]]
* [[Scripting]]
* [[Mod List]]
* [[Control Reference]]
* [[Character Control]]

== Videos ==
* [[Animation and Scripting]]
* [[Rigging and Animation]]
* [[Decals]]

== Tutorials ==
* [[How to make your own models for Overgrowth]]
* [[How to update to the latest alpha version on Windows]]

== Misc ==
* [[Useful Links]]

Particle Effects

2011-06-21T05:26:13Z

Endoperez: New page: = Particle Effects = There isn't much information released about Overgrowth's particle system. Running or jumping on the ground creates small dust clouds at the characters' feet, and parti...

Player Controls

2011-01-21T16:13:23Z

Endoperez:

'Cmd' refers to the '⌘' key on Macs, and the 'Ctrl' key on PCs.
Add here when new alpha specific things are added: thank you!

= Character Movement=

{| border="1" cellpadding="2"
|-
! !! Control !! Behavior
|-
! Forward
| 'w' || Moves player forward.
|-
! Backward
| 's' || Moves player backward.
|-
! Left
| 'a' || Moves player left.
|-
! Right
| 'd' || Moves player right.
|-
! Crouch
| shift || Makes player crouch, roll while moving.
|-
! Jump
| Space || Makes player jump.
|}

= Basic Attacks =

{| border="1" cellpadding="2"
|-
! !! Control !! Behavior
|-
! Punch/Kick
| Left Mousebutton || Punch and kick depending on if you stand still or move in a certain direction. Exact attack may change depending on the controlled character.
|-
! Pick Up a Weapon
| Right Mousebutton || If you're close to a weapon object, picks it up. Letting go of the button drops the weapon. If it's let go during jump, it gets thrown out.
|-
! Active Block
| Right Mousebutton || If you press right mouse button as you're being attacked, you'll perform an active block that will stun your opponent for a moment. Active Block is '''disabled''' at the moment (Alpha 114).
|-
! Judo Throw
| Right Mousebutton || If you press right mouse button as you're being attacked, you'll perform a counter throw on your opponent.
|-
! Leg Cannon
| 'LeftMouse' while in the air and near enemy || You'll kick with both legs towards the enemy's chest area, launching you towards the sky and your opponent to the ground.
|-
! Sweep
| 'LeftMouse' while crouched || Makes the player sweep the feet of enemies.
|-

How many legcannons can you do before touching the ground again? Challenge yourself!
|}

=Alpha Keys=

{| border="1" cellpadding="2"
|-
! !! Control !! Behavior
|-
! Respawn characters
| 'X' || Restores all characters to full health and wakes up any "unconscious" ones.
|-
! Change to a different character
| '1' to '5' || Changes the playable character into one of five possible characters. The first four are different rabbits, the fifth one is a wolf.
|-
! Normal/Active Ragdoll
| 'Z' || Puts all characters into ragdoll mode. At the moment, in Alpha 114, the ragdolls are the world famous Active ragdolls, which try to protect themselves from nearby objects. In previous alphas, Z button put all characters into normal ragdoll mode.
|-
! Pain-Animation
| 'N' || Makes the player and A.I fall to the ground in agony until you let go of the button. Added in Alpha 113, may disappear or change in future versions.
|-
! Normal Ragdolls
| 'M' || Makes the player and A.I fall to the ground like normal until you let go. This shortcut was added in Alpha 114 and was 'Z' previously. It may be changed back to '>' in a future alpha.
|-
! Activate Agressive A.I
| 'C' || The A.I added with the editor will now attack any hostiles assinged to them.
|}

=Special Attacks=

{| border="1" cellpadding="2"
|-
! !! Control !! Behavior
|-
! Select single object
| double-left-click on object || Selects clicked on object and deselects all other objects. If the object is part of a group, the whole group is selected. Bounding box and slight glow indicate object is selected.
|-
! Toggle-select objects
| shift + double-left-click on objects || Toggles whether or not clicked on object is selected. Preserves other existing selections.
|-
! Box select objects
| left-click + right-click + drag, or left-click + 'b' + drag || Selects all objects whose centers lie within box drawn on screen. Deselects all other objects.
|-
! Box toggle-select objects
| shift + left-click + right-click + drag, or shift + left-click + 'b' + drag || Toggles selection state for all objects whose centers lie within box drawn on screen. Preserves other existing selections.
|-
! Select all
| cmd-a || Selects all objects.
|-
! Deselect all
| double-left-click away from all objects || Deselects all objects.
|}

[[Category:Overgrowth]]
[[Category:Controls]]
[[Category:Help]]

Player Controls

2011-01-21T16:11:03Z

Endoperez:

'Cmd' refers to the '⌘' key on Macs, and the 'Ctrl' key on PCs.
Add here when new alpha specific things are added: thank you!

= Character Movement=

{| border="1" cellpadding="2"
|-
! !! Control !! Behavior
|-
! Forward
| 'w' || Moves player forward.
|-
! Backward
| 's' || Moves player backward.
|-
! Left
| 'a' || Moves player left.
|-
! Right
| 'd' || Moves player right.
|-
! Crouch
| shift || Makes player crouch, roll while moving.
|-
! Jump
| Space || Makes player jump.
|}

= Basic Attacks =

{| border="1" cellpadding="2"
|-
! !! Control !! Behavior
|-
! Punch/Kick
| Left Mousebutton || Punch and kick depending on if you stand still or move in a certain direction. Exact attack may change depending on the controlled character.
|-
! Pick Up a Weapon
| Right Mousebutton || If you're close to a weapon object, picks it up. Letting go of the button drops the weapon. If it's let go during jump, it gets thrown out.
|-
! Active Block
| Right Mousebutton || If you press right mouse button as you're being attacked, you'll perform an active block that will stun your opponent for a moment. Active Block is '''disabled''' at the moment (Alpha 114).
|-
! Judo Throw
| Right Mousebutton || If you press right mouse button as you're being attacked, you'll perform a counter throw on your opponent.
|-
! Leg Cannon
| 'LeftMouse' while in the air and near enemy || You'll kick with both legs towards the enemy's chest area, launching you towards the sky and your opponent to the ground.
|-
! Sweep
| 'LeftMouse' while crouched || Makes the player sweep the feet of enemies.
|-

How many legcannons can you do before touching the ground again? Challenge yourself!
|}

=Alpha Keys=

{| border="1" cellpadding="2"
|-
! !! Control !! Behavior
|-
! Respawn characters
| 'X' || Restores all characters to full health and wakes up any "unconscious" ones.
|-
! Normal/Active Ragdoll
| 'Z' || Puts all characters into ragdoll mode. At the moment, in Alpha 114, the ragdolls are the world famous Active ragdolls, which try to protect themselves from nearby objects. In previous alphas, Z button put all characters into normal ragdoll mode.
|-
! Pain-Animation
| 'N' || Makes the player and A.I fall to the ground in agony until you let go of the button. Added in Alpha 113, may disappear or change in future versions.
|-
! Normal Ragdolls
| 'M' || Makes the player and A.I fall to the ground like normal until you let go. This shortcut was added in Alpha 114 and was 'Z' previously. It may be changed back to '>' in a future alpha.
|-
! Activate Agressive A.I
| 'C' || The A.I added with the editor will now attack any hostiles assinged to them.
|}

=Special Attacks=

{| border="1" cellpadding="2"
|-
! !! Control !! Behavior
|-
! Select single object
| double-left-click on object || Selects clicked on object and deselects all other objects. If the object is part of a group, the whole group is selected. Bounding box and slight glow indicate object is selected.
|-
! Toggle-select objects
| shift + double-left-click on objects || Toggles whether or not clicked on object is selected. Preserves other existing selections.
|-
! Box select objects
| left-click + right-click + drag, or left-click + 'b' + drag || Selects all objects whose centers lie within box drawn on screen. Deselects all other objects.
|-
! Box toggle-select objects
| shift + left-click + right-click + drag, or shift + left-click + 'b' + drag || Toggles selection state for all objects whose centers lie within box drawn on screen. Preserves other existing selections.
|-
! Select all
| cmd-a || Selects all objects.
|-
! Deselect all
| double-left-click away from all objects || Deselects all objects.
|}

[[Category:Overgrowth]]
[[Category:Controls]]
[[Category:Help]]

Player Controls

2011-01-21T16:09:11Z

Endoperez:

'Cmd' refers to the '⌘' key on Macs, and the 'Ctrl' key on PCs.
Add here when new alpha specific things are added: thank you!

= Character Movement=

{| border="1" cellpadding="2"
|-
! !! Control !! Behavior
|-
! Forward
| 'w' || Moves player forward.
|-
! Backward
| 's' || Moves player backward.
|-
! Left
| 'a' || Moves player left.
|-
! Right
| 'd' || Moves player right.
|-
! Crouch
| shift || Makes player crouch, roll while moving.
|-
! Jump
| Space || Makes player jump.
|}

= Basic Attacks =

{| border="1" cellpadding="2"
|-
! !! Control !! Behavior
|-
! Punch/Kick
| Left Mousebutton || Punch and kick depending on if you stand still or move in a certain direction. Exact attack may change depending on the controlled character.
|-
! Pick Up a Weapon
| Right Mousebutton || If you're close to a weapon object, picks it up. Letting go of the button drops the weapon. If it's let go during jump, it gets thrown out.
|-
! Active Block
| Right Mousebutton || If you press right mouse button as you're being attacked, you'll perform an active block that will stun your opponent for a moment. Active Block is '''disabled''' at the moment (Alpha 114).
|-
! Judo Throw
| Right Mousebutton || If you press right mouse button as you're being attacked, you'll perform a counter throw on your opponent.
|-
! Leg Cannon
| 'LeftMouse' while in the air and near enemy || You'll kick with both legs towards the enemy's chest area, launching you towards the sky and your opponent to the ground.
|-
! Sweep
| 'LeftMouse' while crouched || Makes the player sweep the feet of enemies.
|-

How many legcannons can you do before touching the ground again? Challenge yourself!
|}

=Alpha Keys=

{| border="1" cellpadding="2"
|-
! !! Control !! Behavior
|-
! Normal/Active Ragdoll
| 'Z' || Puts all characters into ragdoll mode. At the moment, in Alpha 114, the ragdolls are the world famous Active ragdolls, which try to protect themselves from nearby objects. In previous alphas, Z button put all characters into normal ragdoll mode.
|-
! Pain-Animation
| 'N' || Makes the player and A.I fall to the ground in agony until you let go of the button. Added in Alpha 113, may disappear or change in future versions.
|-
! Normal Ragdolls
| 'M' || Makes the player and A.I fall to the ground like normal until you let go. This shortcut was added in Alpha 114 and was 'Z' previously. It may be changed back to '>' in a future alpha.
|-
! Activate Agressive A.I
| 'C' || The A.I added with the editor will now attack any hostiles assinged to them.
|}

=Special Attacks=

{| border="1" cellpadding="2"
|-
! !! Control !! Behavior
|-
! Select single object
| double-left-click on object || Selects clicked on object and deselects all other objects. If the object is part of a group, the whole group is selected. Bounding box and slight glow indicate object is selected.
|-
! Toggle-select objects
| shift + double-left-click on objects || Toggles whether or not clicked on object is selected. Preserves other existing selections.
|-
! Box select objects
| left-click + right-click + drag, or left-click + 'b' + drag || Selects all objects whose centers lie within box drawn on screen. Deselects all other objects.
|-
! Box toggle-select objects
| shift + left-click + right-click + drag, or shift + left-click + 'b' + drag || Toggles selection state for all objects whose centers lie within box drawn on screen. Preserves other existing selections.
|-
! Select all
| cmd-a || Selects all objects.
|-
! Deselect all
| double-left-click away from all objects || Deselects all objects.
|}

[[Category:Overgrowth]]
[[Category:Controls]]
[[Category:Help]]

Player Controls

2011-01-21T16:08:03Z

Endoperez:

'Cmd' refers to the '⌘' key on Macs, and the 'Ctrl' key on PCs.
Add here when new alpha specific things are added: thank you!

= Character Movement=

{| border="1" cellpadding="2"
|-
! !! Control !! Behavior
|-
! Forward
| 'w' || Moves player forward.
|-
! Backward
| 's' || Moves player backward.
|-
! Left
| 'a' || Moves player left.
|-
! Right
| 'd' || Moves player right.
|-
! Crouch
| shift || Makes player crouch, roll while moving.
|-
! Jump
| Space || Makes player jump.
|}

= Basic Attacks =

{| border="1" cellpadding="2"
|-
! !! Control !! Behavior
|-
! Punch/Kick
| Left Mousebutton || Punch and kick depending on if you stand still or move in a certain direction. Exact attack may change depending on the controlled character.
|-
! Pick Up a Weapon
| Right Mousebutton || If you're close to a weapon object, picks it up. Letting go of the button drops the weapon. If it's let go during jump, it gets thrown out.
|-
! Active Block
| Right Mousebutton || If you press right mouse button as you're being attacked, you'll perform an active block that will stun your opponent for a moment. Active Block is '''disabled''' at the moment (Alpha 114).
|-
! Judo Throw
| Right Mousebutton || If you press right mouse button as you're being attacked, you'll perform a counter throw on your opponent. Judo Throw is '''disabled''' at the moment (Alpha 114).
|-
! Leg Cannon
| 'LeftMouse' while in the air and near enemy || You'll kick with both legs towards the enemy's chest area, launching you towards the sky and your opponent to the ground.
|-
! Sweep
| 'LeftMouse' while crouched || Makes the player sweep the feet of enemies.
|-

How many legcannons can you do before touching the ground again? Challenge yourself!
|}

=Alpha Keys=

{| border="1" cellpadding="2"
|-
! !! Control !! Behavior
|-
! Normal/Active Ragdoll
| 'Z' || Puts all characters into ragdoll mode. At the moment, in Alpha 114, the ragdolls are the world famous Active ragdolls, which try to protect themselves from nearby objects. In previous alphas, Z button put all characters into normal ragdoll mode.
|-
! Pain-Animation
| 'N' || Makes the player and A.I fall to the ground in agony until you let go of the button. Added in Alpha 113, may disappear or change in future versions.
|-
! Normal Ragdolls
| 'M' || Makes the player and A.I fall to the ground like normal until you let go. This shortcut was added in Alpha 114 and was 'Z' previously. It may be changed back to '>' in a future alpha.
|-
! Activate Agressive A.I
| 'C' || The A.I added with the editor will now attack any hostiles assinged to them.
|}

=Special Attacks=

{| border="1" cellpadding="2"
|-
! !! Control !! Behavior
|-
! Select single object
| double-left-click on object || Selects clicked on object and deselects all other objects. If the object is part of a group, the whole group is selected. Bounding box and slight glow indicate object is selected.
|-
! Toggle-select objects
| shift + double-left-click on objects || Toggles whether or not clicked on object is selected. Preserves other existing selections.
|-
! Box select objects
| left-click + right-click + drag, or left-click + 'b' + drag || Selects all objects whose centers lie within box drawn on screen. Deselects all other objects.
|-
! Box toggle-select objects
| shift + left-click + right-click + drag, or shift + left-click + 'b' + drag || Toggles selection state for all objects whose centers lie within box drawn on screen. Preserves other existing selections.
|-
! Select all
| cmd-a || Selects all objects.
|-
! Deselect all
| double-left-click away from all objects || Deselects all objects.
|}

[[Category:Overgrowth]]
[[Category:Controls]]
[[Category:Help]]

Player Controls

2011-01-21T16:03:44Z

Endoperez:

'Cmd' refers to the '⌘' key on Macs, and the 'Ctrl' key on PCs.
Add here when new alpha specific things are added: thank you!

= Character Movement=

{| border="1" cellpadding="2"
|-
! !! Control !! Behavior
|-
! Forward
| 'w' || Moves player forward.
|-
! Backward
| 's' || Moves player backward.
|-
! Left
| 'a' || Moves player left.
|-
! Right
| 'd' || Moves player right.
|-
! Crouch
| shift || Makes player crouch, roll while moving.
|-
! Jump
| Space || Makes player jump.
|}

= Basic Attacks =

{| border="1" cellpadding="2"
|-
! !! Control !! Behavior
|-
! Punch/Kick
| Left Mousebutton || Punch and kick depending on if you stand still or move in a certain direction. Exact attack may change depending on the controlled character.
|-
! Pick Up a Weapon
| Right Mousebutton || If you're close to a weapon object, picks it up. Letting go of the button drops the weapon. If it's let go during jump, it gets thrown out.
|-
! Active Block
| Right Mousebutton || If you press right mouse button as you're being attacked, you'll perform an active block that will stun your opponent for a moment. Active Block is '''disabled''' at the moment (Alpha 113).
|-
! Judo Throw
| Right Mousebutton || If you press right mouse button as you're being attacked, you'll perform a counter throw on your opponent. Judo Throw is '''disabled''' at the moment (Alpha 113).
|-
! Leg Cannon
| 'LeftMouse' while in the air and near enemy || You'll kick with both legs towards the enemy's chest area, launching you towards the sky and your opponent to the ground.
|-
! Sweep
| 'LeftMouse' while crouched || Makes the player sweep the feet of enemies.
|-

How many legcannons can you do before touching the ground again? Challenge yourself!
|}

=Alpha Keys=

{| border="1" cellpadding="2"
|-
! !! Control !! Behavior
|-
! Normal/Active Ragdoll
| 'Z' || Puts all characters into ragdoll mode. At the moment, in Alpha 113, the ragdolls are the world famous Active ragdolls, which try to protect themselves from nearby objects. In previous alphas, Z button put all characters into normal ragdoll mode.
|-
! Pain-Animation
| 'N' || Makes the player and A.I fall to the ground in agony until you let go of the button. Added in Alpha 113, may disappear or change in future versions.
|-
! Normal Ragdolls
| 'M' || Makes the player and A.I fall to the ground like normal until you let go. This shortcut was added in Alpha 113 and was 'Z' previously. It may be changed back to '>' in a future alpha.
|-
! Activate Agressive A.I
| 'C' || The A.I added with the editor will now attack any hostiles assinged to them.
|}

=Special Attacks=

{| border="1" cellpadding="2"
|-
! !! Control !! Behavior
|-
! Select single object
| double-left-click on object || Selects clicked on object and deselects all other objects. If the object is part of a group, the whole group is selected. Bounding box and slight glow indicate object is selected.
|-
! Toggle-select objects
| shift + double-left-click on objects || Toggles whether or not clicked on object is selected. Preserves other existing selections.
|-
! Box select objects
| left-click + right-click + drag, or left-click + 'b' + drag || Selects all objects whose centers lie within box drawn on screen. Deselects all other objects.
|-
! Box toggle-select objects
| shift + left-click + right-click + drag, or shift + left-click + 'b' + drag || Toggles selection state for all objects whose centers lie within box drawn on screen. Preserves other existing selections.
|-
! Select all
| cmd-a || Selects all objects.
|-
! Deselect all
| double-left-click away from all objects || Deselects all objects.
|}

[[Category:Overgrowth]]
[[Category:Controls]]
[[Category:Help]]

Player Controls

2011-01-21T16:03:04Z

Endoperez:

'Cmd' refers to the '⌘' key on Macs, and the 'Ctrl' key on PCs.
Add here when new alpha specific things are added: thank you!

= Character Movement=

{| border="1" cellpadding="2"
|-
! !! Control !! Behavior
|-
! Forward
| 'w' || Moves player forward.
|-
! Backward
| 's' || Moves player backward.
|-
! Left
| 'a' || Moves player left.
|-
! Right
| 'd' || Moves player right.
|-
! Crouch
| shift || Makes player crouch, roll while moving.
|-
! Jump
| Space || Makes player jump.
|}

= Basic Attacks =

{| border="1" cellpadding="2"
|-
! !! Control !! Behavior
|-
! Punch/Kick
| Left Mousebutton || Punch and kick depending on if you stand still or move in a certain direction. Exact attack may change depending on the controlled character.
|-
! Pick Up a Weapon
| Right Mousebutton || If you're close to a weapon object, picks it up. Letting go of the button drops the weapon. If it's let go during jump, it gets thrown out.
|-
! Active Block
| Right Mousebutton || If you press right mouse button as you're being attacked, you'll perform an active block that will stun your opponent for a moment. Active Block is '''disabled''' at the moment (Alpha 113).
|-
! Judo Throw
| Right Mousebutton || If you press right mouse button as you're being attacked, you'll perform a counter throw on your opponent. Judo Throw is '''disabled''' at the moment (Alpha 113).
|-
! Leg Cannon
| 'LeftMouse' while in the air and near enemy || You'll kick with both legs towards the enemy's chest area, launching you towards the sky and your opponent to the ground.
|-
! Sweep
| 'LeftMouse' while crouched || Makes the player sweep the feet of enemies.
|-

How many legcannons can you do before touching the ground again? Challenge yourself!
|}

=Alpha Keys=

{| border="1" cellpadding="2"
|-
! !! Control !! Behavior
|-
! Normal/Active Ragdoll
| 'Z' || Puts all characters into ragdoll mode. At the moment, in Alpha 113, the ragdolls are the world famous Active ragdolls, which try to protect themselves from nearby objects. In previous alphas, Z button put all characters into normal ragdoll mode.
|-
! Pain-Animation
| 'N' || Makes the player and A.I fall to the ground in agony until you let go of the button. Added in Alpha 113, may disappear or change in future versions.
|-
! Normal Ragdolls
| 'M' || Makes the player and A.I fall to the ground like normal until you let go. This shortcut was added in Alpha 113 and was 'Z' previously. It may be changed back to '>' in a future alpha.
|-
! 'C'
| Activate Agressive A.I || The A.I added with the editor will now attack any hostiles assinged to them.
|}

=Special Attacks=

{| border="1" cellpadding="2"
|-
! !! Control !! Behavior
|-
! Select single object
| double-left-click on object || Selects clicked on object and deselects all other objects. If the object is part of a group, the whole group is selected. Bounding box and slight glow indicate object is selected.
|-
! Toggle-select objects
| shift + double-left-click on objects || Toggles whether or not clicked on object is selected. Preserves other existing selections.
|-
! Box select objects
| left-click + right-click + drag, or left-click + 'b' + drag || Selects all objects whose centers lie within box drawn on screen. Deselects all other objects.
|-
! Box toggle-select objects
| shift + left-click + right-click + drag, or shift + left-click + 'b' + drag || Toggles selection state for all objects whose centers lie within box drawn on screen. Preserves other existing selections.
|-
! Select all
| cmd-a || Selects all objects.
|-
! Deselect all
| double-left-click away from all objects || Deselects all objects.
|}

[[Category:Overgrowth]]
[[Category:Controls]]
[[Category:Help]]

Player Controls

2011-01-21T16:01:52Z

Endoperez:

'Cmd' refers to the '⌘' key on Macs, and the 'Ctrl' key on PCs.
Add here when new alpha specific things are added: thank you!

= Character Movement=

{| border="1" cellpadding="2"
|-
! !! Control !! Behavior
|-
! Forward
| 'w' || Moves player forward.
|-
! Backward
| 's' || Moves player backward.
|-
! Left
| 'a' || Moves player left.
|-
! Right
| 'd' || Moves player right.
|-
! Crouch
| shift || Makes player crouch, roll while moving.
|-
! Jump
| Space || Makes player jump.
|}

= Basic Attacks =

{| border="1" cellpadding="2"
|-
! !! Control !! Behavior
|-
! Punch/Kick
| Left Mousebutton || Punch and kick depending on if you stand still or move in a certain direction. Exact attack may change depending on the controlled character.
|-
! Pick Up a Weapon
| Right Mousebutton || If you're close to a weapon object, picks it up. Letting go of the button drops the weapon. If it's let go during jump, it gets thrown out.
|-
! Active Block
| Right Mousebutton || If you press right mouse button as you're being attacked, you'll perform an active block that will stun your opponent for a moment. Active Block is '''disabled''' at the moment (Alpha 113).
|-
! Judo Throw
| Right Mousebutton || If you press right mouse button as you're being attacked, you'll perform a counter throw on your opponent. Judo Throw is '''disabled''' at the moment (Alpha 113).
|-
! Leg Cannon
| 'LeftMouse' while in the air and near enemy || You'll kick with both legs towards the enemy's chest area, launching you towards the sky and your opponent to the ground.
|-
! Sweep
| 'LeftMouse' while crouched || Makes the player sweep the feet of enemies.
|-

How many legcannons can you do before touching the ground again? Challenge yourself!
|}

=Alpha Keys=

{| border="1" cellpadding="2"
|-
! !! Control !! Behavior
|-
! Enable Ragdoll
| 'Z' || Puts all characters into ragdoll mode. At the moment, in Alpha 113, the ragdolls are the world famous Active ragdolls, which try to protect themselves from nearby objects.
|-
! Pain-Animation
| 'N' || Makes the player and A.I fall to the ground in agony until you let go of the button. Added in Alpha 113, may disappear or change in future versions.
|-
! Normal Ragdolls
| 'M' || Makes the player and A.I fall to the ground like normal until you let go. This shortcut was added in Alpha 113 and was 'Z' previously. It may be changed back to '>' in a future alpha.
|-
! 'C'
| Activate Agressive A.I || The A.I added with the editor will now attack any hostiles assinged to them.
|}

=Special Attacks=

{| border="1" cellpadding="2"
|-
! !! Control !! Behavior
|-
! Select single object
| double-left-click on object || Selects clicked on object and deselects all other objects. If the object is part of a group, the whole group is selected. Bounding box and slight glow indicate object is selected.
|-
! Toggle-select objects
| shift + double-left-click on objects || Toggles whether or not clicked on object is selected. Preserves other existing selections.
|-
! Box select objects
| left-click + right-click + drag, or left-click + 'b' + drag || Selects all objects whose centers lie within box drawn on screen. Deselects all other objects.
|-
! Box toggle-select objects
| shift + left-click + right-click + drag, or shift + left-click + 'b' + drag || Toggles selection state for all objects whose centers lie within box drawn on screen. Preserves other existing selections.
|-
! Select all
| cmd-a || Selects all objects.
|-
! Deselect all
| double-left-click away from all objects || Deselects all objects.
|}

[[Category:Overgrowth]]
[[Category:Controls]]
[[Category:Help]]

Editor Interface

2010-02-05T18:16:18Z

Endoperez:

{{WQA in Progress}}

=Basic Controls=
When you start up your Overgrowth Alpha, you'll probably be faced with dozens of questions. "What should I do?," "How do I work the tools?," and "How far can I edit Overgrowth?" are few of the many questions that will be answered in this section. However, it could be profitable for you to also try to experiment on your own. The more you learn on your own, the more likely you'll be comfortable with the interface. Firstly, it is important that you get familiar with the tools and information you have at your command in game.

==The Interface==
[[Image:select.png‎‎|right|thumb|caption|Interface and Selecting]]

Firstly, we'll make sense of the information and windows accessible from in game. To begin with, you have the most noticeable window; the palette. This palette is very important because it contains all of the tools you'll use to edit and manipulate objects, decals, and hotspots. We'll explain more of the palette soon. Secondly, in the bottom left of your screen you'll see a number after the letters "FPS". Obviously, this means "Frames per Second". Overgrowth is incredibly de-optimized at this current stage, so most likely once you start getting some objects in there your FPS will go down considerably. Do not worry, some day this shall be changed, even then it's hard to get to a point where the FPS reaches low numbers.

Then we have the 'Misc Menu' on the bottom right of your screen. It should be hidden to begin with, but if you drag it upwards you should reveal that it is rather intricate. Firstly, you have the 'Live Shadow Update' on/off switch. This simply means that if you have shadows calculated, this will enable the shadows to update if an object moves. 'Calculate Shadows' and "Calculate AO' are the next switches on the Misc Menu. Calculate shadows (obviously) calculates the shadows for the map and all objects in it. Calculate AO turns the Ambient Occlusion on, which really just makes the map look prettier. '''Warning:''' Calculating either of these generally freezes Overgrowth up for sometimes over 15 minutes.

Next is the 'FOV' Scroller. This is comparable to changing the lens of a camera. Scroller left, the closer things appear, scroller right, the farther the things appear. The standard is 90.30. Also dealing with the camera is the 'Camera Collision Detection' switch. This switch turns off and on the ability for the camera to have contact with objects. This is generally on by default, but I'd advise to turn it off for complicated maps where you may need to get somewhere faster. Everything from 'Translation Jitter' to 'Collide with Objects' deals with changing the settings of the 'Brush' tool. These options shall be explained rather shortly.

Now that all of the apparent menus and information have been explained, we'll go over one last feature; the Console. Currently, the console seems to be nonfunctional, however, when it does come into use it will be rather important. The console uses [http://en.wikipedia.org/wiki/Javascript Javascript], a high powered code which allows for a lot of functions and such.

==The Palette==
[[Image:pallete.png‎‎|right|thumb|caption|Palette Tools]]

We've just gone over most of the general interface, now we shall go more in depth with the palette. Firstly, it's apparent that there are six tools, generally doing different things. To select any of these tools, simply click them once with the LMB. I've found it easy to accidentally not fully press a tool, so be aware. Here is a table of how to select each button.

{| border="1"
|+ align="Top" |''Browser''
|Load Button
|Click ‘Load’ button or CMD 'L'
|Pressing the 'Load' button will automatically open up a new browser in which you can load any object, decal, or hotspot into the game.
|}
{| border="1"
|+ align="Top" |''Tools''
|Translate Tool
|Click ‘translate’ button or press ‘4′
|Sets tool to translate tool. When hovering over a selected object, cursor will indicate the currently chosen tool.
|-
|Scale Tool
|Click ‘Scale’ button or press ‘5′
|Sets tool to Scale Tool.
|-
|Rotate Tool
|Click ‘Rotate’ button or press ‘6′
| Sets tool to Rotate Tool.
|-
|Omni Tool
|Click ‘Omni’ button or press ‘7′
| Sets tool to Omni Tool. This tool combines the Translate, Scale, and Rotate tool in one.
|-
|Brush Tool
|Click ‘Brush’ button, or press '3'
| Sets tool to Brush Tool. Hold P + LMB and drag.
|}

Now that you know what each tool is called it's almost time to move on to how they are specifically used. However, first it'd be best to go over the Browser first.

===The Browser===

The new browser combines the Object, Decal, and Hotspot browser into one functional one. For the most part, the object browser has almost every object listed in it as a image thumbnail, however if you've created your own object or want to load an object that isn't in the thumbnail form, you can simply press the 'Load External Object' button and search through the object folder with all the .xml's all over the place. You can also switch the tab to decal or hotspot browser, which also has all the assets in the thumbnail list. Also, by pressing the Heart located at the top right of every thumbnail, you can add to favorites and look at them in a separate section. Finally, one last feature is the search feature. Simply type the name of the .xml you're looking for and it'll pop up for you.

Okay, we're ready for some nice down and dirty work with the tools...

==Using the Tools==
[[Image:translate.png‎‎|right|thumb|caption|Translate Tool]]

So we've gone over the interface and how to access the tools, but now it's time to show you what each tool really does. As you can see below there is the actual palette. Familiarize yourself with it to make this process easier. Okay, now we'll start with the Translation tool first...

[[Image:palettebar.png|150px]]

===Translation Tool===

This tool, like all manipulation tools, can affect Objects, Decals and Hotspots in generally the same way. For simplicity's sake, we'll explain these tools in regards to objects only. When an object is selected, this tool allows you to move it's position. So really, 'translation' is really just a fancy word for the 'move tool'. When hold down LMB on an object, you can freely move it without being tied down by a grid or plane. However, all tools can be used differently. If you use RMB on one of the sides of the object, the object will move bound to that plane. This is useful when making walls, buildings, or even Crete structures because you can put an object on the surface of another object, and then edit the position without worrying about depth. If you use RMB + Shift on a side, the object will move bound to that side's perpendicular line. You can use this along with hold Option and Shift, which will duplicate the object, while being snapped to grid and moving on one line. Good for making towers, roads, and other such structures. Another way to use the Translate tool is to use your arrows. In summary, the Translation tool will be one of your most used tools, so get comfortable with it as much as possible.

===Scale Tool===
[[Image:scale.png‎‎|right|thumb|caption|Scale Tool]]

The Scale tool is probably most similar to the Translation tool out of all the tools at your command. However, in the process of making your project, remember to use Rabbot as a standard of size. What do I mean by this? Well, it can be hard to judge size without any reference point, so use Rabbot to make sure your stuff isn't too large or too small. Also remember that not all object scale graciously. Certain object loose much of their quality when significantly enlarged. Moving on, if you use LMB on the object, this tool will scale the object in size from the center. It's basically a 'Make bigger' or 'make smaller' tool with LMB. Now, when you use RMB on one side, this will scale the object bound to that side you used RMB on. Also, like the translation tool, you can use RMB + Shift on one side to scale bound to that side's perpendicular line. Using the 'Control' button with the scaling will snap the scaling to it's grid, however it seems as if it doesn't exactly coincide with the Translation's grid. Pretty much you'd have to see it for yourself to understand completely.

Also, another feature with the scaling tool is the ability to mirror your object. It's rather simple actually, simply use RMB + Shift + Control on one side, and then drag the mouse over past the opposite side. This, if done properly, will result in your object being completely mirrored beside it.

===Rotate Tool===
[[Image:rotate.png‎‎|right|thumb|caption|Rotate Tool]]

Now we have the last of the Manipulation tools, the Rotation Tool. This tool is actually slightly less complicated than the other's because it's function is easier to grasp. This tool actually had some trouble in the earlier stages of development because the snap to grid function (Control) didn't exactly work so well. Luckily for us now, the Rotate tool works pretty much perfectly. You can use LMB to free rotate the object, kind of like how LMB affect objects with the Translation tool. Free rotating an object is good for when you need to make ruins, or something more natural. After all, Overgrowth is all about the natural environment of the map. However, if you ever did want to get a more defined result with rotation tool, simply use RMB on one of the sides of the object to rotate on that side's perpendicular axis. Using Control with the Rotate tool is very important. For instance, when making a house and you have a wall, you need to make a right angle. Using RMB + Control on the top side of the wall, you can rotate it into a right angle.

===Omni Tool===

This tool combines the Translate, Scale, and Rotate tool into one tool. This is useful because it saves time that you'd normally spend changing tools. When using this tool there are two ways in which it determines what tool to use. Firstly, it determines this by where your curser is in relation to the object. For Translation, hover over the center of a side. For Scale, hover near the verticies of the object. For rotate, hover near the edge of the object. This takes some getting used to along with a good amount of precision. However, another way to determine which tool to use goes as: Translation, hold T. Scale, hold E, Rotation, hold R. Now, don't be surprised when you press R and a Ragdoll spawns. It turns out that this hotkey is used for two functions.

===Brush Tool===

This tool is different from the other tools listed because it's not a Manipulation tool, it's more like an 'Add Object' tool. The brush tool allows you add objects to a map quickly and seamlessly. All you have to do is load an object via the Object Browser, but before adding it to the map, switch to the brush tool and hold P + LMB and drag over the map. You should end up with the object you loaded being spread on the map near where your curser is moving. As mentioned before, the Misc Menu can also change how the Brush tool works. Editing all the 'jitter' sliders will change how the brush works, and you can even set it so you can brush over objects as well.

== Saving Combined Object As A Separate File ==

Once you have created someone you wish to use elsewhere, press Ctrl+Shift+S (On Windows) or Command+Shift+S (on Mac) to open an object saving dialog. This way, you can save buildings, trees or obstacle courses made from many parts as a single XML object, ready to be imported back to Overgrowth.

==Summary==

So, in total we went over the general interface of Overgrowth, and went in depth on the functions of the Palette. In truth, once you get a hang of using the tools it gets easier from there. Even when editing Decals or Hotspots, it's all just a process of getting used to the way the editor works. Also, feel free to use any of the tutorial images on the right side as quick reference guides incase you forget anything. Also, the two links below are '''incredibly useful''', I'd highly recommend them.

Thanks to Phillip and the whole Wolfire team for any information I used from them.

[http://blog.wolfire.com/2009/03/map-editor-controls/ Philip's Map Editor Controls] - [http://forums.wolfire.com/viewtopic.php?f=13&t=4148 SPF Forum]

[[Category:Tutorials]]
[[Category:Overgrowth]]
[[Category:Editing]]

Importing Models & Textures

2010-02-05T18:08:14Z

Endoperez: New page: This page explains how you can tell Phoenix engine to use custom 3D models and textures. To learn how to create these from scratch, please see the Making New Models & Textures page. ...

This page explains how you can tell Phoenix engine to use custom 3D models and textures. To learn how to create these from scratch, please see the [[Making New Models & Textures]] page.

== Objects, Models and Textures ==
Overgrowth's Phoenix engine differentiates between the 3D model and the in-game object. Object is an XML file with links to the model, combined diffuse/specular and normal images, and the shader. The object file is saved as a plain text xml file, and can be created in most text editors. As of Alpha 64, you can't leave out any of tag pairs without causing a crash. Missing or incorrect links will be replaced with a default FailWhale model or texture. Below is an XML template you can use to create custom objects. Many more can be found under Data/Objects folder.

<?xml version="1.0" ?>
<Object>
<Model>
Data/Custom/Username/custom_model.obj
</Model>
<ColorMap>
Data/Custom/Username/custom_diffuse.png
</ColorMap>
<NormalMap>
Data/Custom/Username/custom_normals.png
</NormalMap>
<ShaderName>
cubemap
</ShaderName>
</Object>

== File Formats ==

XML object files are text files with the filetype '.xml'.
Phoenix engine can read 3D models in the Wavefront OBJ format. Most 3D modeling applications let you export your models out in the OBJ format. The object doesn't have to be specifically triangelized, and Overgrowth doesn't use the MTL (material) files that may be created during the exporting process.

Phoenix engine will also automatically create .dds images from TGA and PNG images with or without transparency. In an effort to reduce the amount of textures used, Phoenix engine reads the alpha channel of the color map as the specular map. As mentioned in the latter half of the How to make a seamless tiling texture blog post [[http://blog.wolfire.com/2009/06/how-to-make-a-seamless-tiling-texture/]], you can paste the greyscale information of the specular map into the color map's alpha channel.

By default, Overgrowth uses Object-space normal mapping [[http://blog.wolfire.com/2009/10/character-normal-maps/]], but you can also use Tangent-space normal maps. The way the normal map is used depends on the shader name defined in the XML file. Shader 'cubemap' uses tangent-space and 'cubemapobj' object-space normals.

== Folder Structure ==

There are no folder structure restrictions on Overgrowth objects, models or textures; they don't even have to be under the main Overgrowth folder. It is, however, recommended that any custom objects go under the Data/Custom/ directory, into a subfolder named after the creator. This makes it easy to keep custom content separate from the official content. If the XML object files contain a precise folder structure as shown in the example, for the objects to work the same folder structure must be used in all Overgrowth installations.

If you use a Mac and don't know how to access the folders, right click the Alpha, click 'Show Package Contents', Contents->Data. For easy access you can then drag it into your Sidebar.

Portal:Overgrowth

2010-02-05T16:57:31Z

Endoperez:

<noinclude>[[Category:Portals|{{PAGENAME}}]] [[Category:Overgrowth|{{PAGENAME}}]] </noinclude>
{{Overgrowth Portal Header}}

-----

[http://www.wolfire.com/overgrowth Overgrowth] takes place in the savage world of Lugaru where rabbits, wolves and other animals are forced to use paws, claws and medieval weaponry to engage each other in battle. Combining 3rd person adventure platforming with intricate melee combat, Overgrowth achieves a unique feel.

Overgrowth also benefits from [http://www.wolfire.com/ Wolfire]'s brand new Phoenix Engine which has been built from the ground up to allow the use of cutting edge graphics, animation, and physics. Add to these exciting features Overgrowth’s realistic artificial intelligence and streamlined control system and the result is an astoundingly immersive experience.

== Instructions ==
* [[Basic Controls]]
* [[Overgrowth FAQ]]

== Videos ==
* [[Rigging and Animation]]
* [[Decals]]

== Modding Overgrowth ==
* [[Overgrowth Map Editing]]
* [[Custom Terrain]]
* [[Making New Models & Textures]]
* [[Importing Models & Textures]]
* [[Custom Decals]]

== Tutorials ==
* [[How to make your own models for Overgrowth]]

== Misc ==
* [[Useful Links]]

Custom Models & Textures

2010-02-05T16:55:58Z

Endoperez: Custom Models & Textures moved to Making New Models & Textures: I'll make a new article for "Importing Models & Textures", and the name change helps differentiate the titles.

#REDIRECT [[Making New Models & Textures]]

Making New Models & Textures

2010-02-05T16:55:58Z

Endoperez: Custom Models & Textures moved to Making New Models & Textures: I'll make a new article for "Importing Models & Textures", and the name change helps differentiate the titles.

'''This tutorial does not contain all the links and pictures it should yet.'''

This tutorial is based on jo-shadow's tutorial [http://forums.wolfire.com/viewtopic.php?f=13&t=4712 ''How to make your own models for OG''].

This tutorial will teach you everything you need to know to make your own objects and how to get them into the game.

Please keep in mind that this method is by no means the only way of making and adding Objects. It is merely one of very many ways, but doing it this way should be easy to learn and understand for anyone. Some experience with 3D programs would help, but even the most inexperienced beginner should be able to get results with this guide.

== What you will learn ==

This tutorial will cover how to do the following:

* Creating a 3D model.
* UV mapping the model.
* Generating a texture from the UV data.
* Editing the texture.
* Changing the reflectivity of the texture.
* Making a normal map for the texture.
* Setting up the folder.
* Making the XML file.
* Testing the object in the engine.

== What you will need ==

You will need the following for this tutorial:
* A 3D modeling program with simple UV mapping capabilities.
** This tutorial will use [http://en.wikipedia.org/wiki/Wings3d Wings3D], an open source, cross platform polygonal modeler. It is much simpler when it comes to features than [http://en.wikipedia.org/wiki/Blender_(software) Blender] or other major 3D packages, but it should be much easier to learn for beginners.
** If you prefer blender or another program the basic concepts are the same, but this tutorial only covers Wings3D.
* An image editor.
** This tutorial will use [http://en.wikipedia.org/wiki/Photoshop Photoshop], however any image editor will work just fine. As a free, cross-platform alternative I would suggest using [http://en.wikipedia.org/wiki/GIMP GIMP].
* A text editor.
** Any will do. Mac users can use [http://en.wikipedia.org/wiki/Textedit Textedit] and Windows users [http://en.wikipedia.org/wiki/Notepad_(Windows) Notepad].
* The latest [http://blog.wolfire.com/category/alpha/ Overgrowth alpha].
** This tutorial was originally written for and tested on [http://forums.wolfire.com/viewtopic.php?f=13&t=4701 alpha 16].

Please make sure that you have these necessary programs before you start.

== Getting started ==

It is advised, but not necessary, that you first take a look at the [http://internap.dl.sourceforge.net/sourceforge/wings/wings3d_manual1.6.1.pdf Wings3D manual] to help you become comfortable with its interface. It contains some very quick and easy tutorials that will teach you everything you need to know for this tutorial and then some.

Here are some quick Wings3D basics:
* Go into ''Edit -> Preferences''
** Check ''Force Axis-Aligned Ortho''. This will make editing along an axis easier.
** Single-button Mac users should in the ''Camera'' tab select the one button control mode.
* Change between ''Vertex'', ''Edge'', ''Face'' and ''Object'' mode by pressing the buttons on the top bar or the keystrokes: '''V''', '''E''', '''F''' and '''B''' respectively
* Select stuff by clicking on it.
* Deselect with space.
* Focus the view on what you have selected by pressing '''A'''.
* Reset the view with '''R'''.
* Right clicking (control + click will from now on by implied for Macs as right click) brings up a context-dependent drop-down menu. Its contents changes depending on what you have selected. This is where most of the features we will use are located.
* For most of the keyboard shortcuts look under ''Help -> Defined Hotkeys''.

So without further ado, let's begin.

== Creating a 3D model ==

Because it has been so widely requested in the [SPF], and for the sake of simplicity, in this tutorial we will make a simple textured 3D cylinder. However, taking it a step further to more advanced models should not be a problem.

[[Image:Model_4.png|200px|thumb|right|Our finished cylinder.]]
# Open Wings 3D
# Right click anywhere and choose ''Cylinder'' from the drop-down menu ([[Media:Model_1.png|picture]]). This will spawn a default 16-sided cylinder, to spawn a customized cylinder press the little box on the same line instead. We will now change the proportions of the cylinder to our liking.
# Go into object mode ('''B''') and select the cylinder ([[Media:Model_2.png|picture]]).
# Right click anywhere to open the drop-down menu and select ''Scale -> Radial Y'' ([[Media:Model_3.png|picture]]).
# Now drag the mouse side to side to change the width of the cylinder. Click once it is scaled to your liking to accept, or press tab to manually input a value.
# For the purpose of this tutorial our cylinder model is now finished.

Now we need to generate a UV map for the object so we can texture it.

=== UV Mapping the model ===

When you want to apply a texture to a 3D model, you might run into some problems. The best way we know how to deal with textures is as a 2D image, but how do we take a 3D model, and make a 2D image out of it? Well let's imagine that we have an orange painted like a globe like this:

[[Image:Globe_1.png]]

And we want to make its surface flat kinda like this:

[[Image:Globe_2.png]]

The solution is we peel away the surface, cutting it in a certain way so that it lies flat:

[[Image:Globe_3.png]]

Please note that there are many ways of doing this, but some work better than others. For example one of the more accurate ways of doing this with the earth is what's known as ''Fuller's Projection'':

[[Image:Globe_4.png]]

([http://earthvoyage.googlepages.com/UNFOLD.MOV Click for animation])

This is what we have to do with our cylinder: We have to cut it up so that we can lay it flat on a 2D plane.

Each vertex of the model, which already has a 3D coordinate of (X,Y,Z) will now also have a 2D coordinate on this special plane, so that we know how to fit the texture onto our object. This 2D coordinate is defined as (U,V), which is why this is called [http://en.wikipedia.org/wiki/Uv_mapping UV mapping]. This is a simplified way of describing UV mapping, but for this tutorial it will do.

''Note: there are other methods for applying textures to models, but this guide only covers UV mapping.''

# Select the entire object, and at the bottom of the drop-down menu choose ''UV Mapping -> Direct''. A new window with the object will pop up with a title of ''AutoUV Segmenting''.
PICTURE

and the name of your object:
PICTURE

Now we have to Divide the object into different shapes so that it can unfold it properly, just like in the globe example.
This can be done Automatically or Manually. For the sake of practice let's do it by hand:
You can separate different pieces either by marking which edges to cut, by coloring the faces that should go together, or both.

# In face mode (F) select the top Face and press 'i' (select similar) so both the top and bottom are selected.
Choose one of the nine colors Labeled AuvChart1-9 from the drop-down menu. Doing so will mark these faces as being separate from the rest of the model.

# Clear your selection with space, and select one of the vertical side pieces.
Select the rest by selecting similar (i), then mark these with a different color.

# Because the cylindrical part of the model is still in a loop we need to mark a cut.
In Edge mode (E) select of the vertical edges and choose 'mark edges for cut' from the drop down menu.

# The marking of your model is now complete, and it is ready to be unfolded.
Choose Continue->Unfolding from the drop down menu

# A window showing the unfolded model will open up. This is the UV map.
To show what part of the UV map belongs to what part of the model, there is a colorful grid and letter pattern that you can also see on your model. When you Select a face you see it on both the model and the UV map.

You can also scale and move parts of the model around on the UV map, and the changes will be apparent on the model. Making a face take up more of the UV map will make give it a denser more detailed texture. This is often used to make important features of a model more detailed, like the hands and dace of a character.

If for whatever reason you don't like how the unfolding ended up you can select your object, and in the drop down menu Choose UV Mapping-> Force Segment (delete previous) to start from a clean slate.

It's important to note that there can be many different ways of cutting an object and the resulting UV maps can look very different.

There are two automated methods, Projection and Feature Detection:
UV_5.png (12.56 KiB) Viewed 597 times

Depending on your model one might be better than the other, sometimes they both suck and you have to do it manually, and sometimes if your model is simple like this one they will both give you the same result.

If you cut the object in weird ways it will end up unfolding weirdly, like this for example:
PICTURE

Once again, the best way to understand how this works is to experiment and try out the various features.

Although there are many different ways of mapping any Model, as a rule you want its faces to use the UV space as efficiently as possible, because any texture that isn't under the mapped Faces will not be seen anywhere when the texture is applied.

There are entire programs devoted simply to finding the best way to generate the UV map for any given model, and the tools wings3D provides are much more basic. However they are sufficient for a simple object like this.
With practice you can even manage more complex ones.

Now that We've Finished UV mapping let's generate the texture for the model. Rest assured, the hardest part is done.

Generating a texture from the UV Data

We have our lovely UV map, and now we need to generate a texture we can then edit.

# With the UV map Window still open, choose 'Create Texture' from the drop-down menu. A small window will pop up:

Choose a size depending on how big the object will end up being, and how detailed you want it to be. The larger the image, the more detailed the texture will look on the model.
It wouldn't make sense to have a super-high detailed texture for a fork, and you wouldn't want a low quality texture for a skyscraper either. For this object 512x512 will work just fine.

# Because we want to edit this texture manually later we need to know where on the texture the edges of the object are, so we know where on the object we are drawing.
Set the first as 'Background' and the second as 'Draw Edges' so the edges appear on the texture. Press OK.

# It might seem like the UV map disappeared, but don't fear, the texture was created and is now applied to the object. You simply cannot see it well because it is white with black lines that are right under the wire-frame. You can tell when you zoom in really closely:

# Export the model by going into File -> Export -> Wavefront (.obj)

Then make a new folder in a location of your choosing and save it as whatever title you like.
It will save a .obj and a .mtl file. Delete the .mtl file. It has to do with materials that we don't need.

# Sometimes the texture is saved along with the object, but sometimes it isn't. If there is no texture file in the folder you exported to, go into Window->Outliner, and locate the texture:
PICTURE

Right click it, Choose export and save it in the same folder as the obj, name it whatever you want, preferably the name of your object plus _Color.
For example:

Texture_5.png (13.25 KiB) Viewed 582 times

You are now done with Wings3D!

== Editing the texture ==

Now it's time to get creative!

# Load the Texture file into whichever image editing program of your choice

# Create your actual texture now however you wish. It helps to keep your 'Template' in a separate layer than the texture you want to be on your object.

Here is one way of doing it in photoshop, that allows you to keep the Template's lines above your texture for reference:

* Double click the layer name and accept the pop up prompt to unlock it.
* Rename the layer "template".
* Create two layers bellow it, the lower one called background, the upper one called texture.
* Fill The background layer with white and lock it.
Image_2.png (19.76 KiB) Viewed 579 times

* Select the Template layer, which is above all the other layers, and set its layer mode to multiply.
Image_3.png (37.59 KiB) Viewed 580 times

This will make the white in it transparent, and the black remain as an overlay. you can use it as a guide. lock it as well.
* Draw in the texture layer to your heart's content.

I just used some stock photography I found online. The area with the red text is wasted space that could have been better managed when I made the UV map. It will not appear on the final Model, but will take up space in memory none-the-less.

Here is my finished texture:
Image_5.png (326.33 KiB) Viewed 578 times

Once done, make sure to save the image -without- the Template, unless you want it as part of the final Texture. Don't worry too much about what format you save it as. Thanks to the built in image converter almost any file type will work in the engine. I personally would advise you to use .tga or .png.

=== Changing the Reflectivity of the texture ===

If you were to use this texture as it is, the resulting object would look very shiny.
That is because Phoenix will set the reflectivity, or inherent 'shininess' of an object depending on the transparency, or alpha value of the texture.

If you want your object to look more matte you need to add transparency to your texture. There are several ways to do this:

The Simple way:
* This method will make the whole texture less shiny:
* Look in the Layer window and change the Opacity of the Layer that contains your texture.
Reflect_1.png (15.61 KiB) Viewed 576 times

* You're done. Save the texture, but make sure that the format you save it as supports Transparency. .tga and .png both do.

The Advanced way:
* This method will allow you to change the shininess of different parts of the texture.
* Find the Channel window. You should see 3 channels, Red, Green and Blue (RGB is simply the sum of all 3):
Reflect_2.png (15.26 KiB) Viewed 575 times

* Add a new Channel (the icon next to the trashcan) By default this is an Alpha Channel.
Reflect_3.png (15.46 KiB) Viewed 570 times

* Like all channels it is black and white. Black is Transparent, and will make the object matte, and White is Opaque, and will make the object reflective.
* If you show the rest of the channels while the alpha channel is visible the parts that are hidden will appear red by default:
* When Finished save the file, but make sure to save it as .tga The alpha layer will -not- be saved if you choose .png

=== Making a normal map for the texture ===

This tutorial does not yet include Instructions for making a normal map. Until someone writes it up, just use the following blank normal map:
blanknormal.png (5.36 KiB) Viewed 566 times

== Setting up the folders ==

Phoenix, Overgrowth's engine uses XML files to tell it where an object's files are located.
These XML files are by default located in Data/Objects. For example the Rock1a.xml file:

<pre>
<?xml version="1.0" ?>
<Object>
<Model>Data/Models/Environments/Rocks/Rock1a.obj</Model>
<ColorMap>Data/Textures/Environments/Rocks/Rock1_Color.tga</ColorMap>
<NormalMap>Data/Textures/Environments/Rocks/Rock1_NormalOS.tga</NormalMap>
<ShaderPath>Data/GLSL/cubemapobj</ShaderPath>
<ShaderName>normalmap</ShaderName>
</Object>
</pre>

The way the file works is self explanatory. The tags indicate what the provided file path points to. As you can see all the file paths have Data as their root. Because of this you'll want your files to be inside the Data folder.

For mac users right click the Alpha, click 'Show Package Contents', Contents->Data. For easy access then drag it into your Sidebar:
Folder_1.png (46.58 KiB) Viewed 563 times

Until the team implements a more elegant solution I suggest that in the Data folder you make a folder called Custom and keep all your files in there. I chose to imitate the file structure in Custom that the Data folder uses by default:
PICTURE

However you can save it any way you choose. If you want to share your Objects with others it is be best to keep all the files in one Folder inside Data/Custom. ultimately in the engine it doesn't make a difference, as long as the XML file is defined correctly

== Making the XML file ==

Now that everything is in the right place you can make the xml Object file.
# Copy any .xml file from the Objects Folder, paste it into your custom folder and rename it as whatever you want. make sure to keep the extension ".xml"
# Open the XML file with a text editor and change the paths to match that of your file.
Here's mine:

<pre>
<?xml version="1.0" ?>
<Object>
<Model>Data/Custom/Models/Demo/Cylinder.obj</Model>
<ColorMap>Data/Custom/Textures/Demo/Cylinder_Color.png</ColorMap>
<NormalMap>Data/Custom/Textures/Demo/Blank_Normal.png</NormalMap>
<ShaderPath>Data/GLSL/cubemap</ShaderPath>
<ShaderName>cubemap</ShaderName>
</Object>
</code>
</pre>

I don't quite know how the shaders work, but I tested each out and listed them here.
Cubemap will work best for most objects.

== Testing the object in the engine ==

Now the moment you've been waiting for:

# Start up the Latest Alpha
# Click the first Button in the toolbar
# Find your .xml object file and click Open
# Pray that you've done everything right and click on the terrain
# Breathe a sigh of relief as your object appears:

The above Object uses a texture without transparency and so looks shiny.

This Object uses a texture with transparency and so has matte areas:

If you get an error message saying that a file cannot be found make sure that the file-paths in the XML Object file are correct.

Here is the final Custom Folder which I made for this tutorial. It contains two objects: one with changed reflectivity, and one without.

FILE

unzip it, make sure the resulting folder is called 'Custom" (otherwise the xml file paths would be incorrect) and place it in the Data folder.

(Notice that I actually did a bad job with the UV mapping, because I chose to automate it and not do it manually, and the texture is not a continuous band, but broken up into 4 parts.)

== Conclusion ==

I really hope that this Guide will be helpful to you.
A-lot of thought and effort went into it, plus at least a good 5+ hours of work

One thing I cannot stress enough is that this guide is by no means perfect, and there are likely better ways of doing this.

My challenge to you is to not just use this guide, but expand on it: Try texturing a sphere, a rock, a Tree, never stop experimenting. Apply what you've learned here and use it to help you make some great content for this game.

If you have ''any'' questions or problems when trying to recreate what is illustrated here, please feel free to ask the friendly people in our [http://www.wolfire.com/irc IRC channel].

== Other Resources ==

LINKS

[[Category:Overgrowth]]