In-Game Management Tools

BS Oil Field Multiplayer Job includes two powerful, zero-downtime administrative suites that allow server staff to configure sites, create tasks in 3D, test minigames, and manage server-wide bonus multiplier events entirely in-game.

🛠️ Task Manager (/oiltaskmanager)

The Task Manager is an in-game tool that allows administrators to create new oil field sites, place minigame tasks using an interactive 3D gizmo, and test them with a single click.

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

1. Main Menu Overview

Typing /oiltaskmanager in the chat or console opens the main management context menu:

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

2. Managing an Existing Site

Selecting any site from the menu provides the following options:

3. Adding Tasks with the 3D Visual Gizmo

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

1. Pipeline Cutting
2. Pipeline Flange Assembly
3. Rust Removal
4. Technical Box Repair
5. Valve Regulation
6. Pipeline Welding

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

• The corresponding 3D preview prop appears attached to a 3D positioning gizmo.
• Use your mouse and keyboard keys to translate (X, Y, Z) and rotate (pitch, roll, yaw) the prop into place against pipes, walls, or refinery machinery.
• Confirm placement to save the task.
• Automatic Center Recalculation: Whenever a task is added or removed, the server automatically recalculates the geographic center (site.center) of all tasks in the site and updates data/sites.json.

4. Live Testing with "Debug Load Site"

You don't need to gather crew members or start a job route to test your placements!

1. Select Debug Load Site on any site.
2. The site'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 and animations.
4. When finished, select Stop Debug Site to despawn all debug entities cleanly.

💰 Bonus Manager (/oilbonusmanager)

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 oilfieldjob.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_oilfield_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.

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