Algodoo Mods Work Here
In Algodoo, "mods" typically refer to custom scenes and scripts created using the Thyme scripting language
. These modifications allow you to go beyond standard physics by automating actions, creating interactive games, or changing object properties through the Script Menu. How Algodoo Mods and Scripts Work Scripting with Thyme
: Mods are essentially code written in Thyme, Algodoo's built-in language. You can access an object's code by right-clicking it and opening the Script Menu (the icon looks like a small page). Property Modification
: You can change how an object behaves by modifying properties like restitution . For example, setting glued = true makes an object stick to the background. The Console (F10) : Advanced modding is done through the console. By pressing algodoo mods work
, you can enter direct commands to find hidden properties or run complex global scripts. Scene Sharing : Most users "install" mods by downloading scene files from the Algodoo Scene Sharing site
or community forums. These scenes often contain pre-built logic like marble race counters or territory war systems. External Editing
: Because the internal text boxes lack features like scroll bars, many creators write their complex scripts in external programs like and then paste them into Algodoo. Common Modding Tasks FAQ - Algodoo In Algodoo, "mods" typically refer to custom scenes
This is a deep guide into the mechanics, logic, and technical structure of how mods work in Algodoo.
It is important to understand that Algodoo is unique because its "modding" scene isn't typically about binary injection or DLL files (though those exist). Instead, it relies heavily on Thyme Scripting, file manipulation, and the engine's distinct rendering pipeline.
Here is how Algodoo mods work, broken down by layer. Popular Mod Examples
Popular Mod Examples
- Gun system – Spawns projectiles with realistic recoil and explosion effects.
- Vehicle engines – Torque-based motors with gear shifting.
- Numeric displays – Seven-segment LEDs using text objects updated via
onUpdate. - Wave simulation – Real-time fluid surface dynamics beyond the built-in water.
Step 1: Locate Your Algodoo Directory
- Windows:
C:\Program Files\AlgodooorDocuments\Algodoo\scenes - Mac:
Applications/Algodoo.app(Right-click > Show Package Contents) - Linux (Wine):
~/.wine/drive_c/Program Files/Algodoo
The entity System
In Algodoo, everything is an entity with an ID. Deep mods utilize spawning. Instead of drawing a machine gun, a modder scripts:
- Step 1: Create a rectangle (the gun body).
- Step 2: Write a script in the
Updateloop:scene.addCircle( pos := e.pos; radius := 0.1; restitution := 0.9 )
This script tells the engine: "Every frame, spawn a small circle at the tip of the gun." This is how automatic weapons are built in Algodoo.
Step-by-step (Standard Mod Scenes)
- Download a
.algodooor.phnmod file. - Open Algodoo.
- Drag & drop the file into the Algodoo window.
- Press
Ctrl + Eto open the script menu and view how it works.
What Are Algodoo Mods? (And What They Are Not)
First, let’s clear up a major point of confusion. Algodoo does not have an official Steam Workshop or a built-in modding API like modern AAA games. Instead, "Algodoo mods" generally fall into three categories:
- Thyme Script Mods: Algodoo’s internal scripting language, Thyme, is incredibly powerful. Users write scripts that add new tools, automate building, or create custom GUI elements. These are the most common "mods."
- Custom Scenes with Embedded Code: A single Algodoo scene file (.phz) can contain thousands of lines of Thyme code. Many creators release "mod scenes"—essentially, a sandbox environment pre-loaded with new physics behaviors (e.g., realistic water simulation, electrical circuits, or NPC movement).
- External Patchers/Injectors (Rare & Risky): A small, advanced community has created external programs that modify the Algodoo executable directly. These can add features like higher resolution limits or new polygon tools. Note: Use these with caution, as they can trigger antivirus software.
For 99% of users, "Algodoo mods work" refers to Thyme script mods.


