# HOME

	Cover image
Pixel Art Top Down - Village	/files/KGrDY6G89H1wD9CONFsw	/spaces/IPBJbsBHfwnXGNm0L3kh
Pixel Art Top Down - Basic	/files/WjyrB9mKtkQjOzV02fxx	/spaces/XXykzv2ZOBtAHZzGTFq1
Pixel Art Platformer - Dungeon	/files/dSofFTML5N8AwJEJXcLv	/spaces/2RD5mzvf7qYwyCpm2uH3
Customizable Pixel Character	/files/32RtycFdnriWSqtYgKIB	/spaces/VAsWZLJR6xuMkfJM3gAU
Pixel Art Monster - Dungeon	/files/x5t4tDIro9NqS9extITD	/spaces/mSx8trfX3J4tI1Wvg8rF
Pixel Art Platformer - Village House	/files/zlB9swefNsU8tiYEkUkg	/spaces/GaR7IiGRboSpaS07N5td
Interactive Pixel Water	/files/kAHKvpR0zvodmzkIUghF	/spaces/WsdVV12dCn86UlSmS6CH

# OVERVIEW ### Customizable Pixel Character Thanks for using this asset pack. For any question, feel free to please email to [*support@cainos.net*](mailto:support@cainos.net) ### Quick Tutorial Drag and drop one of the character presets in `Cainos\Customizable Pixel Character\Prefab\Character Preset` into the scene and there you go. Character customization is done in the `Customization` foldout group in `Pixel Character` script. ### Character Control * A andD to move left and right. * SHIFT to run. * CTRL to dodge. * Holding SHIFT and double tap A or D to dash. * C to crouch. * Z to crawl. * SPACE to jump. * LMB to attack. * Holding RMB to look. * V to melee attack. * W and S to climb ladder. * Holding S to jump down platform. # SETUP GUIDE ### Layer Collision Settings To avoid the character colliding with its own weapon. Put the character and weapon into different layer and in the project’s Physics 2D settings, make sure these two layers do not collide. You need to setup this by hand as project settings will not be imported with the asset pack.
In this case we put characters into `Player` layer and weapons into `Player Weapon` layer. Of course, this may vary based on your need. All the character presets are variation prefabs of `Cainos\Customizable Pixel Character\Prefab\PF Pixel Character`. So for overall changes you only need to modify this one.

### Custom Sort Axis It is recommended that you set `Transparency Sort Mode` to `Custom Axis` and `Transparency Sort Axis` to `(0,0,1)` at the Graphics settings.

### Skin Weights For best animation quality, in `Project Settings/Quality`, `Skin Weights` should be set to at least `2 Bones`.

### Color Space It is recommended to use `Linear` color space with this asset. You can find it in `Project Settings/Player/Other Settings`.

### Lighting Support By default, the character shaders behave like an unlit sprite shader, and can be used in any render pipeline. But if you need lighting on the character, you need to install additional shaders to make them support lighting. Currently lighting on character only supports `Universal Render Pipeline`. ### Universal Render Pipeline 2D Lighting Import the patch version that corresponds to your Unity version. It will replace current character shaders with versions that support URP 2D Lighting. * Before Unity 6: Import `Patch - URP 2D Lit` * Unity 6.0 to 6.2: Import `Patch - URP 2D Lit - Unity 6.0 to 6.2` * Unity 6.3 and later: Import `Patch - URP 2D Lit - Unity 6.3` Make sure your 2D lighting is properly set up so the character can be displayed correctly. ### Universal Render Pipeline 3D Lighting Import the patch version that corresponds to your Unity version. It will replace current character shaders with versions that support URP 3D Lighting. * Before Unity 6: Import `Patch - URP Lit` * Unity 6.x: Import `Patch - URP Lit - Unity 6` ### Input System in Unity 6.x For compatiblity, the default input method in this asset still uses the old input manager. And in Unity 6.x, the old input manager is no longer the default option. If you encounter any error regarding the input system. Please change the `Active Input Handling` in `Project Settings/Player` to `Both`

### Fixing Missing UI Text The demo UI utilizes Text Mesh Pro. If your project does not already include it, a prompt to Import TMP Essentials will appear when you open the scene. Please complete the import and then reopen the scene to ensure the text displays correctly. If the prompt does not appear automatically, you can trigger it manually by selecting any Text Mesh Pro object in the Hierarchy. ### Sorting Order Glitch When Using Multiple Character You may see some glitch when two characters are too close. It happens when the two characters take up the same z space. Give them different z position value will solve the problem. \ You can set the character’s z scale to a smaller value like `0.1` (but avoid setting it to `0.0`), so that it takes up less z space.

### Parts of the Character Not Visible When Using a Background The background may be positioned at the same z-coordinate as the character, causing it to occlude parts of the model. Since the character is not a flat plane (it has 3D depth), overlapping z-positions can result in rendering conflicts. Adjust the background’s position by moving it backward along the z-axis (assigning it a larger z-value). This ensures proper depth sorting, allowing the character to render fully in front of the background.

# SCRIPT REFERENCE ### Overview There are 3 scripts attached to the character object.


Pixel Character	Storing object reference inside the character object and character customization.
Pixel Character Controller	Controlling movement of the character.
Pixel Character Input Mouse and Keyboard	Reading mouse and keyboard input and feed into the Pixel Character Controller script

There are also 2 scripts attached to the `Animator` object inside character. Generally, you don’t need to pay attention to these two scripts.


Animation Event Receiver	For receiving animation events.
Root Motion Receiver	For receiving root motion from the animation.

### Pixel Character For storing object reference inside the character object and character customization. #### Reference Foldout Contains reference to objects inside the character object. #### Customization Foldout Parameters here is mainly for tweaking the character appearance. The customization is mainly done by changing the materials here. Can be changed both in editor and runtime.


Blink Interval	The interval range for the character to play an eye blink animation.

Hat Material	Material of the character’s hat
Hair Material	Material of the character’s hair
Eye Material	Material of the character’s eye
Eye Base Material	Material of the character’s eye shape. You only need to change this when changing the character’s gender.
Facewear Material	Material of the character’s facewear.
Cloth Material	Material of the character’s cloth.
Pants Material	Material of the character’s pants.
Socks Material	Material of the character’s socks.
Shoes Material	Material of the character’s shoes. This will be displayed behind the character’s pants.
Back Material	Material of the object the character carries on the back.
Body Material	Material of the character’s body. You need to change this when changing the character’s gender. Also, special character presets would use their specific body material, like Vampire or Zombie.

Clip Hair	Hide part of the character’s hair. When wearing certain hats, you need to enable this.
Hide Hair	Completely hide the character’s hair.
Shoes in Front	Whether to display shoes in front of the character’s pants.

#### Runtime Foldout Parameters here should only be changed at runtime except `Facing`.


Facing	The character’s facing. Can be changed in editor to set the character’s initial facing.
Alpha	Controls the transparency of the entire character.
Is Dead	Whether the character is dead. Turning this on will only make the character appear dead on the graphic side. For making the character truly dead, turn on the `Is Dead` on the `Pixel Character Controller` script.
Expression	The character’s expression.
Injured Front	Play `Injured Front` animation.
Injured Back	Play `Injured Back` animation.
Detach Weapon	Detach weapon to a separated object from the character. Returns the detached weapon game object.
Clear Weapon	Clear out everything in the weapon slot.

### Pixel Character Controller Script for controlling the character’s movement. It will modify some of the `Facing` parameters in the `Pixel Character` script and parameters in the `Animator` to control animation. #### **Movement Foldout** Parameters for the character’s movement.


Ground Check Layer Mask	Objects under this layer mask will be consider ground the character can stand on.

Walks Speed Max	Max walking speed.
Walks Acc	Walking Acceleration.

Run Speed Max	Max running speed.
Run Acc	Running Acceleration.

Crouch Speed Max	Max move speed while crouching.
Crouch Acc	Crouching acceleration.

Crawl Speed Max	Max move speed while crawling.
Crawl Acc	Crawling acceleration.

Air Speed Max	Max move speed while in air
Air Acc	Air acceleration

Ground Drag	Braking acceleration (from movement to still) while on ground
Air Drag	Braking acceleration (from movement to still) while in air

Jump Enabled	Whether the character can jump.
Jump Speed	Speed applied to the character when jump.
Jump Cooldown	Time needed to be able to jump again after landing.
Jump Tolerance	When character is off ground and inside this time, the character is still able to jump.
Jump Gravity Multiplier	Gravity multiplier when character is jumping. Should be within `[0.0,1.0]`, set it to lower value so that the longer you press the jump button, the higher the character can jump.
Fall Gravity Multiplier	Gravity multiplier when character is falling. Should be equal or greater than `1.0`

Dash Enabled	Whether the character can dash.
Dash Speed Start	Speed when dash starts.
Dash Speed Max	Max move speed while dashing.
Dash Acc	Dash acceleration.
Dash Time	Time the dash state will last.
Dash Cooldown	Time it takes for the character to be able to dash again after exiting dash state.

Dodge Enabled	Whether the character can dodge.
Dodge Speed Mul	Dodge speed multiplier
Dodge Cooldown	Time it takes for the character to be able to dodge again after exiting dodge state.

Swim Enabled	Whether the character can swim. When disabled the character will ignore the water.
Swim Speed Max	Max swimming speed.
Swim Speed Fast Max	Max swimming speed when in fast moving mode (when the run key is down).
Swim Acc	Swim acceleration.
Swim Buoyancy Speed	The speed applied to the character as buoyancy when in water.
Keep in Water Depth When Diving	Whether to automatically keep current in water depth when diving. When disabled the character will always try to float to the water surface.

Ladder Climb Enabled	Whether the character can climb ladder.
Ladder Climb Speed	Ladder climbing speed.
Ladder Climb Speed Fast	Ladder climbing speed when the run key (by default is `SHIFT`) is pressed.

Ledge Climb Enabled	Whether the character can climb ledge.

#### Attack Foldout Parameters for the character’s attack action.


Attack Action	Attack action to perform whether primary attack key (by default is `LMB`) is pressed.
Attack Action Melee	Attack action to perform whether melee attack key (by default is `V`) is pressed, or when the character is in a state when primary attack action is not available, like when crawling or climbing ladder.

Attack Speed Mul	Speed multiplier of the attack animation. You can use this to make the character attack quicker or slower. Default value is `1.0`
Attack Cooldown	Time needed to be able to attack again after last attack action ended. Default value is `0.0`, means no cooldown.

Throw Force	When using `Throw` attack action, the character will throw out the weapon it is holding. This defines the force applied to the thrown weapon.
Throw Angular Speed	The angular speed applied to the thrown weapon.

Projectile Speed	The speed applied the projectile when using `Cast` or `Archery` attack action.
Projectile Prefab	The prefab of the projectile to be instantiate when using `Cast` or `Archery` attack action.

#### Event Foldout This foldout contains some Unity events that you can use to trigger your own function. A typical use case is to play sound effects when curtain event happens.


On Footstep	When the character’s foot touches the ground in animation like walk or run.

On Jump	When the character jump away from ground.
On Land	When the character land on the ground from air.

On Dodge Start	When dodge action starts.
On Dodge End	When dodge action ends.

On Attack Start	When attack action starts.
On Attack Hit	When attack action is supposed to hit the target. Damage to the target can be applied at this event.
On Attack End	When attack action ends

On Bow Pull	When using `Archery` attack action, the character start pulling the bow string.
On Bow Shoot	When using `Archery` attack action, the character release the bow string and the arrow is shot.

On Throw	When using `Throw` attack action, the character throws out the holding weapon.

#### Input Foldout Parameters for receiving inputs from input scripts. If you are going to use your own input scripts, you need to modify these parameters in your scripts. Only available at runtime.


Input Move	movement input, x for horizontal, y for vertical, x and y should be in `[-1.0, 1.0]`
Input Run	Run input, when enabled the character will run instead of walk.
Input Dash	Dash input, when triggered the character will enter dash state.
Input Dodge	Dodge input, when triggered the character will enter dodge state.
Input Crouch	Crouch input, when enabled the character will be crouching.
Input Crawl	Crawl input, when enabled the character will be crawling. Will override crouch input.
Input jump	Jump input, when triggered the character will start to jump. When continuously enabled the character will jump higher.
Input Attack	Primary attack input, will trigger the attack action when available.
Input Melee	Melee attack input, will trigger the melee attack action.
Input Look	Look input, when enabled the character will look at the position defined by `Input Target`
Input Target	This is a world space `Vector2` position that defines the target the character should look at or point at when performing curtain attack action.

#### Debug Foldout Parameters for switching debug gizmos display. #### Runtime Foldout Parameters here should only be changed at runtime. Most parameters here is read only and just for exposing states of the controller. ### Pixel Character Input Mouse and Keyboard This script will read mouse and keyboard input and modify parameters in the `Input` foldout of the `Pixel Character Controller` script. If you are going to use your own input script or let an AI to control the character, just remove this script. It is also a good example for showing how to feed input to the `Pixel Character Controller` script. | *Is Dead* | Is the character dead? if yes, plays dead animation and disable control. | | --------- | ------------------------------------------------------------------------ | ### Pixel Character Audio A placeholder script for character audio. It is not added to the character by default. You can use this script as a reference and foundation if you intend to add audio for the character. # CUSTOMIZATION ### Overview In this part we will go through the ways to customize different parts of the character. Most of the customization is done by changing material in `Customization` foldout of the `Pixel Character` script. It can be done both in editor and runtime. You can check the character presets to see how their customizations are set up.

### Gender By changing the `Body Material` and `Eye Base Material` to corresponding material. Also, pick a hair material to match the gender. ### Skin Tone By changing the `Skin Tint` parameter in the `Body Material` of the character. ### Hairstyle & Hair Color By changing the `Hair Material`. Notes that not every hairstyle & hair color combination has a material created in advance, but you can easily create your own: Duplicate a hair material and change the `Main Texture` for hairstyle, `Ramp Texture` for hair color.

### Hat By changing the `Hat Material`. When using certain hat, you also need to enable the `Clip Hair` or `Hide Hair` to hide part of the hair outside the hat. ### Facewear By changing the `Facewear Material`. ### Cloth By changing the `Cloth Material`. ### Pants By changing the `Pants Material`. ### Socks By changing the `Socks Material`. ### Shoes By changing the `Shoes Material` . Also, turn `Shoes In Front` on or off based on whether the shoes should be displayed in front of the character’s pants. ### Back By changing the `Back Material`. ### Weapon By dragging one of the weapon prefabs in `Cainos\Customizable Pixel Character\Prefab\Weapon` into the `Weapon Slot`.

# INTERACTABLE OBJECTS ### Ladder A ladder the character can climb onto. It needs a `Box Collider` with `Is Trigger` enabled which defines the area of the ladder. And a `Ladder` script with the `Direction` set to the ladder’s direction (`Left` or `Right`). The `Climb Pos` is a transform inside the ladder object which defines the character’s position when climbing the ladder.

### Platform One-way platform that the character can jump onto and get down from it. When standing on a platform and keep pressing down key, the character can directly get down from the platform. It needs a collider with `Used By Effector` enabled, a `Platform Effector 2D` with `Collider Mask` set to exclude the player layer, and a `Platform` script.

# MAKING YOUR OWN ANIMATIONS ### Overview Below is a short tutorial for making new animation for characters inside Unity. ### Basic Select any one of the character prefabs and go into Prefab Editing mode. Select `Animator` in the `Hierarchy`, create a new clip in the Animation window. Then you can start keying your animation.

You should only key on objects under the `Animator` object. All the character’s bones are in the `Rig` hierarchy. ### Bone Display You can use the `Bone Renderer` script of Unity’s `Animation Rigging` package (available in Package Manager) for displaying and easy selecting bones in the scene.

* Add a `Bone Renderer` script to the character and click on the lock button on the top-right corner of the Inspector window. * Right click on `Rig` object inside the character hierarchy and select `Select Children`. * Drag all the objects selected to the `Transforms` list of the `Bone Renderer` script. Some of the Rig objects are just helper objects. For example `Rig`, `Rig LPlatform`, `Rig RPlatform`. You can delete them from the `Transforms` list to stop them from being displayed. As the `Bone Renderer` cannot properly display end bone’s length correctly. You can manually and a new object to the end bone and place it at the end position, then drag it to the `Transforms` list of the `Bone Renderer` to force the end bone to be displayed with a proper length.

### Animator Setup When your animation is done, you need to put the clip into the character’s `Animator Controller`. In this case we made a kick animation, so we add a new layer in the `Animator` called `Kick`, a new trigger parameter call `Kick` and setup the animation state as the picture below. \ We use an empty state (with no motion clip) as the entry state. When `Kick` parameter is triggered, it transits to the `Kick` state with the animation clip we just made. When the `Kick` animation finish playing, it goes back to the `Empty` state.

### Scripting Then we need to trigger the `Kick` parameter with our code. You can put the code anywhere you like. In this case, we put it in the `Pixel Character Controller` script. Then, we are able to trigger the kick animation by the `Kick` function or the `Kick` button in the Inspector.

### Create a Specific Prefab for Making Animation The weapon object placed inside `Weapon Slot` is syncing its position with `Rig Weapon` bone through script in runtime. So, in the editor, the weapon object will not move with the `Rig Weapon` bone. This brings inconvenience when making animation. To solve this, simply drag the weapon object into the `Rig Weapon`. As mentioned above, there are many modifications we may need to do to the character prefab to prepare it for making animation. So, my suggestion is that you copy the character prefab you want to make animation for and make your modifications to the clone instead of directly to the prefab you are going to use in game. Animations created in any one of the character prefabs are also compatible in other characters as they share the same rig structure. # OVERVIEW ### PIXEL ART PLATFORMER - DUNGEON Thanks for using this asset pack. For any questions, please email to [*support@cainos.net*](mailto:support@cainos.net) # SETUP GUIDE ### Color Space It is recommended to use `Linear` color space with this asset. You can find this setting at `Project Settings/Player/Other Settings`. ![](/files/roVAmp0Li4QxQPzk1w1c) ### Universal Render Pipeline The demo scene requires `Universal Render Pipeline` to work. You can install it in the `Package Manager`. After the `Universal Render Pipeline` is properly installed, you can use the `Universal Render Pipeline Asset` that comes with this asset. You can find it at `Cainos/Pixel Art Platformer – Dungeon/Rendering` ### Shader Errors After the `Universal Render Pipeline` is properly installed, if you get any shader errors, just select `Cainos/Pixel Art Platformer – Dungeon/Shader` in the `Project` window, right click and select `Reimport`. ### URP 2D Lighting Support By default, the demo scene uses URP 3D lighting. It can be switched to use URP 2D lighting by simply importing `Cainos/Pixel Art Platformer – Dungeon/Patch - URP 2D Lit`. After importing, please reopen the demo scene for the changes to take effects. If the demo scene appears very dark after importing, just try importing the patch once again and reload the scene. ### Using Post Processing Using post processing will significantly improve the look of the scene. The demo scene already has post processing setup properly. But if you are going to start with a new scene, consider adding it to the scene. You can find the post processing profile used in the demo scene at `Cainos/Pixel Art Platformer – Dungeon/ Rendering/Post Processing Profile`. Please read this document for more details: [Post Processing in URP](https://docs.unity3d.com/Packages/com.unity.render-pipelines.universal@17.0/manual/integration-with-post-processing.html) Below is the comparison of results with versus without post processing: ![](/files/4jcBF81ZvlepHgoW7wfM) ![](/files/ZN0Qc2p0BZK5wtgzmnuP) # CHANGLOG ### 1.1.5 * Some minor bugs fixed. ### 1.1.4 * Fix some minor issues in Unity 6. ### 1.1.3 * Some minor bugs fixed. ### 1.1.2 * Some minor bugs fixed. ### 1.1.1 * Some minor bugs fixed. * Add ducument. ### 1.1.0 * Add URP 2D lighting support. ### 1.0.3 * Tileset collider shape improvements. * Editor scripts improvements. * Some minor bugs fixed. ### 1.0.2 * Some minor bugs fixed. ### 1.0.1 * Some minor bugs fixed. ### 1.0.0 * First release # OVERVIEW ### Pixel Art Monster - Dungeon Thanks for using this asset pack. For any question, please email to [*support@cainos.net*](mailto:support@cainos.net) ### Monster Control * A andD to move left and right. * W andS to move up and down for flying monsters. * Hold SHIFT to run. * SPACE to jump. * LMB to attack. * K to kill or revive. * \[ and ] to trigger hit animation. # SETUP GUIDE ### Animation Event and Event Receiver There are animation events already set up as `On Footstep` and `On Attack` at the monster’s animation files. At the `Animator` object inside a monster prefab, there is a `Animation Event Receiver` script attached to it, which will receive these events and can be used to trigger some functions when the event is fired. For example, in the `PF Skeleton – Archer` prefab, the `On Attack` event is used to trigger the `Launch` function of the `Projectile Launcher` script, so the archer skeleton can actually shoot an arrow.

### About Monster Prefabs For every kind of monster, there is only one original prefab, and the skin variations are set up as prefab variant of that original prefab. ### Custom Sort Axis It is recommended that you set `Transparency Sort Mode` to `Custom Axis` and `Transparency Sort Axis` to `[0,0,1]` at the graphics settings.

### Sorting Order Glitch with Multiple Monster You may see some glitch when two monsters are too close. It happens when the two monsters take up the same z space. Give them different z position value will solve the problem. You can set the monster’s z scale to a smaller value like 0.1 (but avoid setting it to 0), so that it takes up less z space. ![When the two monster are too close, and their position.z values are all at \[0.0\]. You can see their sprites got mixed together](/files/K6SH8isIdgZm7r0EiskW) ![Give them different position.z values. Displayed in 3D view](/files/zFFOzJrFaydTEXlH1VR1) Now they are properly displayed

### Skin Weights For best animation quality, in `Project Settings/Quality`, `Skin Weights` should be set to at least `2 Bones`.

### Input System in Unity 6.1 For compatiblity, the default input method in this asset still uses the old input manager. And in Unity 6.1, the old input manager is no longer the default option. If you encounter any error regarding the input system. Please change the `Active Input Handling` in `Project Settings/Player` to `Both`

### Universal Render Pipeline 2D Lighting Import files from `Patch - URP 2D Lit` located at the root folder of the asset. It will replace current monster shaders and some materials with URP 2D Lighting supported version. ### Universal Render Pipeline 3D Lighting Import files from `Patch - URP Lit` located at the root folder of the asset. It will replace current monster shaders and some materials with URP 3D Lit supported version. # SCRIPT REFERENCE ### Overview First, just play around in the demo scene to see each monster and their skin variations. Drag and drop one of the monster prefabs in `Cainos\Pixel Art Monster - Dungeon\Prefab` into your scene and then you can control it with your mouse and keyboard. For every monster prefab, there are 3 scripts attached to it:


Pixel Monster	Controlling the appearance and animation of the monster.
Monster Controller	Controlling the movement of the monster.
Monster Input Mouse and Keyboard	Reading mouse and keyboard input and feed into the Monster Controller script

Generally, you would let an AI rather than players to control the monsters. In this case, remove the `Monster Input Mouse and Keyboard` component and let your AI to feed in the input values to the controller script, or you can only keep the `Pixel Monster` component and take full control of the monster’s movement by yourself. ### Pixel Monster Script for controlling the appearance and animation of the monster. Properties in the `Runtime` foldout should only be modified in the runtime except `Facing`. Some properties in the `Runtime` foldout will be modified by `Monster Controller` script.


Renderers	Reference to all the renderers inside the monster prefab.
Animator	Reference to the animator object inside the monster prefab.
Fx	Reference to the object that contain special effects inside the monster prefab. Can be left empty.
Die Fx Prefab	The special effects object to instantiate when the monster dies. Can be left empty.

Alpha	Controls the transparency of the entire monster.
Facing	The monster’s facing. Can be changed in editor to set the character’s initial facing.
Is Hiding	Is the monster hiding. Only works for Mimic.
Is Grounded	Is the monster on ground.
Is Dead	Is the monster dead? Turn this on will only let the monster play the die animation. If you also want to stop the monster’s movement. Turn on the [Is Dead] property of the controller script.
Moving Blend	Moving animation blend. 0.0: Idle 0.5: Walk 1.0: Run

Attack	Play attack animation.
Injured Front	Play `Injured Front` animation.
Injured Back	Play `Injured Back` animation.

### Monster Controller Script for controlling the monster’s movement. It will modify some of the parameters in the `Pixel Character` script to control animation.


Default Movement	Default movement type, walk or run.
Walks Speed Max	Max walking speed.
Walks Acc	Walking Acceleration.
Run Speed Max	Max running speed.
Run Acc	Running Acceleration.
Air Speed Max	Max move speed while in air.
Air Acc	Air acceleration.
Ground Brake Acc	Braking acceleration while on ground. Applied when there is no movement input.
Air Brake Acc	Braking acceleration while in air. Applied when there is no movement input.
Jump Speed	Speed applied to the character when jump.
Jump Cooldown	Time needed to be able to jump again after landing.
Jump Delay	Time it takes from the moment the jump input is fired to the moment the monster actually jumps. During this time, the jump prepare animation will be played to achieve a more realistic jump behavior, and you will need to press the key for a little while until the monster actually jump. If you do not need this, you can set it to 0.
Jump Gravity Multiplier	Gravity multiplier when the monster is jumping. Set it to lower value so that the longer you press the jump button, the higher the monster can jump.
Fall Gravity Multiplier	Gravity multiplier when monster is falling.
Moving Blend Transition Speed	The transition speed when modifying the `Moving Blend` property in `Pixel Monster` script.
Ground Check Size	Size of the box on character's bottom to determine whether the character is on ground.
Can Attack in Air	Can the monster perform attack action while in air.
Can Attack When Moving	Can the monster perform attack action while moving. When turned off, it also forbids the monster to move while in attack animation.

Input Move	Movement input, x for horizontal, y for vertical, x and y should be in `[-1.0, 1.0]`.
Input Move Modifier	Input to switch between walk and run.
Input Jump	Jump input.
Input Attack	Attack input.
Is Dead	Is the monster dead? When turned on, it will also turn on the `Is Dead` property on `Pixel Monster` script and stop the monster’s movement.

### Monster Flying Controller Same as `Monster Controller` script, but for monsters that can fly.


Speed Max	Max moving speed.
Acc	Moving Acceleration.
Brake Acc	Braking acceleration Applied when there is no movement input.
Ground Check Size	Size of the box on character's bottom to determine whether the character is on ground.
Moving Blend Transition Speed	The transition speed when modifying the `Moving Blend` property in `Pixel Monster` script.
Dead Gravity Scale	Gravity scale when the character is dead. Flying monsters will have their gravity scale set to 0 when there are alive. So, this parameter actually controls whether the flying monster should fall to the ground when it is dead.

Input Move	Movement input, x for horizontal, y for vertical, x and y should be in `[-1.0, 1.0]`.
Input Attack	Attack input.
Is Dead	Is the monster dead? When turned on, it will also turn on the `Is Dead` property on `Pixel Monster` script and stop the monster’s movement.

### Monster Input Mouse and Keyboard Script for feeding player inputs to `Monster Controller` script using mouse and keyboard. # BLENDER SOURCE FILES ### Requirements Blender version**:** 5.0.1 or later. Open the provided Blender source files using a supported version to avoid compatibility issues.

### Animation Naming Animation names describe the clip type, target frame range, and whether the animation loops. Example: `Walk 30L` * `Walk` is the animation name. * `30` indicates a target frame range of **0–30**. * `L` indicates that the animation is designed to **loop**. Some animations contain keyframes outside the target frame range. These are offset loop frames used to create secondary motion. When configuring the clip in your game engine, ensure that only the specified target frame range is used. ### Jump Animations The jump animation is divided into several clips so the game engine can select the appropriate animation based on the character’s current state.

Clip	Usage
Jump Prepare	Played while the character prepares to jump.
Air Up	Played while the character is moving upward.
Air Down	Played while the character is falling.
Land	Played when the character touches the ground.

Some characters include two variants of the upward-motion animation:

Clip	Usage
Air Up Idle	Used when the character is moving upward without moving forward.
Air Up Move	Used when the character is moving upward while also moving forward.

These clips should be selected according to the character’s movement and jump state in the game engine. The `Jump Full` clip combines the complete jump sequence: * Jump Prepare * Air Up * Air Down * Land This clip includes vertical movement on the root bone. It is intended primarily for preview and demonstration purposes and is generally not used in the game engine. ### Recommended Unity Export Settings Use the following settings when exporting the character and animations for Unity:

### Unity Import Settings After importing the exported file into Unity: * Open its import settings. * Enable `Bake Axis Conversion` in the `Import Settings` * Configure each animation clip to use only its specified target frame range. * Enable looping for animation names ending in `L`.

# OVERVIEW ### Pixel Art Top Down - Basic Thank you for using this asset pack. For any questions, please email to [*support@cainos.net*](mailto:support@cainos.net) # SETUP GUIDE ### Import The asset is uploaded as a complete project to included some project settings. It is recommended to import it into an empty project first. ### Custom Sort Axis The `Transparency Sort Mode` should be set to `Custom Axis` and `Transparency Sort Axis` to `(0,1,1)` at the Graphics settings.

### Color Space It is recommended to use `Linear` color space with this asset. You can find it in `Project Settings/Player/Other Settings`.

# SORTING LAYERS ### Overview As you can see, the demo scene has platforms of different height levels. To make them sorted correctly, each height level is put at a different `Sorting Layer`. Inside each `Sorting Layer`, objects also have different `Order in Layer` values.

For collision to work correctly in each height level, objects in different `Sorting Layer` should also be put into corresponding `Layer`. In order to make the player object able to travel between different layers. There is a `Edge Collider 2D` with `Stair Layer Trigger` script attached. When the player object touches the trigger, it will be sent to the layer and sorting layer defined in the script.

### Import Tags & Layers Settings The demo scene needs proper tags & layers settings to work properly. In order to include the tags & layers settings, the asset is uploaded as a complete project. On import, you should be able to see the project settings included. If you did not import the tags & layers settings on import, you can still set it by clicking the slider icon at the top right corner of the Tags & Layers settings and select the preset included in the asset.

# CHANGELOG ### 1.2.0 * Add stairs in west and east direction. * Stairs Layer Trigger improvement. * Add URP 2D Lit support in Unity 6. ### 1.1.2 * Some minor issues fixed. ### 1.1.1 * Some minor issues fixed. ### 1.1.0 * Add URP 2D Lit support. * Some minor issues fixed. ### 1.0.1 * Add Tags & Layers settings as preset. * Updated document. ### 1.0.0 * First Release # OVERVIEW ### PIXEL ART TOP DOWN – VILLAGE Thanks for using this asset pack. For any questions, please email to [*support@cainos.net*](mailto:support@cainos.net) # SETUP GUIDE ### Color Space It is recommended to use `Linear` color space with this asset. You can find this setting at `Project Settings/Player/Other Settings`.

### Universal Render Pipeline The demo scene requires `Universal Render Pipeline` with `2D Renderer` to work. You can install it in the `Package Manager`. After the `Universal Render Pipeline` is properly installed, you can use the `Universal Render Pipeline Asset` that comes with this asset. You can find it at `Cainos/Pixel Art Top Down – Village/Rendering`. If you are using your own render pipeline asset, make sure to set `Transparency Sort Mode` to Custom Axis with Transparency Sort Axis set to `[0, 1, 1]`.

### Unity 6 Support Import `Patch - Unity 6` package at the root folder of the asset to add Unity 6 support. Sometimes you will get a error of `[Top Down Pixel Water Renderer Feature] Blur shader not set.` after importing. In this case, just follow the [Top Down Pixel Water](#top-down-pixel-water) setup steps to add the material and shader to the renderer feature. ### Building for WebGL in Unity 6 For the water to be rendered correctly in WebGL builds, you need to disable `Auto Graphics API` and set `Graphics API` to `WebGPU` in `Project Settings > Player > Other Settings` .

### Pixel Aligned Placement By setting the move value of Increment Snapping to `0.03125 (1/32)`, and press CTRL when moving objects, the objects can be placed perfectly aligned to the pixel grid.

### Top Down Pixel Water This asset is uploaded as a complete project to included project settings. The `Top Down Pixel Water` renderer feature should be well setup by default. If you need to set it up by yourself, follow the below instruction: * Add a `Top Down Water Renderer Feature` to the render pipeline asset. * Assign the water material at `Cainos/Pixel Art Top Down - Village/Material/MT Top Down Pixel Water` and gaussian blur shader at `Cainos/Pixel Art Top Down - Village/Shader/SH Render Pass - Gaussian Blur` to the `Reference` foldout. * Set `Terrain Layer Mask` and `Water Layer Mask`. The `Terrain Layer Mask` is used to render refraction and a color gradient from shore to deep water. It should contain layers of the terrain tile map and other objects that directly touch the water, for example, the support of the dock. The `Water Layer Mask` should only contain the water prefab. * Find the `PF Top Down Pixel Water` in `Cainos/Pixel Art Top Down – Village/Prefab/FX` and drag it to the scene.

### Optimize the Water for Mobile Platform The rendering of the water is quite performance heavy. When optimizing for mobile platforms, please try the follows settings. On `Assets\Cainos\Pixel Art Top Down - Village\Rendering\Universal Render Pipeline Asset - 2D Renderer`, find the `Top Down Pixel Water Renderer Feature` and tweak the blur settings of the water. The idea is to make `Downsample` as large as possible and `Kernel Size` and `Blur Pass` as small as possible while maintaining an acceptable water rendering quality.

On the `Universal Render Pipeline Asset`, set `Render Scale` to 0.5. Mobile platforms usually have much higher DPI so we do not need to render at full resolution.

On `Project Settings/Player`, Set `Graphics APIs` to `Vulkan`, enable `Multithreaded Rendering` and `Graphics Jobs`.

With these settings, the demo scene can run at 60fps at Xiaomi MIX 2S, a pretty old device. # TILE PALETTE ### Scripted Tile There is one single tile besides every terrain texture tile sets. This tile is a scripted tile and will automatically draw different tiles from the normal tile set as variation with each paint. ![](/files/26DBhjftCpUQ8CBnkicR) You can find the configurations of the scripted tiles at `Cainos/Pixel Art Top Down – Village/Tileset/Scripted Tile`. `Decoration Rate` is the chance to draw a random tile from the `Decoration` list rather than from the `Basic` list, in range `[0, 1]` `Seed` is the random seed to use.

Below is an example of using `Decoration Rate` at `1.0` vs `Decoration Rate` at `0.0` for `ST Glass`

### No Collision Tile The last group of the terrain tiles are the same as the first group, but with no collision

They are used in positions like the example shown below to prevent generating collision into higher layer of terrain.

# WATER RENDERING The water effect is achieved through a custom shader combined with a Renderer Feature. Below is a breakdown of the rendering process. The water shader `ASE Top Down Pixel Water` is made using [Amplify Shader Editor](https://assetstore.unity.com/packages/tools/visual-scripting/amplify-shader-editor-68570). If you own this asset, you can open the shader as a graph to see how it is made.

### Water Color Render terrain and water-touching objects defined in `Terrain Layer Mask` into a texture named `Terrain Tex`. Apply a gaussian blur to the alpha channel of `Terrain Tex` using parameters from `Water Color Blur Setting`, creating `Terrain Blurred Tex`.

Terrain Blurred Tex Overlayed by Terrain Tex

Then we can use the grayscale of `Terrain Blurred Tex` to lerp between `Shallow Color` and `Deep Color` to create a gradient from shallow water near the shore to deep water far from the shore.

### Shore Line Shift the alpha of `Terrain Texture` down by one pixel size (1/32 in world space as this asset is 32x32 per unit), color it with `Foam Color` and blend it with the base water color.

### Refraction First we need to create a mask texture `Under Water Mask Tex` in the same way as we create the `Terrain Blurred Tex` in the Water Color step, but with parameters from `Under Water Mask Blur Setting`. For the content to be refracted, we use the `Terrain Tex` and move it down twice, each by `0.4` tile size, mix them together and color it with `Under Water Color`.

For the distortion effect, apply time-animated Voronoi noise to UV coordinates when sampling from `Terrain Tex`. Then we can mask the result with `Under Water Mask Tex` to create a fading effect and blend it to the base water color.

Under Water Content with Noice Distortion

### Foam We use a foam texure `TX FX Water Foam` from this asset, sample it with the UV multiplied by `2.0` in the vertical direction to match the perspective of the top down scene, and disturb it with a time-animated noise. For the mask, we use the maske value from `Under Water Mask Tex`, but move it down by `0.5` tile size and power the value by `2.5` (make the white part wider).

### Highlight The highlight pattern is made by multiplying two noise with different size and moving direction, then powered with `6.5` to extract the most light color, and stepped by `0.3` to make it flat. The UV of the noise is multiplied by `20` in the vertical direction to make it much wider horizontally.

Two Noise Multiplied Together and Powered by 6.5

Then we can use this as a mask to add `Highlight Color` to the water to create the final water effect.

# CHANGLOG 1.0.4 * Add PSD files. 1.0.3 * Some minor issues fixed. 1.0.2 * Fix water renderer feature glitch when game view and scene view are active at the same time. 1.0.1 * Add Unity 6 support. 1.0.0 * First release. # OVERVIEW ### PIXEL ART PLATFORMER – VILLAGE HOUSE Thanks for using this asset pack. For any questions, please email to [*support@cainos.net*](mailto:support@cainos.net) # SETUP GUIDE ### About Materials The demo scene makes use of 3 materials with special shaders to draw shadows on house sprites.


MT Village House – Component	Common house sprites use this material. It makes sure shadow sprites only get drawn within visible areas of house sprites.
MT Village House – Component – No Shadow	House sprites that should never be covered by shadow use this material. Shadow sprites will not get drawn upon sprites with this material.
MT Village House – Shadow	Shadow sprites use this material. It works together with the two materials above to mask shadows inside house sprites and make sure shadows only get drawn once.

MT Village House – Component

Common house sprites use this material.

It makes sure shadow sprites only get drawn within visible areas of house sprites.

MT Village House – Component – No Shadow

House sprites that should never be covered by shadow use this material.

Shadow sprites will not get drawn upon sprites with this material.

MT Village House – Shadow

Shadow sprites use this material.

It works together with the two materials above to mask shadows inside house sprites and make sure shadows only get drawn once.

You can change the shadow color globally with the `Tint` parameter of the material. ### House Presets In `Assets/Cainos/Pixel Art Platformer - Village House/Texture/House Preset` you can find house presets in single image, in case you do not want to use the prefab ones. ### Custom Sort Axis It is recommended that you set `Transparency Sort Mode` to `Custom Axis` and `Transparency Sort Axis` to `(0,0,1)` at the graphics settings.

### 2D Lighting Import `Patch - URP 2D Lit` located at the root folder of the asset. It will replace current shaders and some materials with URP 2D Lighting supported version. At the `MT Village House – Shadow` material, make sure its render queue value is higher than the render queue value of the two component materials. As the component materials have render queue value of 3000. We set the shadow material’s render queue to 3001.

# OVERVIEW ### Interactive Pixel Water Thanks for using this asset pack. For any question, feel free to please email to [*support@cainos.net*](mailto:support@cainos.net) ### Quick Tutorial Drag and drop the water prefab in `Cainos\Interactive Pixel Water` into the scene, adjust the size of the water area with the handles at the corners. For more advanced configuration of the water, you can check the water presets at `Cainos\Interactive Pixel Water\Prefab` for reference. If you change any of the paramters of the `Pixel Water` script from code, remember to call `Refresh()` to make the changes to take effect. # SETUP GUIDE ### Lighting Support for URP and URP 2D By default, the water shaders are in built-in unlit type. Import the `Patch - URP Lit` to add lighting support for normal 3D lights in URP. For URP 2D Lighting, please import the patch version that corresponds to your Unity version: * Before Unity 6: Import `Patch - URP 2D Lit` * Unity 6.0 to 6.2: Import `Patch - URP 2D Lit - Unity 6.0 to 6.2` * Unity 6.3 and later: Import `Patch - URP 2D Lit - Unity 6.3` In Unity 6, you should also turn off the `Compatibility Mode` in `Project Settings>Graphics`, as the water rendering depends on the Render Graph.

After importing the patch, you need to add a `Pixel Water Renderer Feature` to your current Universal Rnder Pipeline Asset, and set the `Behind Water Mask` to the layers you want to be shown behind the water. Be noted, you must not include the water layer in the `Behind Water Mask`. ### Change Water Area Size with Handles You can drag the four white square handles at the corners to change the size of the water. For the handles to be displayed, you need to select the water object and have the gizmos visibilty toggle on (the top right highlighted button). Please do not selec the Rect Tool (left highlighted button) while using the size handles. The handles of the Rect Tool will overlap with the size handles.

### Custom Sort Axis It is recommended that you set `Transparency Sort Mode` to `Custom Axis` and `Transparency Sort Axis` to `(0,0,1)` at the Graphics settings.

### Color Space It is recommended to use `Linear` color space with this asset. You can find it in `Project Settings/Player/Other Settings`.

# SCRIPT REFERENCE ### Pixel Water #### Basic Foldout These settings control the size and interaction layers of the water body.


Size	A `Vector2` controlling the width (X) and maximum height (Y) of the water area. Modifying this regenerates the mesh.
Fill	A float (0 to 1) representing the vertical fill percentage. `1.0` is full height defined by `Size.y`, while lower values lower the water surface level

Interaction Layer Mask	Defines which layers contain non-trigger colliders that can physically interact with the water (create waves, splashes, etc.).
Interaction Trigger Layer Mask	Defines which layers contain trigger colliders that can interact with the water.

#### Rendering Foldout These parameters control the visual appearance of the water, passed directly to the shader.


Water Color Enabled	Toggles the water color. When off the water itself will be transparent
Water Color Shallow	The color gradient from the water surface (shallow) to the bottom (deep). The color is blended using alpha blend.
Water Color Deep	The color gradient from the water surface (shallow) to the bottom (deep). The color is blended using alpha blend.

Underwater Tint Enabled	Toggles the tint applied to the content behind the water.
Underwater Tint Shallow	The color tint applied to content behind the water, grading from surface (shallow) to bottom (deep). The color is blended using multiply.
Underwater Tint Deep	The color tint applied to content behind the water, grading from surface (shallow) to bottom (deep). The color is blended using multiply.

Surface Enabled	Toggles the rendering of the surface line at the top of the water. The surface line is divided into upper and lower part.
Surface Color Upper	Color of the upper part of the surface line.
Surface Color Lower	Color of the lowerpart of the surface line.
Surface Thickness Upper	Controls how thick the upper surface line is rendered.
Surface Thickness Lower	Controls how thick the lower surface line is rendered.
Surface Distortion Mul	Multiplier for the distortion effect of the surface line.

Distortion Enabled	Toggles the refraction/distortion effect of the behind water content.
Distortion Speed	Controls the animation speed of the effect.
Distortion Scale	Controls the texture scale of the effect.
Distortion Strength	Controls the intensity of the effect.

Blur Enabled	Toggles the blur effect for the behind water content.
Blur Amount Shallow	The blur effect intensity, grading from surface (shallow) to bottom (deep).
Blur Amount Deep	The blur effect intensity, grading from surface (shallow) to bottom (deep).

Light Shaft Enabled	Toggles the effect of light beams shining down into the water.
Light Shaft Color	The color and transparency of the light beams. The color is blended using add mode.
Light Shaft Scale	Controls the size of the light rays.
Light Shaft Power	The power applied to the alpha of the light rays.
Light Shaft Tilt	Controls the angle of the light rays.
Light Shaft Depth	Controls the fade-depth of the light rays.
Light Shaft Speed	Controls the animation speed of the light rays.

Wave Enabled	Toggles the physics-based spring simulation for surface waves.
Wave Influence Mul	Multiplier for how much an object's velocity (X and Y) impacts the water surface to create waves.
Wave Influence Decay Depth	The depth at which an object no longer creates surface waves (objects deep underwater won't disturb the surface).
Wave Tension	Controls the stiffness of the wave. Higher values make the water surface snap back to rest position faster.
Wave Damping	Controls friction of the wave. Higher values make waves settle and stop oscillating faster. Avoid setting it to near zero.
Wave Spread	Controls how fast a wave ripple travels to neighboring vertices.
Wave Spread Iteration	The quality/smoothness of the wave propagation calculation (higher is more accurate but more expensive).
Wave Speed Mul	Global speed multiplier for the wave physics simulation.
Wave Velocity Limit	Clamps the maximum speed of the wave.
Wave Limit	Clamps the maximum amplitude of the wave.

Ambient Wave Enabled	Toggles the constant background waves.
Ambient Wave Mul	Global intensity multiplier for the ambient wave.
Ambient Wave Speed	Parameters that allow layering up to 4 different wave noises (x, y, z, w) for complex, non-repeating surface wave motion.
Ambient Wave Frequency	Parameters that allow layering up to 4 different wave noises (x, y, z, w) for complex, non-repeating surface wave motion.
Ambient Wave Amplitude	Parameters that allow layering up to 4 different wave noises (x, y, z, w) for complex, non-repeating surface wave motion.

#### FX Foldout Controls particle and prefab instantiation when objects interact with the water.


Bubble Enabled	Toggles bubble effect generation.
Bubble Duration Mul	Multiplier for bubble emit duration.
Bubble Amount Mul	Multiplier for bubble emit amount.
Bubble Color Outline	The outline color of the generated bubble.
Bubble Color Fill	The fill color of the generated bubble.
Bubble Prefab	The prefab instantiated to create bubbles. (must contain `PixelWaterBubble` script).

Splash Enabled	Toggles splash effect generation.
Splash On Enter	Whether to generate splash when objects enter the water.
Splash On Exit	Whether to generate splash when objects exit the water.
Splash Color Light	The color of the lighter part of the splash.
Splash Color Dark	The color of the darker part of the splash.
Splash Color Outline	The outline color of the splash
Splash Configs	A list of `SplashConfig` objects defining different splash types based on object size. Size Range: The object size range (min/max) that triggers this specific splash. Min Speed: Minimum entry velocity required to trigger this splash. Min Depth: Minimum water depth required. Splash Prefab: The visual prefab to spawn.

Surface Particle Enabled	Toggles continuous particles on the water surface. For example, surface bubble and spark of the lava preset.
Surface Particle Configs	A list of `ParticleConfig` objects defining particle systems used as the surface particle. The script automatically changes their emission shape to match the water surface. Particle System: The particle system to control. Emit Mul Per Unit: The emit rate multiplier per unit to ensure if you make the water area larger, the surface particle also emit more particles.

In Water Particle Enabled	Toggles continuous particles inside the water volume For example, the floating debris in the muddy preset.
In Water Particle Configs	A list of `ParticleConfig` objects defining particle systems used as the surface particle. The script automatically changes their emission shape to match the water surface. Particle System: The particle system to control. Emit Mul Per Unit: The emit rate multiplier per unit to ensure if you make the water area larger, the surface particle also emit more particles.

#### Physics **Foldout** Controls the custom drag (resistance) applied to objects inside the water.

Drag Enabled


Drag Enabled	Toggles the custom drag force. Note that we do not use the standard Unity `BuoyancyEffector2D` drag here, as this custom implementation scale with the velocity, making it more physically correct.
Drag Linear	How much linear velocity is slowed down.
Drag Angular	How much rotation (angular velocity) is slowed down.

Toggles the custom drag force.

Note that we do not use the standard Unity BuoyancyEffector2D drag here, as this custom implementation scale with the velocity, making it more physically correct.

Drag Linear How much linear velocity is slowed down.

Drag Angular How much rotation (angular velocity) is slowed down.

#### Event Foldout This foldout contains some Unity events that you can use to trigger your own function.

On Splash


On Splash	A Unity Event `(int level, Vector3 position)` invoked whenever a splash occurs. You can hook sound effects or other scripts to this event.

A Unity Event (int level, Vector3 position) invoked whenever a splash occurs.

You can hook sound effects or other scripts to this event.

### Pixel Water Renderer Feature


Behind Water Mask	The layer mask of the objects that need to be rendered behind the water. You must not include the water itself in this layer mask.
Background Color	The color to use if there is nothing behind the water.
Downsample	Downsample rate for capturing the behind water texture. Higher value improves performance but make behind water content more blury.

Behind Water Mask

The layer mask of the objects that need to be rendered behind the water.

You must not include the water itself in this layer mask.

Background Color

The color to use if there is nothing behind the water.

Downsample

Downsample rate for capturing the behind water texture.
Higher value improves performance but make behind water content more blury.

# Page # Page # Page # Page # Page