Please report any bugs in the comments or on the TaCZ community forum; I have a thread open there.

TaCZ: Immersive Ballistic

A mod designed to enhance the visual and auditory realism of Timeless and Classics Zero (TaCZ).
Building on the framework of TaCZ Tweaks, it offers a more immersive combat experience thanks to improved responsiveness and greater interaction with the environment.

Make sure you have this mod and its /tacz/immersive_ballistic file on both the client and the server

Key Features

The mod focuses on adding realistic ballistic impact particles that react dynamically to the surface hit:

• Visual Effects: Dust and debris particles for dirt, sand, concrete, and organic materials.
• Impact Smoke: Subtle smoke trails and puffs upon projectile impact.
• Metal Sparks: Detailed spark effects when striking metallic surfaces.
• Extended Variety: Custom visual systems tailored to various in-game materials.

Synergy with TaCZ Tweaks

When used alongside TaCZ Tweaks, additional layers of audio immersion are unlocked:

• Atmospheric projectile sounds (Whizz and Flyby).
• Block-specific impact sound effects.
• Ricochet sounds and more.

Mod Compatibility

This mod automatically generates tags within the TaCZ files. This is the primary method for filtering and identifying blocks from other mods, ensuring that custom particles and sounds work seamlessly with third-party content.

---

Customization

Immersive Ballistic is customizable. Everything — particles, sounds, bullet interactions, block tags — lives in a datapack at /tacz/immersive_ballistic/ that you can freely edit or extend.

This mod is built entirely on the TaCZ Tweaks datapack format. Before creating or editing any content, you must read the TaCZ Tweaks Wiki to understand how packages, JSON files, targets, sounds, and particles work.

Adding ammo from other mods.

Open <gamedir>/config/immersive_ballistic/ammo_rules.json and add your ammo IDs to the right category:

{
  "categories": {
    "rifle":   ["tacz:556x45", "yourmod:your_rifle_ammo"],
    "sniper":  ["tacz:338"],
    "shotgun": ["tacz:12g"],
    "hcal":    ["tacz:50bmg"]
  }
}

Any ammo not listed here will automatically use the generic fallback rules — so you only need to add ammo if you want it to behave like a specific category.

Excluding non-firearm ammo

Some modded weapons (bows, crossbows, flamethrowers, etc.) may fire projectiles that get picked up by the mod. To exclude them from all interactions and particles, add their ammo IDs to _ignore:

"_ignore": ["tacz_id:arrow_bolt", "tacz_id:flamethrower_fuel", "tacz:40mm"]

Disabling pierce or block breaking

Open immersive_ballistic-common.toml and set:

[bullet_interactions]
    disableBreakBlocks = false   # set true to disable block breaking globally
    disablePierceBlocks = false  # set true to disable bullet penetration globally

Applying changes in-game
After editing any config file, run both commands in order:
/imball reload - wait
/tacz reload
Or restart the game. Both steps are always required.

⚠️ Server + client must have identical configs and datapack files. Mismatches can cause crashes or unexpected behavior.

Full documentation

For advanced configuration, custom datapacks, and the full block tag system — see the Immersive Ballistic Guide

You are free to include this mod in your modpacks. Providing credit in the description is greatly appreciated. 😅