The physgun, a gold lattice frame around a glowing blue core with a grey barrel, beside the word Physics

Nomad Physics

A free Hytale gravity gun and physgun for rigid-body props that fall, roll and collide. The Hytale physics mod the packs build on, with an API for other mods.

A player aims the physgun at a wooden crate held in the air, with a blue brick wall and a red block on the sand.

A player with the gravity gun raised as a large red block tumbles through the air beside a red brick wall.

Wooden crates tumbling at different angles in the air above a flat sand plain.

A long red brick wall with a gap in it and loose red blocks scattered on the sand in front.

What you get

Nomad Physics is a Hytale physics mod that gives a server a gravity gun and a physgun. Props fall, roll and collide with the world, simulated on the server, so players join with the ordinary Hytale client.

Rigid-body physics for props. Props fall, roll and collide with the world, with ode4j running the simulation on the server. Players do not need a client mod.
Physgun. Grab the prop under your crosshair and carry it where you aim. It can carry heavy objects without the gravity gun's mass limit, and it can freeze and rotate props.
Gravity gun. Pull a prop toward you and hold it, then drop it or punt it away. It has a shorter reach and a carry mass limit.
A wooden crate and three demo blocks: Rubber, Steel and Slick.
An API for other plugins. PhysicsApi lets other mods use the same physics, including content packs such as Bowling and War Games.

Install

Put NomadPhysics.jar in your server's mods folder and restart the server. The jar includes its assets.
When upgrading, replace the previous Nomad Physics jar so only one copy is installed.
In an open area, as a server operator, run /physics tool physgun, /physics tool gravgun and /physics demo crates.

The tools have no crafting recipes. Give one to another player with /physics tool physgun --player=PlayerName or /physics tool gravgun --player=PlayerName; the recipient must be in the same world as the command.

Rubber, Steel and Slick

Find the demo blocks in the creative catalog under Blocks > Build, or use /give <player> <ItemId>.

Item	Item ID	Behaviour while loose
Rubber Block	`Nomad_Demo_Rubber`	Bounces on solid terrain, each bounce losing height until it stops
Steel Weight	`Nomad_Demo_Steel`	Four times the ordinary block mass, so the same impulse moves it less
Slick Block	`Nomad_Demo_Slick`	Slides farther than an ordinary loose block; when placed, players slide across it like ice

Packs built on it

Nomad Physics is the free core. Content packs such as Bowling and War Games use it through PhysicsApi. Each pack goes through the public API and needs this core installed.

Known limits

Per-world body cap. Every prop counts towards a per-world cap, and spawnBody returns null at the cap.
Mods' own entities. Another mod's entities need that mod to register an integration before the guns can take control of them.
Creatures. They can be picked up only when creature handling is enabled; their AI pauses while physics controls them and resumes after release.
Water. Bodies configured with a buoyancy density can float; bodies without buoyancy sink.
Ordinary props too heavy to lift with the gravity gun can still receive a weaker shove.

Guide

Using the gravity gun and physgun Every mouse and key binding for the physgun and gravity gun, and how block mode works.
Permissions The permission nodes that gate each tool and block pickup.
Configuration What each section of config.json changes.
Operator commands The /physics commands for inspecting and resetting the simulation.
For plugin authors How another server plugin builds against PhysicsApi.

Before you install

Version history: changelog.
Support: nomad-labs.co/support. Include the output of /physics status and the log lines around any error.

Questions

Do players need to install anything?

No. The simulation runs on the server, and players do not need a separate client mod.

How do I give a player the physgun or gravity gun?

The tools have no crafting recipes. Run /physics tool physgun or /physics tool gravgun as an operator, adding --player=PlayerName to give one to another player in the same world. The player also needs the matching permission, nomadphysics.physgun or nomadphysics.gravitygun.

How is the Hytale physgun different from the gravity gun?

The physgun grabs the prop under your crosshair and carries it where you aim, without the gravity gun's mass limit, and it can freeze and rotate props. The gravity gun pulls a prop toward you and holds it, then drops it or punts it away, with a shorter reach and a carry mass limit.

Can the guns pick up blocks and mobs?

Blocks, yes: press F with a gun equipped and nothing held to toggle block mode, and the server's Blocks settings decide which block types can be picked up. Mobs and animals can be picked up when creature handling is enabled in the config.

What are the Rubber, Steel and Slick blocks?

Three demo blocks in the free core. Rubber bounces, Steel has four times the ordinary block mass, and Slick slides farther while loose and acts like ice underfoot when placed.

Can other plugins use it?

Yes. Other server plugins use the physics through PhysicsApi, and content packs such as Bowling and War Games are built on it. The free core is required for them.

How do I update it?

Replace the previous Nomad Physics jar in your mods folder so only one copy is installed, then restart the server.

Also from Nomad Labs

Paid add-ons, each with its own page.

See every add-on