Thank you for downloading the 2D Hand Painted Dungeon Pack, we hope it will boost your game! We designed this pack to contain everything required to create a visually stunning, immersive, and complete environment.
Supports Unity versions 2020.3 and later.
The following document should provide all you need to know to utilize everything the pack offers. Although we have invested significant efforts to provide you with the highest–quality product possible, in case you find something missing, unclear, or have a suggestion, please contact us – we are here to assist, help, and support!
Quick Navigation
Getting Started
Installing and configuring this asset is a straightforward and intuitive process. After importing the asset into Unity, the on-screen Installer window will guide you through a simple configuration process. The whole process is automated and performed by the Installer window, and it may take a few minutes.
Installation Steps
    After configuring the Universal Render Pipeline and importing the asset
    into Unity, it will show the Installer window to guide you and configure
    the project on your behalf.
    If the Installer window doesn’t show up, you can open it through the
    2D Hand Painted/Install menu.
The Installer process has four screens:
- Intro – Validate that your render
      pipeline isn’t configured correctly.
 If not configured properly, a message will appear with a link to a configuration manual; configure the render pipeline as described and upon Unity.
- Config – A few options to customize the installation process. It’s best to leave the options as displayed initially.
- Install – The performed tasks will be listed and marked when they are complete.
- Enjoy – That’s it! You can close the window now; everything is ready for you to start using this asset.
Render Pipeline
This asset requires the Universal Render Pipeline with a 2D Renderer.
Requirements
Besides the Universal (2D) Render Pipeline, there are no other requirements.
    Using Sprite Shapes Profiles requires installing the
    2D Sprite Shapes package.
    The Installer window process will install the dependency on your
    behalf.
 You may opt out of installing it.
Demo Scene
    The Demo scene showcases the usage of the pack’s Prefabs, Shaders, and
    Sprite Shapes.
 Navigate the scene at Play Mode using the Arrows or
      W A S D keys; use Left Shift or the Mouse Wheel to boost
    speed.
  
Hierarchy
The scene is divided into three main layers GameObjects: Background, Midground, and Foreground; all Prefabs and Sprite Shapes are placed under one of the three layers.

Parallax
    To achieve a brilliant Parallax effect, we configured the camera’s
    projection to Perspective instead of
    Orthographic.
    To prevent Z-fighting (sprites jittering while the camera moves), please
    configure the 2D Renderer Data asset’s
    Transparency Sort Mode to Orthographic.
  
Lights
The demo scene is designed with rich lighting utilizing Unity’s rich 2D light features.
Prefabs
      The Prefabs folder contains the main assets to use when
      working with this package. They are ready to drag and drop into the
      scene, pre-configured with sprites, materials, scripts, effects, etc.
      The prefabs are organized into groups and are laid out for quick
      reference inside the Spritesheet scene.
    
Composite prefabs, those containing multiple child objects, have a Sorting Group component to allow changing the sorting for all the child renderers at once.
      Some prefabs have variants marked with bracket tags, for example
      [No Wind] variant for plants.
    

Sprite Shapes
Unity’s 2D Sprite Shapes are a flexible and powerful world-building tool that features Sprite tiling along a shape’s outline that automatically deforms and swaps Sprites based on the outline’s angle. It’s great for creating organic and unique art for your games.
      To add a shape to the scene, drag a Shape Profile from the
      Shapes folder. After dragging,
      add a material (and a component when needed) as
      described below.
 Note that some shapes feature multiple variants – be sure to check
        those out!

Closed Shapes TIP
    The closed Shapes Profiles provided by this pack do not
    define sprites for the corners; therefore, we advise adjusting the shapes’
    Spline, using the different Tangent Modes.
    The following method will create authentic and organic shapes (for
    platforms, walls, etc.):
  
- 
      When editing a shape, press on
       Edit Spline. Edit Spline.
- 
      Select a Control Point; three
       Tangent Modes will appear. Tangent Modes will appear.
- 
      Select the middle
       Continuous Mirrored mode. Continuous Mirrored mode.
- It’s worth checking out all Tangent Modes to find which provides an organic shape.
Dungeon Shapes Profiles
    The following is a list of Sprite Shape Profiles provided by this
    pack.
 Please note the recommended configuration for each profile:

- Bricks Wall Closed
- Dungeon
- 4 sprite variants

- Bricks Wall Dark Closed
- Dungeon
- 2 sprite variants

- Rock Ground Closed
- Dungeon
- 3 sprite variants

- Lava Closed
- Dungeon Lava – Waves
- 1 sprite variant

- Bridge Open
- Dungeon
- 1 sprite variant

- Rail Open
- Dungeon
- 1 sprite variant

- Carpet Open
- Dungeon
- 2 sprite variants

- Flag Open
- Dungeon
- 4 sprite variants

- Chain Large Open
- Dungeon
- 1 sprite variant

- Chain Small Open
- Dungeon
- 1 sprite variant

- Rope Open
- Dungeon
- 1 sprite variant

- Ladder Open
- Dungeon
- 1 sprite variant
Effects
    The Effects folder inside the Prefabs folder
    contains effects prefabs that can be placed to enrich the environment.
    Some effects provide an intuitive editor allowing configuration and
    customization.
  
Crystal Fantasy
Sparks and flickering lights – great addition for the crystals.
- Color– Color of particles and light.
- Range– Range for particles spread and light.
- Intensity– Light intensity.
- Flicker Speed– Light random flickering speed.
- Flicker Amount– Light flickering influence.
Fire Smoke
Simple smoke effect, a great addition for torches.
Fire Sparks
Simple sparks effect, great for torches. Orange and blue variants.
Debris & Dust
Every few seconds, a cycle of debris and dust falling from the ceiling.
Lava Bubbles
Some popping bubbles for an active lava pool.
- Width– Size in world space, also affects emission rate.
Lava Steam
Hot steam clouds rising from the lava.
- Width– Size in world space, also affects emission rate.
Lava Sparks
Some sparks to make your lava more dimensional.
- Width– Size in world space, also affects emission rate.
Materials
We geared this pack with the materials pre-configured for all its various assets’ needs. It’s best to use the provided materials instead of creating new ones from the pack’s shaders.
Fog Coloring
      Tint a Sprite (or Sprite Shape) according to its
      Z position.
      Tints the sprite by defining a range where From is the position
      without tint and To is full tint. There is a different color
      (and range) for background and foreground to allow more stylistic
      control.
      The provided materials are pre-configured with fog coloring to match the
      pack’s ambiance.
    
The pack’s shaders don’t rely on Unity’s built-in fog.

Wind
      The pack’s Wind system is composed of a material and a
      component.
      Materials pre-configured with a Wind-supported shader are located inside
      the materials folder.
    
While prefabs are pre-configured with appropriate material and component for static sprites that require wind, Sprite Shapes require manually setting a material and a component for wind support.
      Only after adding a Wind Options (Sprite) component, the
      wind animation will start.
      For each instance, you can use it to customize the Speed,
      Noise which adds a wobble movement, and
      Sway which determines the amount of movement at the side
      farthest than the origin. The Sway Origin is the side that
      isn’t moving.
    
Sprite Shape Wind
      Adding wind to a Sprite Shape is a similar process to a normal Sprite.
      Note that you should use a material with a name containing
      wind (shape) and the
      Wind Options (Sprite Shape) component.
    
Wind Options component only configure the renderer instance
      with the desired behavior via a Material Property Block.
    
Dungeon Materials
The following materials are provided with the pack, alongside additional materials not listed here, and used some of the effects.
Dungeon
The main material for this pack provides dark fog coloring.
Dungeon – Wind
Same as the basic Dungeon material with the addition of wind movement.
Dungeon – Flame
An animated flame effect. Configure it to be orange or blue, with or without a rounded bottom.
Dungeon Lava
The main material for the lava zones has a stronger red fog coloring.
Dungeon Lava – Waves
        Same as the basic Dungeon Lava material with the addition of waves movement.
        
Only for Sprite Shapes.
Components
    Besides the scripts we created for controlling various parts of this
    pack, we also provide a handful of MonoBehaviour components
    to enrich your environments.
    Components are located under the
    2D Hand Painted section of the Add Component menu.
  
- 
    2D Hand Painted - 
    Animate - Light Flicker
- Random Frame
- Rotation
- Shake
- Swing
- Translate Loop
 
- Camera Controller
- Wind Options
 
- 
    Animate 
Wind Options
The Wind Options component functionality is described alongside the Wind material.
Camera Controller
      A simple camera controller, allowing navigation in the Demo scenes.
      Navigate using the Arrows or W A S D keys; use Left Shift or the
      Mouse Wheel to boost speed.
    
Animate
Utility components to quickly and easily create simple animations.
Light Flicker
Requires Light/Light2D component.
      Randomly dims a light. Useful for an ambiance effect of a torch or a
      candle.
      Adjustable: Speed, Intensity Amount.
    
Random Frame
Requires Animator component.
      Start the Animator on a random frame. Helpful in creating variations
      when you have multiple instances of a single animation.
    
Rotation
      Spin a Game Object in a full circle repeatedly.
      Adjustable: Speed.
    
Shake
      Randomly moves a Game Object around its origin.
      Adjustable: Speed, Amount.
    
Swing
      Rotate a Game Object back-and-forth.
      Adjustable: Speed, Movement Amount.
    
Translate Loop
      Moves an object horizontally; when it reaches an edge, it relocates to
      the other edge and resumes movement.
      Adjustable: Speed, Left World X,
      Right World X, Ping Pong (Move back-and-forth
      instead of teleporting), Wave (Animate vertical position),
      Flip With Direction (Mirror sprite based on direction).
    
Structure
    After importing the pack, you should have the
    2D Hand Painted folder added to your project’s
    Assets folder. This folder contains assets from all the
    2D Hand Painted bundle packs.
  
    For the most, what you are looking for is inside the
    Prefabs and Sprite Shapes folders.
  
- 
    2D Hand Painted - 
    $Common - Editor
- Scripts
- Shaders
- …
 
- 
    Dungeon - Animations
- Materials
- Prefabs
- Scenes
- Shapes
- Textures
- PSD Source.zip
- _PackMeta.asset
 
- TagsLayers.preset
- READ ME.pdf
 
- 
    $Common 
- 
    Editor - _HP2DMeta.asset
 
$Common
      Assets and resources that are shared between all the
      2D Hand Painted Bundle’s packs.
      In general, you shouldn’t have to look inside this folder; we will
      expressly state if an asset mentioned in this manual is located inside
      the common folder.
    
Dungeon
It contains all the assets dedicated to the Dungeon Pack.
Scenes
A pack contains two scenes:
- SpritesheetLays out the pack’s various prefabs, grouped by categories. 
- DemoShowcase of the usage of the pack's Prefabs, Shaders, and Sprite Shapes. It’s a great place to start when looking to explore what this pack has to offer. 
Animations
      Animations and Animation Controllers used to breathe life to some of the
      objects. Some packs may not include the Animations folder.
 All animated objects are configured with an Animation Controller
        inside a prefab, so you don’t need to connect anything manually.
Editor
Resources we use for providing you with intuitive workflow while using this asset.
Materials
      There are a variety of materials for each pack.
      The prefabs are pre-configured with material for sprites, but for Sprite
      Shapes, you will need to manually assign a material (as discussed in the
      Materials chapter).
    
Prefabs
This is the main folder to look inside while using this asset. It contains all sprites and effects ready to drop into a scene, pre-configured with materials, scripts, effects, etc.
Scripts
Scripts for controlling effects, animations, etc. If the script is a MonoBehaviour intended to be used by you, it will appear inside the Add Component menu. Otherwise, it is already configured for you inside the appropriate prefabs.
Shaders
      The pack shaders are located under the
      Hand Painted 2D section. As mentioned previously, the
      pack has pre-configured materials; we advise using them
      instead of creating new materials.
    
Shapes
Contains Sprite Shapes Profiles to create beautiful arbitrary-shaped sprites.
Textures
Quality, high-resolution hand-painted sprites next to a few textures used by some of the VFX.
TagsLayers preset
      A preset with pre-configured sorting layers. The Installer window
      process will apply on your behalf.
 You may opt out of applying it.
READ ME pdf
An offline version of this manual.
PSD Source zip
An archive containing all the source Photoshop PSD files.
_PackMeta asset
This file is required for installing the pack, it will be removed by the Installer. Do NOT delete this file!
_HP2DMeta asset
This file is required for installing updates smoothly in the future. Do NOT delete this file!
Common Issues
The following are some issues we encountered more than once. Try looking for a solution before sending us a question – we may have already answered it.
# I have errors immediately after importing the asset.
Make sure to install the Universal Render Pipeline before importing the asset.
# How can I open the Installer window?
    If the Installer window doesn’t show up after importing the asset, make
    sure to correctly configure the Universal Render Pipeline.
    To manually open the Installer, open it through the
    2D Hand Painted/Install menu.
 If you previously installed a different pack from the 2D Hand Painted
      bundle, there is no need to rerun the installation process.
# Sprites are all pink.
Please perform the following checks:
- If you haven't run the Installer – reopen Unity and follow the Installer process.
- Make sure the pack’s materials are configured with a shader.
# Sprites jitter as camera moves.
Configure the 2D Renderer Data asset’s Transparency Sort Mode to Orthographic.
# How to set up a parallax effect?
Follow those steps:
- Configure the camera’s projection to Perspective.
- Configure the 2D Renderer Data asset’s Transparency Sort Mode to Orthographic.
# I added a wind-supported material, but it’s not working.
    To add a wind animation, both a wind-supported material is required as
    well the Wind Options component. Please read the
    Wind manual.
  
# I’m using the Universal Render Pipeline, but the Installer is asking for a 2D Renderer.
    The Universal Render Pipeline has a few renderers; instead of using the
    Forward Renderer, you should configure it to use the
    2D Renderer.
    Check out
    Unity’s documentation
    on configuring it.
  
# A Sprite Shaps is not tinted as normal sprites do.
Make sure to add material from the pack whenever creating a new shape, as described in the Shapes section.
# Sprite renderers have missing Sorting Layers.
    You may have opted out of applying the provided Tags and Layers preset
    during the installation process.
    Please apply the preset TagsLayers.preset that is provided in
    this pack in the
    Tags and Layers manager.
  
# Stacked sprites slide when they should move in sync.
    Make sure they have a similar Z position. Alternatively, add
    a
    Sorting Group
    component to their parent Game Object.
  
