Throwable

A physics-based WordPress block that lets you throw and bounce content around with realistic physics simulation.

Features

• Physics Simulation: Powered by Matter.js for realistic physics
• InnerBlocks Support: Add any content blocks (paragraphs, headings, buttons, images)
• Customizable Physics: Adjust gravity and bounce settings
• Responsive Design: Works perfectly on all devices
• Easy to Use: Simple drag-and-drop interface

Quick Start

1. Install the Plugin

   • Upload to /wp-content/plugins/throwable/
   • Or install through WordPress admin → Plugins

2. Activate the Plugin

   • Go to Plugins screen in WordPress admin
   • Click "Activate" on the Throwable plugin

3. Add the Block

   • Open any page/post in the block editor
   • Search for "Throwable" block
   • Add it to your content

4. Add Content

   • Add any blocks inside the Throwable container
   • Paragraphs, headings, buttons, images all work!

5. Customize Physics

   • Select the Throwable block
   • Use the sidebar settings to adjust:
     • Gravity: Control fall speed (0.1 - 2.0)
     • Bounce: Control how much blocks bounce (0 - 1)

How It Works

The Throwable block creates an interactive physics playground where your content blocks become physical objects that:

• Fall with gravity - Content naturally drops down
• Bounce realistically - Blocks bounce off each other and walls
• Collide with each other - Objects interact physically

Physics Settings

Gravity

• Range: 0.1 to 2.0
• Default: 1.0
• Effect: Controls how fast objects fall
• Lower values: Slower, more floaty movement
• Higher values: Faster, more dramatic falls

Bounce (Restitution)

• Range: 0 to 1
• Default: 0.5
• Effect: Controls how much objects bounce
• 0: No bounce (objects stick)
• 1: Perfect bounce (no energy loss)

Supported Blocks

The Throwable block works with most common WordPress blocks:

• Text Blocks: Paragraphs, headings
• Media Blocks: Images
• Interactive Blocks: Buttons

Mobile Support

• Fully responsive design
• Touch-friendly interactions
• Optimized performance on mobile devices
• Physics simulation works smoothly on all screen sizes

Development

Technologies Used

• Matter.js: Physics simulation engine (MIT License)

Changelog

0.1.0

• Initial release

Contributing

We welcome contributions! Please feel free to submit issues and pull requests.

License

This plugin is licensed under the GPL-2.0-or-later license.

Links

• Plugin URI: https://blocklayouts.com/plugins/throwable
• Contributors: qarayahya

---

Made with ❤️ by qarayahya