⚠️ Before reporting an issue.

Please note that this mod relies on the Tacz Tweaks mod to function.
Any mod or addon should work if it is compatible with the Tacz Tweaks mod.
If you believe it is an issue with this mod, please make sure it is specifically caused by this mod.

⚠️ THIS MOD ONLY CREATES VANILLA PARTICLES AND MANAGES CONFIGURATION FILES WITH TACZ TWEAKS TO MAKE IT COMPATIBLE WITH MORE BLOCKS AND WEAPON ADDONS FOR TACZ

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. 😅