Multi-Team Setup

DrDebug uses a shared Material Parameter Collection (MPC_DrDebug) and split texture directories to handle both Global Project Presets and Local User Presets.

To prevent checkout wars and protect your Perforce depot, DrDebug features an automatic "Admin Mode" toggle. By default, the tool operates in Artist Mode, which hides the Project Preset controls and silently saves local overrides without triggering Perforce checkout prompts.

As a Tech Director or Art Director, you must enable Admin Mode to establish the studio-wide baseline.

1. How to Enable Admin Mode (TDs Only)

To unlock the ability to save and submit Global Project Preset, you need to create a local admin token file on your machine.

1. Navigate to your project's plugin directory: [YourProject]/Plugins/DrDebug/Config/
2. Right-click and create a blank text file. Name it exactly: TD_Admin.txt
3. Restart the DrDebug UI Editor Mode (not the whole UE Editor).

You will now see the "Save Project Preset" button. When you click this, DrDebug will natively prompt you to check out MPC_DrDebug and the /ProjectPreset/Baked/ textures, and DA_Assets, so you can submit them to the Perforce depot and that'll be the project preset for your team to use.

2. The .p4ignore Rules (Critical)

Before deploying DrDebug to your team, you must add the following lines to your studio's .p4ignore file.

This ensures that your local Admin token never syncs to the artists, and that artist's local texture bakes never pollute the depot:

Plaintext

# ========================================================
# DrDebug Pipeline Rules
# ========================================================

# 1. Prevent Admin privileges from syncing to artists
*/Plugins/DrDebug/Config/TD_Admin.txt

# 2. Ignore local artist texture bakes
*/Plugins/DrDebug/Content/Baked/...

# 3. EXCEPTION: Allow the global Project Preset bakes to be versioned!
!*/Plugins/DrDebug/Content/Baked/project_preset/...

3. The Artist Workflow

Once the Admin establishes the baseline and submits the .p4ignore file, the rest of the team requires zero setup.

When an artist opens DrDebug, the tool will automatically detect that TD_Admin.txt is missing. It will hide the global override buttons and operate entirely locally. When an artist clicks "Save User Preset", DrDebug temporarily forces the files to be writable on the OS level, silently saving their custom presets without ever prompting them for a Perforce checkout to avoid any conflicts.