Vacuum Gun

The Vacuum Gun is a multipurpose utility tool that can suck in blocks, fluids, items, and mobs from a distance and launch them back out. It features a built-in 5-slot dispenser-like inventory, 2 upgrade slots, and intelligent interactions depending on what you suck in or launch.

How to Use

Vacuum: Right-click to vacuum the targeted block, fluid, item, or mob into the gun’s internal inventory.
Blow: Switch to Blow mode and right-click to launch the first item in the inventory toward where you’re looking.
Inspect: Switch to Inspect mode and right-click to open the gun’s inventory GUI for manual management.
Switch Mode: Sneak + Right-click to cycle between Vacuum, Blow, and Inspect modes.

Vacuum Mode

The Vacuum mode uses raycasting to target whatever the player is looking at within range. Targets are prioritized in this order:

Priority	Target	Behavior
1	Living Entities	First strips equipped items one at a time. Once bare, converts to a spawn egg (preserving all NBT data and custom names) and stores in inventory. If no spawn egg exists for the mob type, it pulls the entity toward the player instead
2	Items	Picks up the item entity and stores it in inventory
3	Fluids	Collects source fluid blocks into a bucket (requires an empty bucket in the gun’s inventory)
4	Blocks	Breaks the block and stores all drops in inventory (respects bedrock and unbreakable blocks)

Blow Mode

The Blow mode launches the first non-empty item from the gun’s inventory with a physics-based arc trajectory (affected by gravity and drag). Depending on the item type, special interactions occur when the item lands:

Item Type	Landing Behavior
Projectiles	Launched as actual projectiles (arrows, snowballs, etc.) with proper velocity and ownership
TNT / Nuke	Primes and spawns at the landing location (supports Tech Reborn Nukes if enabled)
Spawn Eggs	Spawns the entity at the landing location, restoring all saved NBT data if available
Bone Meal	Applies growth effect (crops or water plants) at the target block
Buckets	Filled buckets place their fluid; empty buckets collect source blocks at the target
Flint & Steel	Lights TNT, campfires, or places fire at the landing location
Shears	Shears sheep, carves pumpkins, harvests honey from beehives, or stops plant growth
Blocks	Placed at the landing location (adjacent to the hit surface)
Equippable	Equips on the nearest entity at the landing location (armor on mobs, in the correct slot)
Other items	Given to the nearest entity (mainhand → offhand), or dropped if no entity or hands are full

Inspect Mode

Opens the Vacuum Gun’s inventory GUI, allowing you to manually add, remove, or rearrange items in the 5 inventory slots and 2 upgrade slots.

Upgrades

Similarly to the Resonance Scanner, the Vacuum Gun accepts only up to 2 Upgrades. Right now, it only supports the following upgrade types:

Upgrade	Effect
Overclocker	Reduces cooldown between actions (faster fire rate), but increases energy cost
Energy Storage	Increases internal battery capacity

Specifications

Setting	Default Value	Description
Capacity	200,000 E	Total energy storage (upgradeable)
Cost	50 E/action	Energy consumed per vacuum or blow action
Range	12 blocks	Maximum vacuum range
Cooldown	8 ticks	Time between actions (0.4 seconds, reducible w/ upgrades)

Look at the config file for more detailed settings and adjustments.

Crafting Recipes

Crafting Shaped