Work: Algodoo Mods

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.

C. Scene-Based Mods

Most mods are simply scenes with hidden script boxes. They: algodoo mods work

• Use scene.my variables to store custom states.
• Create invisible controllers that modify physics in real-time.
• Use laserPen as a trigger for mod toggles.

1. The "Soft Mod": Scripting Secrets

When you see a creation online that looks like magic, it is usually a Soft Mod.

In the standard Algodoo toolbar, you have sliders for things like Friction, Bounciness, and Density. But the engine has hundreds of hidden variables. Soft modding involves using the "Script Menu" (accessed by right-clicking an object and selecting "Script") to type in commands manually.

Common Soft Mod hacks include:

• Infinite Motors: Changing motorSpeed to a value higher than the slider allows (like +infinity rpm).
• Laser Colors: Changing the RGB values of laser beams to create "healing" lasers or "damage" lasers.
• Spawn Keys: Writing scripts that spawn new objects automatically when a button is pressed, allowing for reloadable turrets.

This is how creators make "mechanical" scenes. They aren't using a mod pack; they are manually writing code to bend the physics engine to their will.

What Are Algodoo Mods?

In the context of Algodoo, “mods” (modifications) generally fall into two categories:

1. Script-based enhancements – Custom Thyme script code injected into scenes or global settings.
2. External modifications – Tweaks to configuration files, asset replacements, or (rarely) memory patching of the executable.

Unlike traditional games with dedicated modding APIs, Algodoo doesn’t officially support external plugins. Instead, its modding scene thrives thanks to the built-in Thyme scripting language—a powerful, Lisp-like scripting engine that controls nearly every object property, simulation parameter, and UI behavior. This is a deep guide into the mechanics,

The Community: Where to Find Mods That Work

The golden age of Algodoo modding (2009-2015) left many broken links. Today, these are the reliable sources:

1. The Official Algobox (algodoo.com/algobox): Use the tag [script] or [mod]. Look for high-rated scenes by users "Kilinich," "s_noon," or "Dr.Balk."
2. The Algodoo Discord Server: The most active community. Under the #thyme-scripting channel, users post working scripts daily. This is the #1 place to get help.
3. YouTube + Pastebin: Many tutorial creators link their mods in video descriptions. Copy the Pastebin raw code directly into the Algodoo console.

Why Some "Algodoo Mods" Fail (Troubleshooting)

If you have tried a mod and it isn’t working, check these common issues:

• Outdated Version: Most mods were created for Algodoo 2.0.0 or 2.1.0. The current version (2.2.0) changed how laser.collideset works. Look for mods updated after 2021.
• Collision Groups Not Matching: A mod that expects "Group A" to collide with "Group B" will do nothing if your scene has no groups defined.
• Console Errors: Press F10 to open the console log. Red text means an error. A common one: ["string" : 45] attempt to index a nil value – meaning the mod is looking for an object that doesn't exist.
• Antivirus Interference: If you download an external .exe patcher, Windows Defender may quarantine it. These are often false positives, but only download from trusted sources like the Algobox forums.

The Core: Thyme Scripting

Thyme is the heart of Algodoo modding. Every object (box, circle, hinge, laser, etc.) can run Thyme scripts in response to events (onCollide, onHitByLaser, onUpdate, etc.). Modders write Thyme code to create new behaviors, such as: Use scene

• Advanced weapons (guided missiles, raycast guns)
• Custom forces (wind zones, magnetic fields)
• UI overlays (health bars, score counters)
• Procedural terrain generation

Example: A simple Thyme script that makes a circle explode on collision:

onCollide = (e)=>
  scene.addCircle(entity.pos, 0.5, color=[1,0,0,1])
  entity.density = 0

By sharing these scripts via the Algodoo community site or scene files, users effectively “mod” the game without touching system files.