BS Crime Scene Cleaner Multiplayer Job
In-Game Management

In-Game Management Tools

BS Crime Scene Cleaner Multiplayer Job includes two powerful, zero-downtime administrative suites that allow server staff to configure crime scenes, place minigame tasks using an interactive 3D gizmo, test tasks live in-game, and manage server-wide bonus multiplier events entirely in-game.

🛠️ Scene Manager (/csctaskmanager)

The Scene Manager is an in-game tool that allows administrators to create new crime scenes, configure interior MLOs, place forensic cleanup tasks using an interactive 3D gizmo, and test them live with a single click.

Command Requirement: Requires the crimescenecleanerjob.admin ACE permission (configured via serverConfig.adminPermission, default group.admin).

1. Main Menu Overview

Typing /csctaskmanager in the chat or console opens the main administrative context menu:

  • Create New Scene: Prompts for a scene identifier and records the admin's current ped coordinates as the initial center point.
  • Existing Scenes List: Displays every registered crime scene in data/scenes.json alongside its total task count.

2. Managing an Existing Scene

Selecting any scene from the list provides the following options:

OptionFunction
Edit SceneOpens the task list for that scene to add, edit, or remove specific minigames
Teleport to SceneInstantly teleports the admin to the center coordinates (or MLO entrance) of the scene
Debug Load SceneSpawns and activates all tasks for that scene immediately for live testing
Stop Debug SceneCleans up and unloads all debugged task instances from the world
Delete SceneDeletes the scene and all of its tasks from data/scenes.json (requires confirmation)

3. Adding Tasks with the 3D Visual Task Creator

When you choose Add New Task inside a scene, you select one of the available task types:

  1. clean_blood (Blood pool or wall handprint)
  2. collect_evidence (Crime scene evidence with collection bag)
  3. hack_alarm (Security alarm terminal bypass)
  4. rearrange_furniture (Overturned furniture recovery)
  5. remove_cctv (Surveillance camera bracket & memory drive)
  6. body_outline (Forensic chalk body silhouette)

Upon selection, the script launches the 3D Task Creator:

  • Raycast & Surface Snapping: Move your cursor over floors or walls. Press C to toggle Surface Snap (On / Off). The prop automatically detects wall angles and aligns its rotation perpendicular to the surface.
  • Multi-Step Placement for Complex Tasks:
    • Rearrange Furniture:
      • Step 1 (Target Position): Position the furniture at its final, upright spot where it belongs.
      • Step 2 (Knocked Position): Press Space to transition to Step 2. Position the overturned/knocked-down furniture where the cleaner will find it. A holographic blue ghost outline displays the target spot.
    • Collect Evidence:
      • Step 1 (Evidence Position): Place the weapon, phone, or casing on the floor/desk.
      • Step 2 (Bag Position): Press Space to spawn the evidence zip bag (prop_brusie_zipbag). Move the mouse to rotate the bag angle around the evidence and use the scroll wheel to adjust distance.
  • Visual Controls HUD: The modern NUI shortcuts panel in the bottom-right corner provides real-time button prompts for rotation, height adjustments (E / Q), camera controls, and speed modifiers (Shift / Ctrl).
  • Confirm Placement: Press Space to save the task. The server automatically updates data/scenes.json.

4. Live Testing with "Debug Load Scene"

You do not need to assemble a crew or start an active job shift to test your task placements!

  1. Select Debug Load Scene on any scene.
  2. The scene's props, target zones, and minigames immediately spawn in the world.
  3. Approach any task and interact with it to play the minigame and verify camera angles, animations, and lighting.
  4. When finished, select Stop Debug Scene to despawn all debug entities cleanly.

💰 Bonus Manager (/cscbonusmanager)

The Bonus Manager lets administrators run promotional multiplier events (e.g., Double XP, +50% Payout Weekends) on the fly without restarting the server or editing config files.

Command Requirement: Requires the crimescenecleanerjob.admin ACE permission (configured via serverConfig.adminPermission, default group.admin).

1. Instant Bonus

Activate a global bonus that starts immediately:

  1. Choose Instant Bonus in the menu.
  2. Percentage: Enter the bonus percentage (e.g., 50 for a +50% payout/XP boost).
  3. Duration: Enter the duration in minutes (e.g., 120 for 2 hours).
  4. The bonus is instantly saved to the bs_crimescenecleaner_bonuses table and broadcasted in real time to all connected players (globalBonusMultiplier).

TIP: To immediately disable all active instant bonuses, set the percentage to 0.

2. Scheduled Bonus

Plan ahead for scheduled weekend or holiday community events:

  1. Choose Schedule Bonus.
  2. Percentage: Enter bonus percentage (e.g., 100 for 2x payouts).
  3. Start Date & Time: Pick the start date (YYYY-MM-DD) and start time in 24-hour format (HH:MM).
  4. End Date & Time: Pick the expiration date and time.
  5. A server-side background thread checks active bonuses every 30 seconds. When the current clock reaches start_time, the multiplier automatically activates across the server. Once end_time passes, it cleanly deactivates.

3. View Active & Scheduled Bonuses

  • Review all ongoing and planned bonuses.
  • Each entry displays its status:
    • ACTIVE (Currently boosting payouts)
    • SCHEDULED (Pending future activation)
    • EXPIRED (Completed)
  • Select any active or scheduled bonus to cancel it with one click.

Cleaners see their active bonus multiplier directly on their dashboard home tab!

Tasks & MinigamesFAQ