Requires: TaCZ Tweaks This mod acts as a configuration layer and particle provider on top of TaCZ Tweaks.

How it works

Immersive Ballistic does two things:

  1. Adds custom bullet impact particles based on the block material hit (wood, stone, metal, glass, etc.)
  2. Deploys a TaCZ Tweaks datapack into the tacz/ folder of your game, which defines how bullets interact with blocks (piercing, breaking, ammo categories, etc.)

It does not rewrite how TaCZ works. It only provides the data files that TaCZ Tweaks reads.

On startup, the mod:

  1. Reads the .toml and decides whether to copy or overwrite the datapack files in tacz/
  2. Applies the transforms from ammo_rules.json (injects ammo IDs into the correct files)
  3. Regenerates block tags via block_tagger_rules.json
  4. TaCZ Tweaks reads all of that and applies the rules in gameplay

⚠️ Critical: Config and datapack files must be exactly identical between client and server. Mismatches can cause desyncs, crashes, or incorrect behavior.

Configuration files

<gamedir>/config/immersive_ballistic/
├── immersive_ballistic-common.toml   ← main switches
├── ammo_rules.json                   ← ammo category mapping
└── block_tagger_rules.json           ← block tag generator rules

<gamedir>/tacz/immersive_ballistic/   ← deployed datapack (auto-managed)

TOML — main switches