Home›Java›Mods›Untitled Physics
Untitled Physics
ModsJava

Untitled Physics

Java mod listed for Minecraft 1.21. Downloads from the MC Java Mods app on Android.

by kyoto482 · on Modrinth

Server-side 3D rigid-body physics engine and developer API using Display Entities, exact VoxelShape hitboxes, mechanical joints, and region conversion.

⬇ Download on Modrinth

Untitled Physics

Real-time 3D rigid-body physics engine and developer API for Paper 1.21.4 servers — powered by native Display Entities with zero client mods or resource packs required.

Minecraft 1.21.4 Loaders Java 21 Client Locales


What is Untitled Physics?

Untitled Physics brings true server-side 3D rigid-body simulation to Paper 1.21.4+ without requiring players to install any client mods or resource packs. Every physical object is rendered through native Minecraft BlockDisplay, ItemDisplay, and TextDisplay entities paired with shape-fitted Interaction hitboxes and a jitter-free Split-Impulse Projected Gauss-Seidel (PGS) constraint solver.

It works out of the box in two modes:

  1. Standalone Server Plugin — convert structures into physical or destructible 3D objects, manipulate bodies with interactive physics wands, connect blocks with ropes/springs/hinges, and fine-tune 34 world reaction rules.
  2. Developer Library (UntitledPhysics.get()) — a clean, zero-NMS Java API for spawning custom multi-part 3D bodies, motorized joints, force fields, raycasts, and listening to physical collision/interaction events in your own plugins.

(Attach Showcase GIF 5–8 sec / Прикрепить короткую GIF-анимацию 5–8 сек: взрыв ТНТ или выстрел Wind Charge рядом с выделенной постройкой в режиме breakable — блоки реалистично разлетаются, вращаются в 3D и плавно замирают на земле без дрожания)


Key Features

1. Exact VoxelShape Colliders & Hitboxes

No phantom full-cube air boxes around non-cubic blocks:

(Attach Screenshot / Прикрепить скриншот с включённым /untitled debug hitboxes: на земле лежат физическая дубовая ступенька, полублок, люк и наковальня — отчётливо виден каркас коллайдера точно по L-образной форме ступеньки)

2. 3D Region Conversion & Destructible Structures

Turn any building, tree, bridge, or statue into a physical 3D object:

(Attach Before/After Screenshot or GIF / Прикрепить GIF или 2 скриншота «До и После»: выделение небольшой башни рамкой Region Selector -> /untitled convert breakable -> попадание взрыва и обрушение конструкции)

3. Calibrated to Vanilla Minecraft 1.21.4 Constants

Simulation values are matched to real Minecraft mechanics rather than arbitrary numbers:

(Attach Screenshot or GIF / Прикрепить скриншот или GIF: деревянные ящики плывут по течению воды и подбрасываются колонной пузырей от песка душ, а тяжёлая наковальня лежит на дне)

4. Interactive Physics Wands

Run /untitled wand [all|gravity|selector|voxelizer|linker] to obtain:

5. Claim Protection, TPS Safety & 34 Reaction Flags

(Attach Screenshot / Прикрепить составной скриншот: слева — интерактивное меню /untitled reactions в чате, справа — режим /untitled debug со строкой телеметрии над хотбаром)


Requirements & Installation

  1. Drop Untitled.jar into your server's plugins/ folder and restart the server.
  2. Edit plugins/Untitled/config.yml and plugins/Untitled/messages.yml if desired (switch default language anytime with /untitled lang en or /untitled lang ru).
  3. Configure LuckPerms permissions if granting tools or commands to non-operators.

Commands & Permissions

Primary command: /untitled (aliases: /uphysics, /uphys, /up).

Command Permission Description
/untitled spawn <box|sphere|capsule|item|text> ... untitled.command.spawn Spawn a physical 3D Display body
/untitled wand [all|gravity|selector|voxelizer|linker] untitled.command.wand Give interactive physics wand tools
/untitled selwand / pos1 / pos2 / selclear untitled.command.region Select or clear a 3D region
/untitled convert [compound|breakable] [cut|keep] untitled.command.region Convert selected structure into a compound or breakable body
/untitled voxelize [radius] [compound|breakable] untitled.command.region Convert blocks around your crosshair into 3D physics
/untitled reactions [list|toggle|enable|disable|body|ignore|reset] untitled.command.reactions Configure all 34 physics reaction flags
/untitled debug [toggle|all|off|actionbar|particles|hitboxes|contacts|velocity|joints] untitled.command.debug Toggle real-time 3D particle & ActionBar debugger
/untitled gravity <default|entity|earth|moon|zero|invert | x y z> untitled.command.sim Change world gravity vector
/untitled explode [strength] [radius] / pause / step [ticks] untitled.command.sim Trigger shockwave, pause simulation, or step ticks manually
/untitled stats untitled.command.stats View world body counts, contacts, and step time (ms)
/untitled clear untitled.command.clear Remove all physics bodies in the current world
/untitled lang [code] / /untitled reload untitled.command.lang / .reload Switch active locale or hot-reload config.yml & messages.yml

Additional Permission Nodes:


Developer API Quickstart

Add depend: [Untitled] to your plugin.yml and compile against Untitled.jar:

dependencies {
    compileOnly("io.papermc.paper:paper-api:1.21.4-R0.1-SNAPSHOT")
    compileOnly(files("libs/Untitled-1.0.0.jar"))
}
import dev.untitled.physics.api.PhysicsEngine;
import dev.untitled.physics.api.UntitledPhysics;
import dev.untitled.physics.body.PhysicsMaterial;
import dev.untitled.physics.body.RigidBody;
import dev.untitled.physics.config.PhysicsReactionFlag;
import dev.untitled.physics.dynamics.joint.HingeJoint;
import dev.untitled.physics.math.Vec3;
import org.bukkit.Location;
import org.bukkit.Material;
import org.bukkit.util.BoundingBox;

public void spawnMechanism(Location loc) {
    PhysicsEngine engine = UntitledPhysics.get();

    // 1. Spawn a block body with automatic VoxelShape compound collider & fitted Interaction hitboxes
    RigidBody stairs = engine.spawnBlockBody(
        loc, Material.OAK_STAIRS.createBlockData(), Vec3.ONE, PhysicsMaterial.WOOD
    );

    // 2. Attach a motorized HingeJoint (revolving door, windmill, drawbridge)
    HingeJoint hinge = new HingeJoint(stairs, null, Vec3.fromLocation(loc), Vec3.UNIT_Y)
        .enableMotor(3.0, 100.0);
    engine.getWorld(loc.getWorld()).addJoint(hinge);

    // 3. Convert a 3D world BoundingBox into a greedy-meshed compound body
    engine.convertRegionToCompoundBody(loc.getWorld(), new BoundingBox(0, 64, 0, 6, 70, 6), true);

    // 4. Override individual reaction flags per body
    stairs.reactions().set(PhysicsReactionFlag.EXPLOSION_SHOCKWAVE, false);
}

Custom Bukkit Events (dev.untitled.physics.api.event):


Quick facts

Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.

File checked by MCModsHub

These come from our own check of the pack file, not from the source page.

Explore more