https://github.com/radiatoryang/hedera

paint 3D ivy in the Unity Editor, watch procedurally generated meshes simulate growth and clinging in real-time
https://github.com/radiatoryang/hedera

3d 3d-models environment-art foliage-wiggle game-art game-development painting unity

Last synced: 29 days ago
JSON representation

paint 3D ivy in the Unity Editor, watch procedurally generated meshes simulate growth and clinging in real-time

• Host: GitHub
• URL: https://github.com/radiatoryang/hedera
• Owner: radiatoryang
• License: gpl-2.0
• Created: 2019-06-29T12:18:51.000Z (almost 5 years ago)
• Default Branch: master
• Last Pushed: 2022-06-23T22:41:46.000Z (almost 2 years ago)
• Last Synced: 2024-02-09T16:10:50.624Z (4 months ago)
• Topics: 3d, 3d-models, environment-art, foliage-wiggle, game-art, game-development, painting, unity
• Language: C#
• Homepage:
• Size: 32.6 MB
• Stars: 755
• Watchers: 26
• Forks: 60
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE.md

Lists

• awesome-stars - hedera - time | radiatoryang | 694 | (C#)
• anything_about_game - hedera - time (Scenes)
• awesome-unity3d - hedera - paint 3D ivy in the Unity Editor, watch procedurally generated meshes simulate growth and clinging in real-time (Open Source Repositories / Level Editor)
• awesome-stars - hedera - time | radiatoryang | 689 | (C#)
• awesome-opensource-unity - hedera - Paint 3D ivy in the Unity Editor, watch procedurally generated meshes simulate growth and clinging in real-time. (Open Source Packages / Environment)
• awesome - radiatoryang/hedera - paint 3D ivy in the Unity Editor, watch procedurally generated meshes simulate growth and clinging in real-time (C\#)

README

        
# hedera

 

- paint 3D ivy in Unity, simulate growth

- includes textures, shaders, and 5 presets for painting realistic ivy, cartoon ivy, or even ropes and cables

- curious about vert count / polycount? [download sample ivy .OBJ (right-click Save As)](https://raw.githubusercontent.com/radiatoryang/hedera/master/Example/ExampleIvyMeshExport.obj)

    - merge multiple ivy meshes to save draw calls, or just let static batching work

    - randomize vertex colors for subtle color variation, auto-unwrap ivy UV2s for lightmapping

    - store ivy meshes directly in your project, or export to .OBJ (note: OBJ file format doesn't support vertex color nor UV2)

- 25+ different ivy settings to tweak for your own presets! guide and user documentation is on the [Wiki](https://github.com/radiatoryang/hedera/wiki)

- tested on Unity 5.6.7f1 and 2019.1.8 and 2021.2.0f1 (but probably works ok on other Unity versions too)

- **no HDRP or URP shaders included** so you have to swap in your own, but everything else will still probably work OK

- [changelog](https://github.com/radiatoryang/hedera/blob/master/CHANGELOG.md)

### installation 

- (recommended) in Unity's Package Manager, add ``https://github.com/radiatoryang/hedera.git`` as a Git URL package [full instructions](https://github.com/radiatoryang/hedera/wiki#unity-package-manager-recommended)

- or manually download the latest .ZIP from [Releases](https://github.com/radiatoryang/hedera/releases) and unzip to ``//Packages/com.radiatoryang.hedera/``

- or clone this Git repository as a [submodule](https://git-scm.com/book/en/v2/Git-Tools-Submodules) into ``//Packages/com.radiatoryang.hedera/``

### contributors

- please post bug reports or (small) feature requests as an [Issue](https://github.com/radiatoryang/hedera/issues)

- [Pull Requests](https://github.com/radiatoryang/hedera/pulls) are welcome and encouraged

### license

**GPL2** (due to original author's use of GPL2)

- **You can use the ivy assets / generated meshes and results, with any or no license, in commercial or closed source projects.** GPL2 focuses on the code, and does not apply to program output.

- All code is editor-only and stripped upon build, which (I think) avoids GPL2's wrath. This code basically won't be in your build, which means you aren't distributing it.

- If you use this code / tool in your own tool AND distribute that tool, then your tool must use GPL2. Note that Unity Asset Store bans licenses like GPL, so no part of this tool can ever be put on the Asset Store.

- _(but I am not a lawyer, this is not legal advice, etc.)_

### acknowledgments

- based on [C++ code by Thomas Luft](http://graphics.uni-konstanz.de/~luft/ivy_generator/) from 2006 (!)

- based on [Unity C# port by Weng Xiao Yi](https://github.com/phoenixzz/IvyGenerator)

- uses [painting code](https://github.com/marmitoTH/Unity-Prefab-Placement-Editor) and [foliage shader code](https://github.com/marmitoTH/unity-enhanced-foliage) by Lucas Rodrigues

- uses [.OBJ exporter code](https://wiki.unity3d.com/index.php/ExportOBJ) by DaveA, KeliHlodversson, tgraupmann, drobe

- uses [Douglas-Peucker line simplifier code](https://github.com/rohaanhamid/simplify-csharp) by Rohaan Hamid

### press

- this got [coverage in PC Gamer](https://www.pcgamer.com/this-free-open-source-tool-can-help-game-developers-make-procedural-ivy/) for some reason

### donations

- donate to the original Ivy Generator author (Thomas Luft): http://www.loim.de/ivy_generator_donation/

- to donate to me, just go to my itch.io page and buy / tip whatever you want: https://radiatoryang.itch.io/