The Bubble Gun is a High-tier powered tool that shoots a continuous stream of bubbles to clean blocks at a distance, and can even trap living entities inside floating bubbles! Think of it as the powered, long-range, upgraded version of the Soap.
How to Use
Section titled “How to Use”- Inspect Mode: Right-click to open the gun’s GUI for loading soap, water cells, and upgrades.
- Shoot Mode: Hold right-click to fire a stream of bubbles at the targeted block or entity.
- Switch Mode: Sneak + Right-click to cycle between Inspect and Shoot modes.
- Fill from World: Right-click on a water source block to fill the internal tank directly.
GUI & Inventory
Section titled “GUI & Inventory”The Bubble Gun has a built-in GUI with the following slots:
| Slot | Purpose |
|---|---|
| Soap | Insert a Soap item (consumed during cleaning/trapping) |
| Cell In | Insert water cells, water buckets, or any fluid container with water |
| Cell Out | Emptied containers are automatically placed here after draining |
| Upgrades | 2 upgrade slots (Overclocker for speed, Energy Storage for more capacity) |
A water tank indicator on the right side of the GUI shows the current water level using the animated water texture.
Block Cleaning
Section titled “Block Cleaning”Shooting at a cleanable block (same types as Soap) for a sustained period will clean it. The Bubble Gun cleans all the same block types as Soap: oxidized copper, waxed blocks (including waxed signs), and mossy blocks.
Entity Trapping
Section titled “Entity Trapping”Shooting at a living entity for a sustained period will trap it inside a bubble! The trapped entity:
- Is encased in a semi-transparent bubble
- Floats upward at a configurable speed
- Cannot move or be controlled by AI
- Is released when the bubble pops after a configurable duration
- Takes fall damage upon release (gravity resumes naturally)
Bubble particles appear around the targeted entity while being shot, providing visual feedback that the entity is in range.
Specifications
Section titled “Specifications”| Setting | Default Value | Description |
|---|---|---|
| Capacity | 400,000 E | Total energy storage (upgradeable) |
| Energy Cost | 10 E/tick | Energy consumed per tick while shooting |
| Water Capacity | 16,000 mB | Internal water tank capacity |
| Water Cost | 5 mB/tick | Water consumed per tick while shooting |
| Range | 12 blocks | Maximum shooting range |
| Clean Duration | 20 ticks | Time to clean a block (1 second) |
| Trap Duration | 40 ticks | Time shooting at an entity before trapping (2 sec) |
| Float Duration | 60 ticks | How long the bubble floats before popping (3 sec) |
| Float Speed | 0.15 b/tick | Upward speed of the bubble |
Look at the config file for more detailed settings and adjustments.




