💣Envi-Bomb-Defuse

Timed bombs with 3D defusal puzzles, strikes, spectators, and configurable outcomes

---

Prerequisites

• A working FiveM Server

• Basic understanding of FiveM server setup and resource management

• Followed the FIRST STEPS (READ FIRST) guide

• envi-bridge

• ox_lib

• Inventory items matching your bomb config

• The packaged UI files from your download

---

What this adds

Envi-Bomb-Defuse adds placeable timed bombs with a 3D defusal minigame.

Each bomb can have its own:

• timer

• strike count

• prop

• puzzle stack

• sounds

• spectator behavior

• explosion, fire, gas, or dud outcome

Core systems

• placeable bombs with configurable timers

• server-authoritative puzzle validation

• one active defuser at a time

• optional spectator mode

• synced sounds and indicators

• explosion, fire, gas, or dud outcomes

Install

1

Start the dependencies

Make sure envi-bridge, ox_lib, your inventory, and your target integration are running first.

2

Keep the packaged UI build

The in-game UI is served from the built frontend files.

If you edit the frontend source later, rebuild it before testing again.

3

Register your items

Add every enabled bomb item from Config.Bombs to your inventory.

Also add Config.ManualItem if you use the manual.

4

Check your props

If a bomb uses a custom prop, that prop must exist on your server.

Use Quick Start for the first setup pass.

Register these items

• one item for each enabled bomb in Config.Bombs

• your manual or kit item from Config.ManualItem

The default manual item is often bombs_manual.

Where you edit things

Most owners will work in:

• shared/config.lua

• the built UI bundle you ship with the resource

• any optional open hook files in your build if you use them

Docs in this section

• Quick Start

• Bomb Lifecycle and Networking

• Puzzle Modules

• Config Reference

• Commands and Debug

• Customization and Integration

• FAQ and Operations

Troubleshooting

• If the UI is blank, check the packaged UI files first.

• If a bomb will not arm, check the item name in config.

• If bomb audio seems missing, check whether you are actually inside the bomb zone.

• If the prop disappears at distance, that is normal local cleanup behavior.

• If defusal feels too easy or hard, adjust strikes, timer, puzzle count, and speed-up chance together.