Kangaroo Physics

Kangaroo is a Live Physics engine for interactive simulation, optimization and form-finding directly within Grasshopper.

Installation instructions are included with the download.


A draft manual can be found at


For questions and discussion please visit http://www.grasshopper3d.com/group/kangaroo

The latest release makes use of the Plankton halfedge mesh library by myself and and Will Pearson, released under the terms of the LGPL license ( https://github.com/Dan-Piker/Plankton )

Support Email: 4FQ.RYY3Q4@LYTGD.RYG3SP@
Plug-in rating:
Average: 4.6 (104 votes)
Title Release Notes
Kangaroo Physics 0.099
Many new features, including: Tetrahedral+triangular finite elements, 'Zombie' solver option, point-line force, area-dependent weight, soap-film elements with optional anisotropy, geodesic control strings, updated MeshMachine. See group for more details  
Version: 0.099
Language: English
Kangaroo Physics 0.096
minor bug fix (data trees were not correctly handled in duplicatePts component) See the forum for more details of new features.  
Version: 0.096
Language: English
Kangaroo Physics 0.095
Many new features, including: Remote timer controller, reciprocal structures, gears, remeshing, true minimal surfaces, developable strips, simple origami, fast sphere collision... Speed improvements/bug fixes.  
Version: 0.095
Language: English
Kangaroo Physics 0.085
Minor bug fix for RemoveDuplicateLines component  
Version: 0.085
Language: English
Kangaroo Physics 0.084
Added BoxCollide Force. Traction option on MeshCollide. Changes for increased speed in some functions. Several new UserObjects to simplify inputs for common operations. Various new utility components. other minor bug fixes  
Version: 0.084
Language: English
Kangaroo Physics 0.080
Adds an option to constrain AnchorPoints separately in the x y and z axes, and contains a fix for the CollideMesh component. Also, this is the first official version where the physics engine library is a separate file from the Grasshopper component.  
Language: English
Kangaroo Physics 0.074
Added 'Level Set' force, springs can now have upper and lower cutoffs, added depth dependent pressure force, added 'relative' and 'waterline' options to Wind force  
Language: English
Kangaroo Physics 0.06
New forces added : Alignment, Wind, ConstrainToCurve, ConstrainToMesh, Shear, Vortex, Planarize Ngon. Other new functions : AnchorSprings, Trails, Planarity measure. Various bug fixes  
Language: English
Kangaroo Physics 0.051
Compatible with Grasshopper 0.8.0006. Fixed a bug where Custom masses were not properly assigned. Added Laplacian smoothing force. Added NakedVertices component. Added VertexNeighbours component  
Language: English
Kangaroo Physics 0.065
- Hinge force. For shells/plates, origami & unfolding/flattening meshes. - TangentIncircles force (CP meshes). - FoldAngle measurement (to set rest angle for hinges). - Plasticity input to Springs/AnchorSprings (permanent deformations).  
Language: English
Homepage: Kangaroo Physics


Thanks to Daniel for adding new features.

I am having what seems to be a similare problem to a few people.

I didn't see a solution here in the comments though. I would hugely appreciate any help!!!!

Object: MeshMachineComponent3 (level 1)
  Exception has been thrown by the target of an invocation.

Object: MeshMachineComponent3 (level 2)
  Could not load file or assembly 'Plankton, Version=, Culture=neutral, PublicKeyToken=null' or one of its dependencies. The system cannot find the file specified.

Object: KangarooA (level 1)
  Exception has been thrown by the target of an invocation.

Object: KangarooA (level 2)
  Could not load file or assembly 'KangarooLib, Version=, Culture=neutral, PublicKeyToken=null' or one of its dependencies. The system cannot find the file specified.

Object: KangarooZombie (level 1)
  Exception has been thrown by the target of an invocation.

Object: KangarooZombie (level 2)
  Could not load file or assembly 'KangarooLib, Version=, Culture=neutral, PublicKeyToken=null' or one of its dependencies. The system cannot find the file specified.


I don't have the mesh decompose component.

Any ideas?


elisabri's picture


I would ask you a question please,

I'm trying to install 'Kangaroo Physics 0.099' ( in  Rhiniceros.4 program)


I Placed all the .dll and .gha files in my Grasshopper libraries folder , but when i start the programme

i discoverd that there are just few component, 

I cannot find the physics component, SpringsFromLine, etc...

How can i install these?



Newbie here.having difficulty finding grasshopper's libraries folder to copy kangaroo's dll files to. There only seem to be cursors,components and icons files.

Thanks for your help.

What are the measurement units for the different forces? Is there a possible list, or a way that I can find out? 


Hi !

I installed the latest version of Kangaroo (0.099) with Plankton, Grasshopper 0.8.0066 and Rhino 4 SR9.

I can see the Kangaroo tools but when I try to use most of them it says : "The user object coul not be created as the base type is missing."

What can I do ?

Thanks in advance for your help,



I followed all the instructions but for some reason I keep getting this error:

Object: KangarooA (level 1)
  Ein Aufrufziel hat einen Ausnahmefehler verursacht.

Object: KangarooA (level 2)
  Die Datei oder Assembly "KangarooLib, Version=, Culture=neutral, PublicKeyToken=null" oder eine Abhängigkeit davon wurde nicht gefunden. Das System kann die angegebene Datei nicht finden.


lucy.geo's picture


I have freshly installed the latest kangaroo file and followed all instructions (copied and unblocked all the .dll, .gh files to Libraries folder, also unblocked all the user objects) - and i have kangaroo running and it seems fine.
But I am missing the MeshDecompose component (mComp) - what can be the problem?


Having exact same problem.

Hi , I have nearly same problem. Although I unblocked all the dll files, I have not gravity component.

romualdo's picture


I am running Kangaroo Physics .096 and for some reason I am not getting the Object kangaroo Physics. All the icons appear at the menu except so the most important. I uninstalled and install few times, but still the icon is no showing.

Anybody has any idea what I am doing wrong with the installation?

iremnurtokac's picture

I was having the same problem. Then, I realized I haven't put dll files and unblocked them. Make sure that you put and unblocked all the dll and gha files that you have put in grasshopper/libraries. I think it should start working after doing that.

Please explain why i dont have the hinge component. I get that error every time i use king kong kangaroo cluster

agneesh's picture

Hi There,

Does the latest version work with Rhino 4.0 & relevant GH?

I downloaded latest Kangaroo gll & gha files. However, i could not find special folder and hence could not copy & paste user objects. Now my Kangaroo component has disappeared frm my GH :-( please help!!!

rarasati's picture

hy, i hve a problem with kangaroolib.particlesystem.m_scuttoff_sq' .

so i cant connect some point or curve to "connection" input at "kangaroo physics" . wht must i do?

i'm unable to run kangaroo in grasshopper 0.9.0014 with rhino 4.

i removed all installs of kangaroo and the kangaroo tab disappears

i reinstall latest kangaroo (096) and tab reappears, but when loading any object i get several errors of missing files with old version numbers. indeed the files aren't there (such as TangentInCircles for example) but in strangely it's asking for an old version (such as 084 for example)

it sounds like there's an older version of kangaroo around but where??? a search for kangaroo on my pc shows nothing except the latest version.

any help appreciated! thanks,


solosails's picture

I have the same problem.


I can only get up to 0.084 working. The latest three versions do nopt install all of the operators and the main kangaroo element.

Does this mean all of us on Rhino 4 are stuck with this release, or will there be a backward compatability release in the future?

Thank you very, very much by the way for releasing this awesome set of tools, it's amazing - 

Hey buddy,
I had the exact same problem! Basically I downloaded Kangaroo version 84 from the available downloads (and deleted the Kangaroo 96 from my components folder).
Give it a go!

Hi everyone

My question concerns the "force objects" input in the kangaroo tool. On a number of tutorials i saw, the tutor is able to connect more than just one force to "force objects" (eg "unary force" + "spring"). When I try this, it automaticly disconects the first force.

Please help!

frane's picture


hold shift white connecting, and flatten the input (rmb over the input)


hello guys, i have problem with Plaw component. i dont know why its not working again but nothing error report. please give me solution. thanks


maybe it's silly question but in kangaroo tab i do not have kangaroo component.
rhino 4sr9/gh 0.9.0006/kangaroo 0.085 or 0.084.
thanks for your help.

oliverdavidkrieg's picture

Hi Daniel,

seems like for a collegue and me the library cannot be loaded. Whatever we do, there are two errors when GH loads:

Exception has been thrown by the target of an invocation

Could not load file or assembly 'KangarooLib, Version=, .....' FileNotFoundException

arquitextonica's picture

I'm having the exact same problem. Tried almost everything I could think of.

hery dude, if u still got that problem

the thing is that you need to erase all kangaroo files, then download the latest version, before doing anything just open rhino and grasshopper

on grashopper go to file/special folders/components and in there you got to copy the .gha and .dll kangaroo files that you just download, after they are indside that folder just right click on each of them/properties/unblock

then restart rhino and grasshopper and wou will be all set


Thankyou!  This was very helpful. 

keving's picture

I'm getting the same errors as well. Is it something to do with this version of kangaroo?

ben_neo's picture

why don't find download link?


Is there someone that knows were can I find in the new version of Grasshopper the command 'wbEdges'?
Or which command
should I use to get the same effect?

fdelecea's picture
mpaez's picture

Hi everyone!
Where can I find the dll file for KangarooPhysics006???
In the download link I can olnly get the .gha file.


Daniel Piker's picture

mpaez - Version 006 does not require a separate dll file, as it is integrated into the .gha

caitlyn parry's picture

i'm just dong a tutorial (very first time using grasshopper or kangaroo) http://rhinotuts.com/502/kangaroo-basics-tutorial/

I can not find the boolean toggle icon. I dont have the 'special' ribbon in grasshopper. Can anyone help me out please?
much appreciated

Daniel Piker's picture

Hi Caitlyn,
In the latest Grasshopper the Boolean toggle icon has changed, and it can now be found in Params>Input

jocelyn's picture

I'm running rhino 5 sr9 and the newest version of grasshopper.Here's some problems when loading the kangaroo...
I'm a beginner to it, and don't know how to solve the problem...And also how will it affect my running of kangaroo?
Any help appreciated.Thanks a lot!

Object: KangarooA (level 1)
Exception has been thrown by the target of an invocation.

Object: KangarooA (level 2)
Method not found: 'Void GH_InputParamManager.Register_PointParam(System.String, System.String, System.String, Boolean)'.

vicvellocet's picture

i'm running rhino 4 sr9 and grasshopper 0.8.0052.
my kangaroo is not appearing in gh. i'm receiving this message on rhino command history:

An error occured during GHA assembly loading:
Path: C:\Documents and Settings\Administrator\Application Data\Grasshopper\Libraries\KangarooPhysics006.gha
Exception System.TypeLoadException:
Message: Method 'get_IsValidWhyNot' in type 'Kangaroo.Options.KOptions' from assembly 'GHkangarooINTERNAL, Version=, Culture=neutral, PublicKeyToken=null' does not have an implementation.

can somebody help me?

Daniel Piker's picture

@vicvellocet - from that error message, I can see you are using the outdated version of Kangaroo. Try downloading the latest one (I've changed the icons no to make it a bit clearer which is the current release), and removing any previous versions

loggchen's picture

Hi to all people out there, who have troubles to get latest GH and Kangaroo running!

I had same problems, while running GH 20110421 with Kangaroo 044 without problems, I updated to newer GH and kangaroo 066 and couldn´t manage to show up GH.

It didn´t work, whatever I tried: installed C++ 2005, C++ 2010, installed, deinstalled, reinstalled .net frameworks from 3.0 up to 4.0, used .net framework repair tools from Aaron Stebner ... hour´s for nothing, didn´t work.

Solution for all Win 7 users:

Just make a Win 7 inplace upgrade (no matter, if you have it already installed - this will repair all .net framework problems without the necessity of new installation of all your programs etc..). Google will show up enough tutorials, how to make a inplace upgrade and where to pay attention if you need to do it.

I made a win 7 inplace upgrade, and after that everything worked simply absolutely fine as it should.

Hopefully this may help somebody else.


Roman Pomazan's picture

I've just installed new version of GH 0.8.0052. But Kangaroo doesn't work in it. How to plug Kangaroo to new version of GH?


Daniel Piker's picture

Hi Roman,
This version of Kangaroo should be compatible with GH 0.8.0052
Can you give some details -Rhino 4 or 5 ?
Do you get an error message or Kangaroo doesn't show up ?

Roman Pomazan's picture

I use Rhino 4 SP8. Kangaroo 066 doesn't appears even.

Daniel Piker's picture

Can you try updating to SR9 and see if the problem still occurs ?

Roman Pomazan's picture

Previous version of kangaroo has been deleted previously but smth goes wrong

Daniel Piker's picture

Did you try after installing the latest service release ?

Carlos Machado's picture


Casy's picture

Daniel, what can I do with line representation - i want to see resulting lines through geometry out pin, but it goes with error

Daniel Piker's picture

The geometry input can currently only accept points, meshes and lines. Try putting your lines through an actual Line Grasshopper parameter object to make sure they are not getting treated as curves.
Also - as the physics engine itself is ultimately working with just a set of points, for geometry to get moved with the simulation, all its vertices must coincide with points involved in the simulation. (eg the ends of the lines are also ends of springs)

Hrvoje Petrovic's picture

Thanks for 066!

Protected Collaborative Environments Wildcard SSL Certificates
© 2014McNeel Europe. User-submitted content and trademarks property of their respective owners.