Perforce GameDev Ignore - Unreal, Unity, Godot, Blender, Maya, and more DCC tools (please comment with suggestions)

.p4ignore

## Universal P4IGNORE for Game Engine Projects
## Supports: Unreal Engine, Unity, Godot
## Optimized pattern usage based on Perforce P4IGNORE documentation

# The syntax for P4IGNORE files is not the same as Perforce syntax.
# Key differences from .gitignore:
# - A / at the start means "relative to this p4ignore file"
# - A / at the end means "directories only"
# - * matches substrings but NOT path separators (like P4 wildcard)
# - ** matches substrings INCLUDING path separators (like P4 "..." wildcard)
# - ! at the start excludes the file specification


###############################################################################
# Visual Studio Solution and Project Files
###############################################################################

# Ignore root Visual Studio solution files only (all engines generate these
# at root level; deeper .sln files in engine source may be legitimate)
/*.sln
/*/*.sln

# Visual Studio temp files (but exclude when .pdb is in a folder path)
.vs/
*.pdb
!*.pdb/
*.suo
*.opensdf
*.sdf
*.mdb
obj/
Obj/
*.vcxproj

# VS Code local workspace settings
# NOTE: Some teams version specific files in .vscode/ for shared config. 
# For example, you can add those lines as ! exclusions as below by uncommenting them 
.vscode/
# uncomment if you want to version these files for shared debug or build tools.
# !.vscode/launch.json
# !.vscode/tasks.json

# User-specific Visual Studio files
*.user
**/launchSettings.json
*.csproj.cache
*.csproj.nuget.*
*.csproj.AssemblyReference.cache
# Note: DO NOT ignore *.csproj.props - these are shared build configuration files
!*.csproj.props

# Built binaries and temporary build files
*.csprojAssemblyReference.cache

# Visual Studio database files
*.opendb
*.VC.db

###############################################################################
# Git Integration (if migrating from Git)
###############################################################################

.git/
.gitignore
.gitattributes
.gitmodules
.tgitconfig

###############################################################################
# JetBrains IDEs
###############################################################################

.idea/
!.idea/runConfigurations

###############################################################################
# VS Code
###############################################################################

*.code-workspace

###############################################################################
# Perforce Local Config
###############################################################################

.p4config
p4config.txt
.p4sync.txt

###############################################################################
# Python
###############################################################################

__pycache__/
*.pyc
*.egg-info/
.venv/

###############################################################################
# OS Generated Files
###############################################################################

.DS_Store
.DS_Store?
._*
Thumbs.db
Desktop.ini
ehthumbs.db
FileOpenOrder/

###############################################################################
# Xcode User Data (iOS/macOS builds - applies to all engines)
###############################################################################

*.xcworkspace/xcuserdata/
*.xcodeproj/xcuserdata/
*.xcodeproj/project.xcworkspace/xcuserdata/

###############################################################################
# Temporary / Misc
###############################################################################

*.tmp
*.temp
*.swp
*~

###############################################################################
# Mobile / Platform Build Artifacts
###############################################################################

*.apk
*.aab
*.ipa
*.dSYM.zip

###############################################################################
# Android Build Tools
###############################################################################

.gradle/

###############################################################################
# Firebase Crashlytics
###############################################################################

crashlytics-build.properties

###############################################################################
# AI / LLM Tools
###############################################################################

.mcp.json
.ai/

###############################################################################
# DCC Application Autosave and Temporary Files
# Using specific extensions and patterns to avoid catching legitimate files
# NOTE: Do NOT add a global *.bak pattern - Unreal Engine source contains
# legitimate .bak files (e.g., ICU ThirdParty). Use specific patterns below.
###############################################################################

# Blender - specific extensions only
*.blend1
*.blend2
*.blend@
untitled.blend

# Autodesk Maya
*.ma.swatches
*.mb.swatches
*_incrementalSave_*.ma
*_incrementalSave_*.mb
incrementalSave/
scenes/edits/

# Autodesk 3ds Max
*.max.bak
autoback/
MaxStart.max

# Cinema 4D
*.c4d.zip
*.c4d~

# Houdini
*.hip.bak
*.hipnc.bak
*.hiplc.bak

# ZBrush
*.ZTL.bak
*.ZPR.bak
QuickSave*

# Substance Painter/Designer
*.spp.bak
*.sbs.bak
*.sbsar.bak

# Adobe Creative Suite - full extensions to avoid false matches
*.psd~
*.ai~
*.indd~
*.fla~
*.aep~
*.prproj~
Adobe After Effects Auto-Save/
Adobe Premiere Pro Auto-Save/
Photoshop Temp*

# Audio Applications

# Pro Tools
*.ptx~
*.ptf~
Session File Backups/

# Reaper
*.rpp-bak
*.rpp~

# Logic Pro
*.logic/Alternatives/
*.logic/Backups/

# Cubase/Nuendo
*.cpr.bak
*.npr.bak

# Ableton Live
*.als~

# FMOD
*.fspro.bak
*.fspro~

# Wwise
*.wproj.bak
*.wsettings.bak

# General DCC patterns (specific directory names only)
.mayaSwatches/


###############################################################################
###############################################################################
##                                                                           ##
##  UNREAL ENGINE                                                            ##
##                                                                           ##
###############################################################################
###############################################################################

###############################################################################
# Unreal Engine - Core Ignores
###############################################################################

# Samples, FeaturePacks, Templates at root only
/Samples/
/*/Samples/
/FeaturePacks/
/*/FeaturePacks/
/Templates/
/*/Templates/
# Saved and Intermediate directories (generated content)
# These can be at any depth, so use **/
/Saved/
**/Saved/
/Intermediate/
**/Intermediate/

# Derived Data Cache - use specific patterns to avoid matching source code
**/DerivedDataCache/Boot.ddc
**/DerivedDataCache/**/*.udd
**/DerivedDataCache/
/DerivedDataCache/
!**/Source/**/DerivedDataCache/

# Unreal-specific workspace configuration
.ue4dependencies

# Crash reports
crashinfo--*

# Linux project files (generated by UBT)
*.pro
*.pri
*.kdev4

# Obj-C/Swift specific
*.hmap
Binaries/**/*.dSYM
Binaries/**/*.dsym

# UGS folder (per-workspace)
.ugs/

# Local builds
/LocalBuilds/
!ArchiveForUGS-Perforce/

###############################################################################
# Unreal Engine - Engine-Specific Paths
# Use **/ prefix so these work whether Engine is at root or nested
###############################################################################

# UnrealBuildTool logs and configuration
Engine/Programs/UnrealBuildTool/*.txt
Engine/Programs/UnrealBuildTool/Log*.json
Engine/Programs/UnrealBuildTool/Log*.uba
*.uatbuildrecord

# Build receipts
Engine/Build/Receipts/

# C# program intermediates and saved folders
Engine/Source/Programs/*/obj/
Engine/Programs/*/Saved/

# build artifacts
*.deps.json
*.runtimeconfig.json
**/bin/**/ref/

# Exceptions for build artifacts
!Engine/Binaries/ThirdParty/**/*.deps.json
!Engine/Binaries/ThirdParty/**/*.runtimeconfig.json
!Engine/Binaries/DotNET/**/*.deps.json
!Engine/Binaries/DotNET/**/*.runtimeconfig.json

# Test coverage files
.msCoverageSourceRootsMapping_*
CoverletSourceRootsMapping_*

# Documentation tools output
Engine/Binaries/DotNET/UnrealBuildTool.xml
Engine/Binaries/DotNET/AutomationScripts/BuildGraph.Automation.xml

# Version files created by UBT
Engine/Binaries/**/*.version

# Export files (linker-generated, not source)
Engine/Binaries/**/*.exp

# Swarm local save files
Engine/Binaries/DotNET/SwarmAgent.DeveloperOptions.xml
Engine/Binaries/DotNET/SwarmAgent.Options.xml

# HoloLens WMRInterop autogenerated files
Engine/Source/ThirdParty/WindowsMixedRealityInterop/packages/
Engine/Source/ThirdParty/WindowsMixedRealityInterop/MixedRealityInteropHoloLens/Generated Files/
Engine/Source/ThirdParty/WindowsMixedRealityInterop/MixedRealityInteropHoloLens/x64/
Engine/Source/ThirdParty/WindowsMixedRealityInterop/MixedRealityInteropHoloLens/ARM64/
Engine/Source/ThirdParty/WindowsMixedRealityInterop/MixedRealityInterop/x64/
Engine/Source/ThirdParty/WindowsMixedRealityInterop/MixedRealityInterop/ARM64/


###############################################################################
###############################################################################
##                                                                           ##
##  UNITY ENGINE                                                             ##
##                                                                           ##
###############################################################################
###############################################################################

###############################################################################
# Unity - Generated Folders
###############################################################################
# These are entirely regenerated by Unity when the project is opened.

# Asset import cache, compiled scripts, shader cache (~2-5GB typically)
Library/
library/

# Runtime temporary files (exists only while Unity Editor is running)
Temp/
temp/

# Editor and shader compiler logs (regenerated each session)
Logs/
logs/

# Per-user editor preferences, layouts, and search indices
UserSettings/
usersettings/

###############################################################################
# Unity - Build Output
###############################################################################
# Unity lets you choose your build output path. These are common conventions.
# If your output goes elsewhere, add that path here.
#
# WARNING: Do NOT move Build/ to the common section. In Unreal, the Build/
# directory contains platform-specific configuration (Android signing, iOS
# entitlements, etc.) that MUST be versioned. These patterns are safe here
# because they only match root-level directories which don't conflict with
# Unreal's project structure.
#
# RECOMMENDED: For QA builds in Perforce, consider storing them in a separate
# depot or stream with an import+ path so developers only sync on demand.

/Build/
/build/
/Builds/
/builds/

*.unitypackage

###############################################################################
# Unity - Profiler & Diagnostics
###############################################################################

MemoryCaptures/
memorycaptures/

# Unity crash report file
sysinfo.txt

###############################################################################
# Unity - IDE & Project Files
###############################################################################

# MonoDevelop / Xamarin Studio
.consulo/

# Unity-generated C# project files (regenerated via Assets > Open C# Project)
# Root-anchored so they don't catch legitimate .csproj files in engine source.
/*.csproj
*.unityproj

# MonoDevelop-specific preference and debug files
*.userprefs
*.pidb
*.booproj
*.svd

# Meta files for debug symbols (orphaned when the symbols above are ignored)
*.pidb.meta
*.pdb.meta
*.mdb.meta

# Unity OBJ export directory
ExportedObj/

###############################################################################
# Unity - Addressables Build Artifacts
###############################################################################
# The Addressables source configuration (Assets/AddressableAssetsData/) is
# versioned, but the binary build output is regenerated and should be ignored.

**/Assets/AddressableAssetsData/*/*.bin*
**/Assets/StreamingAssets/aa.meta
**/Assets/StreamingAssets/aa/

# Lowercase variants for cross-platform safety
**/assets/AddressableAssetsData/*/*.bin*
**/assets/streamingassets/aa.meta
**/assets/streamingassets/aa/

###############################################################################
# Unity - Plugin / Tool Generated Files
###############################################################################

# JetBrains Rider plugin files auto-installed by Unity
Assets/Plugins/Editor/JetBrains*

# Asset Store Tools (downloaded on demand, not project content)
**/Assets/AssetStoreTools/

# Unity Collaborate artifact (legacy, before Plastic/P4)
.collabignore


###############################################################################
###############################################################################
##                                                                           ##
##  GODOT ENGINE                                                             ##
##                                                                           ##
###############################################################################
###############################################################################

# Godot 4+ specific ignores
.godot/
.nomedia

# Godot-specific ignores
.import/
export.cfg
export_credentials.cfg
*.tmp

# Imported translations (automatically generated from CSV files)
*.translation

# Mono-specific ignores
.mono/
data_*/
mono_crash.*.json