Flake Bodybag

Overview

Flake Bodybag is a comprehensive death-handling system designed for serious roleplay servers. It allows players and admins to bag deceased characters, place them in coffins, bury them at designated sites, or dump them into the ocean — with full character-kill (CK) backup and restoration support.

What It Does

• Bodybagging — Place dead players into a physical bodybag prop with progress-bar animations.
• Coffin Placement — Transfer a bodybagged player into a weighted coffin prop for transport.
• Burial — Bury bodybagged players at configured cemetery locations with shovel animations.
• Ocean Dumping — Push coffins into the water at pier locations for permanent disposal.
• Character Kill (CK) — Admins can permanently kill a character with full database backup.
• UnCK Restoration — Restore previously CKed characters from backup with one command.
• Gulag Integration — Optional compatibility with Flake Gulag for alternative sentencing.

Requirements

Installation

Step 1 — Drop the Resource

Place the flake_bodybag folder into your server's resources directory and add to server.cfg:

Step 2 — Database

The script auto-creates the ck_backup table on resource start. No manual SQL is required. Ensure oxmysql is running before flake_bodybag.

Step 3 — Add Items

Add the following items to your inventory configuration if you want item requirements:

• Bodybag — Required to bag a dead player (configurable).
• Coffin — Required to place a bodybagged player into a coffin (configurable).
• Shovel — Required to bury a body at a cemetery (configurable).

Step 4 — Configure

Edit config/config.lua to match your framework, target system, and desired features.

File Structure

flake_bodybag/
├── client/
│   └── client.lua       -- Client logic, animations, target zones
├── server/
│   └── server.lua       -- Server logic, CK backup, database I/O
├── config/
│   ├── config.lua       -- Main settings (escrow-ignored)
│   ├── edits.lua        -- Notifications and TextUI (escrow-ignored)
│   └── dumpbury.lua     -- Locations and animations (escrow-ignored)
└── fxmanifest.lua   -- Resource manifest

Configuration

All configuration files are escrow-ignored and safe to modify.

Framework Settings

Items

Props

Locations

Burial and dump sites are configured in config/dumpbury.lua. Each location supports:

• coords — vec3(x, y, z)
• radius — Zone radius for detection
• pedModel — (dump only) NPC model for handoff
• waitTime — (dump only) Delay before pickup
• label — Display name for the location

Discord Logging

All CK, bury, dump, and UnCK actions are logged to a configurable Discord webhook. Set Config.Logs.enable to true and provide your webhook URL.

Usage

Bodybagging a Player

1. Approach a dead player.
2. Use your target system or press E (TextUI) to initiate bodybagging.
3. Complete the progress-bar animation.
4. The dead player is placed inside a bodybag prop and hidden from view.

Placing in a Coffin

1. Approach a bodybagged player.
2. Select Place in Coffin from the target menu.
3. Complete the animation to replace the bodybag with a coffin prop.

Burying a Body

1. Carry or drag the bodybag to a burial site (marked on the map if blips are enabled).
2. Use the target option or press E to begin burying.
3. If configured, you must have a shovel in your inventory.
4. Complete the digging animation to finish the burial.

Dumping in the Ocean

1. Transport the coffin to a dump pier (marked on the map if blips are enabled).
2. Use the target option or press E to push the coffin into the water.
3. The coffin is deleted and the player is permanently removed.

Features

Character Kill (CK) System

• Full Backup — Character data, inventory snapshot, vehicles, and metadata are saved to ck_backup.
• Safe Deletion — The player is kicked first, then character and vehicle rows are deleted from the framework tables.
• Discord Audit — Every CK is logged with admin name, victim name, identifiers, and timestamp.
• Funeral Broadcast — A breaking-news announcement is shown to all online players.

UnCK Restoration

• Use /unck to open a searchable list of all CKed characters.
• Select a character and confirm restoration.
• Character data and vehicles are reinserted into the framework tables.
• The backup entry is deleted after successful restoration.

Ambulance Compatibility

• Wasabi Ambulance
• AK47 AmbulanceJob (ESX & QB)
• QB-AmbulanceJob (metadata & state bags)
• Native ped death checks (fallback)

Gulag Integration

If flake_gulag is installed and Config.GulagScript is enabled, burying or dumping will send the player to the gulag instead of deleting their character.

Commands

Troubleshooting