Skip to content

Add *.slnx to UnrealEngine.gitignore - #4907

Open
murnana wants to merge 1 commit into
github:mainfrom
murnana:upstream-unreal-slnx
Open

Add *.slnx to UnrealEngine.gitignore#4907
murnana wants to merge 1 commit into
github:mainfrom
murnana:upstream-unreal-slnx

Conversation

@murnana

@murnana murnana commented Sep 5, 2026

Copy link
Copy Markdown

Link to the application or project's homepage

Unreal Engine

Reasons for making this change

Visual Studio 2022 (v17.10+) introduced a new solution file format, .slnx, which serves the exact same role as the .sln file this template already ignores. Unreal Engine's UnrealBuildTool (UBT) generates IDE project files (.sln/.slnx, .vcxproj, etc.) from the project's .uproject and *.Build.cs files, and they can be regenerated at any time via "Generate Visual Studio project files" as long as the Source folder, Content folder, and .uproject file are present. These generated files are treated as intermediate build artifacts and may embed locally-mounted paths or personal environment settings, so — like .sln — they should not be shared between team members. This applies to every Unreal Engine developer using Visual Studio 2022 or later, not just a specific setup.

Links to documentation supporting these rule changes

  • Project Files for IDEs in Unreal Engine — states that IDE project files are treated as intermediate files under PROJECT_DIRECTORY\Intermediate\ProjectFiles, and must be regenerated if the Intermediate folder is deleted.
  • Unreal Build Tool in Unreal Engine — notes that the build process runs independently of IDE project files (.sln/.vcproj, etc.), so project files don't need to be synced between team members — only source files need to be synced, and project files can be rebuilt locally.

Merge and Approval Steps

UnrealBuildTool (UBT) auto-generates .slnx solution files the same
way it generates .sln/.vcxproj, based on the project's .uproject and
.Build.cs configuration. These generated files may contain
locally-mounted paths or personal dev environment settings, which can
cause conflicts when shared between team members. As with other
generated project files, they can be regenerated anytime via
'Generate Visual Studio project files' as long as the Source folder,
Content folder, and .uproject file are present.

Docs:
- https://dev.epicgames.com/documentation/en-us/unreal-engine/project-files-for-ides-in-unreal-engine
- https://dev.epicgames.com/documentation/en-us/unreal-engine/unreal-build-tool-in-unreal-engine
@murnana
murnana requested a review from a team as a code owner September 5, 2026 08:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant