2.5D Terrain: 2D/3D Level Platform Generator for Side-Scrollers

Links: Documentation | Support Forum


☘️ This asset is part of the World Building Bundle. ☘️


How does it work?

Easy: you draw a 2D shape and from it this tool generates a 3D mesh and PolygonCollider2D for you.


✔️ 3D Mesh from 2D Splines (supports holes, overlaps, ..)

Generates a 3D mesh from the defined 2D shape. The 2D shape supports intersections and exclusions. Therefore things like holes are not a problem.


✔️ 2D Collider Generator

Generates a 2D Polygon Collider. Yes, that one supports holes too :-)


✔️ 3D Collider Generator

You need 3D colliders? Simply enable them on the Mesh Generator, done.


✔️ Procedural Foliage Generator

Place bushes, trees, rocks within seconds. It can place any prefab.


✔️ Full Source Code included

Uses Assembly Definitions to improve compile times.


✔️ Use 2D curves to generate a 3D mesh

Generate 3D meshes and 2D colliders with ease combining multiple bezier curves. Think of it as an enhanced Sprite Shape Controller with the ability to generate 3D meshes.


✔️ Supports holes and merging of curves.

Use multiple curves and combine them with boolen operations (add, substract). Punch holes into your terrain or merge curves.


✔️ Live Preview (experimental)

The auto update mode can generate meshes while your are editing them (fast iteration).


✔️ Tri-Planar ShaderGraph shader included. It does generate UVs too (in case you need them).


NOTICE: The included shader is a SHADER GRAPH shader. You need to have the Shader Graph Package installed to use it.


✔️ Compatible with Unity 2019, 2020, 2021, 2022, 2023, .. LTS

Pleas notice that bug fixes are only made for LTS releases. Therefore please upgrade to the most recent LTS version of Unity before submitting a support request. Alpha and Beta releases are NOT officially supported, though I try to support them as best I can.


✔️ Example Assets included: Get a whole low-poly terrain set with textures for free!


✔️ Step-by-step guide in the Manual


Please notice that this is an EDITOR ONLY plugin.

However the mesh generation code was written with runtime in mind. It may work at runtime too but it is not officially supported (may be very slow).



⚙️ Installation

Download the Asset and import it into your project.

You are done, no additional setup is needed.



⚒️ Usage

A new menu called "2.5D Terrain" will be available under "Tools" in the main menu bar. Go check it out once the import is done.


Use "GameObject > Create 2.5D Terrain" from the menu or in the Hierarchy to create a new terrain.


Info: The settings file will be created under Assets/.


Hint: There is a manual, please read it (Tools > 2.5D Terrain > Manual).



☎️ Support

If you have any questions or issues then please use the support form or write to office[at]kamgam.com


Please be patient, replies may take a few days.

Please include your Asset Store Order Nr and your exact Unity version in your request.


You can also ask in the dedicated Unity Forum thread. This way others can follow the discussion. Thank you.



Known Issues / F.A.Q.


● Sometimes the mesh generation fails in Preview Mode (Auto Update). - This can be fixed by slightly adjusting the parameters. If you find a case where it fails persistently over a wide rande of parameters then please let me know.


● Preview Mode performance degrades with complex curve setups and high precision meshes. - That's why it is recommended to divide your terrain into small parts. Don't build one huge terrain. Also small terrains can be copied and reused more easily.




✍️ Licenses

This Asset contains some open source libraries. Please check the LICENSE or README files in the Libraries folder after download.


Licenses used:


* ClipperLib: Boost Software License - Version 1.0

* CurveShortening: https://github.com/acarapetis/curve-shortening-demo, c# port KAMGAM e.U.

* FarseerUnity: Microsoft Permissive License (Ms-PL)

* Poly2Tri: http://code.google.com/p/poly2tri/

* PolygonMesh2D: MIT License



If you like this asset then maybe you'll like these too:


🚴 2.5D Bike Racing Game

A complete racing game template.


🌉2.5D Bridge Builder

Generate bridges based on a curves.


➰2.5D Looping

Looping with 2.5D collider setup.


Mesh Extractor

Separate your assets into useful parts within seconds.




🔑 License Info


This asset requires one license per seat (user who has access to the asset files). If you are a team then please consider buying one seat per Unity user.


Why am I telling you this?

Because most people do not know. In fact any asset found under the Tools category falls under a license type collectively known as Extension Assets(see official license explanation) which differs from the standard (Entity) licenses.


If you have questions about the license then please contact me under office[at]kamgam.com.