Usage Guide

How It Works

1. Player Disconnects — System captures player data and appearance
2. Body Spawns — Ghost body appears at disconnect location in sleeping pose
3. 3D UI — Floating UI appears above body when you get close
4. Press E — Dismiss closest log and copy info to clipboard
5. Auto-Cleanup — Body and log deleted after configured timeout

Player Experience

Approaching a Combat Log

When you get near a disconnected player's location:

• Ghost Body — Semi-transparent body in sleeping pose
• Green Smoke — Particle effect at body location
• 3D UI — Floating card above body with player info
• Green Border — Closest log has green border

Multiple Combat Logs

When multiple players disconnect nearby:

• Each body has its own 3D UI
• UIs automatically separate to avoid overlap
• Closest log to you has green border
• Press E dismisses only the closest one

Dismissing a Log

1. Approach the body (within 3.5m by default)
2. Press E key
3. Info is copied to clipboard
4. Body and UI disappear for you only
5. Other players can still see it

Copied info includes:

• Disconnect reason
• Server ID
• Discord ID

Self-Hiding Feature

If you disconnect and reconnect quickly:

• You won't see your own body
• Other players will see your body normally
• This prevents confusion when reconnecting

Information Displayed

In 3D UI

• Player Name
• Server ID
• Discord ID (if available)
• FiveM ID (if available)
• Steam ID (if available)
• Disconnect Reason
• Disconnect Time

In Discord Webhook

All above info PLUS:

• License ID (never shown in UI)
• Exact coordinates
• Timestamp
• Color-coded embed by reason

Disconnect Reasons

The system automatically detects and categorizes:

• Kicked 👢 — Player was kicked
• Banned 🔨 — Player was banned
• Crash 💥 — Game crashed
• Exiting 🚪 — Normal disconnect
• Timeout ⏱️ — Connection timeout
• Unknown ⚠️ — Other reasons

Controls

Tips

• Bodies are visible from far away (100m by default)
• Get close to see the 3D UI (3.5m by default)
• Green border indicates which log you'll dismiss
• Bodies auto-delete after timeout (2 minutes by default)
• You can walk through bodies (ghost mode)
• Vehicles can drive through bodies

Admin Usage

Monitoring

• Check Discord webhook for complete logs
• All player identifiers included
• Coordinates for teleporting
• Timestamps for evidence

Evidence Collection

When you dismiss a log:

• Info is copied to clipboard
• Paste in admin chat or ticket
• Includes reason, Server ID, Discord ID

Tracking Patterns

Discord logs help identify:

• Repeat combat loggers
• Crash patterns
• Network issues
• Rule violations