Gravity Gun Mod Wiki

The Gravity Gun mod, created by iChun, is a functional recreation of the Zero Point Energy Field Manipulator from the Half-Life series. It introduces a high-tech tool capable of manipulating the physical properties of almost any entity or block in the Minecraft world. Whether used for defensive blasting, creative construction, or offensive projectile combat, the Gravity Gun provides a versatile set of mechanics that transform how players interact with their environment.

In versions 5.0.0 and above, the mod was completely rewritten to optimize physics interactions and introduce advanced features like multi-block grabbing and improved entity handling. The mod is primarily item-based and does not add new biomes, dimensions, or mobs, focusing instead on the manipulation of existing vanilla and modded content.

The mod adds two primary items, each with distinct power levels and visual aesthetics.

Gravity Gun

The standard version of the tool. It features an orange glow and is capable of picking up most standard entities (mobs, dropped items, primed TNT) and specific blocks defined in the configuration. It is the base tool used for general utility and defense.

Supercharged Gravity Gun

An unstable, blue-glowing variant of the tool. This version is significantly more powerful, capable of picking up almost any block (including those normally restricted) and pulling entities from much greater distances. It also possesses the unique ability to grab multiple blocks simultaneously.

The Gravity Gun operates using two primary fire modes. Understanding the interaction between these buttons is key to mastering the tool.

Primary Fire (Left Click)

• Blast: Creates a concentrated kinetic blast that pushes entities away with significant force.
• Projectile Conversion: Entities hit by the blast are launched as projectiles. If they collide with other entities or solid surfaces, they take fall damage and deal collision damage to the target.
• Release: If you are currently holding an object with the Secondary Fire, clicking the Primary Fire will launch that object forward with high velocity.

Secondary Fire (Right Click)

• Pull: Holding the button will pull distant entities or eligible blocks toward the player.
• Grab: Once an entity or block is close enough, the Gravity Gun will lock onto it, suspending it in front of the player.
• Drop: Pressing the Secondary Fire button again while holding an object will gently drop it in front of the player without launching it.

Advanced Multi-Block Grabbing

Exclusive to the Supercharged Gravity Gun, this mechanic allows players to lift entire sections of the terrain:

1. Hold Primary Fire: Perform a "dry fire" (do not hit any entities).
2. Hold Secondary Fire: While still holding Primary, hold Secondary to begin charging the grab radius.
3. Release Primary Fire: Once the desired radius is reached, release the Primary button. The gun will attempt to lift all blocks within the area. If the gun encounter blocks it cannot lift (based on config), the grab will fail.

The Supercharged Gravity Gun cannot be crafted directly through standard means in survival mode. Instead, it is created through an environmental interaction.

To obtain a Supercharged Gravity Gun, a player must have a standard Gravity Gun in their inventory and be struck by lightning. This event triggers a surge of energy that permanently transforms the tool into its blue, supercharged state.

Note: This process is dangerous as the lightning strike will still deal damage to the player unless they have appropriate protection or enchantments.

The standard Gravity Gun is an end-game tool requiring rare materials. The recipe is symmetrical and utilizes materials associated with technology and teleportation.

Gravity Gun Crafting Recipe

• Iron Ingots: 4
• Diamonds: 2
• Glowstone Dust: 2
• Ender Pearl: 1

The mod provides extensive configuration options via the gravigun.cfg file, allowing server administrators to balance the tool's power.

Block Interaction

By default, the standard Gravity Gun is restricted from picking up certain "heavy" or complex blocks (like Bedrock or certain tile entities). The Supercharged version ignores most of these restrictions.

Modder Integration: Developers can interact with the mod's logic to prevent or allow specific blocks from being grabbed using IMC (Inter-Mod Communication) messages.

• Key: addBlockIDToGrabList
• Value Format: id:meta, id:meta, id

Key Config Options

• grabmaniac: If enabled, the standard Gravity Gun can pick up any block, similar to the Supercharged version.
• reachDistance: Adjusts how far the gun can reach to pull entities.
• entityBlacklist: A list of entity IDs that the Gravity Gun is forbidden from interacting with (useful for preventing players from moving boss mobs like the Ender Dragon).