desktop6:MutablePackageDirectory

Article
10/30/2023

Specifies a folder under the %ProgramFiles%\ModifiableWindowsApps path where the contents of your desktop application's install folder are projected so that users can modify the installation files (for example, to install mods).

Note

This element is currently intended to be used only by certain types of desktop PC games that are published by Microsoft and our partners. It requires the modifiableApp restricted capability.

Element hierarchy

<desktop6:Extension>

<desktop6:MutablePackageDirectories>

<MutablePackageDirectory>

Syntax

<desktop6:MutablePackageDirectory
  Target = 'A string with a value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.' />

Attributes and Elements

Attributes

Attribute	Description	Data type	Required	Default value
Target	The name of a folder under the %ProgramFiles%\ModifiableWindowsApps path where the contents of your desktop application's install folder are projected so that users can modify the installation files (for example, to install mods). The folder name must be string valid for a folder name. Sub-folders in the folder name are not allowed (no / or \ characters). For more information, see Package.MutableLocation and Package.EffectiveLocation.	A string with a value between 1 and 256 characters in length that cannot contain these characters: `<`, `>`, `:`, `"`, `\|`, `?`, or `*`.	Yes

Child Elements

None.

Parent Elements

Parent Element	Description
desktop6:MutablePackageDirectories	Enables your desktop application to specify one or more folders where users can modify the installation files for your application (for example, to install mods).

Remarks

This element requires the modifiableApp restricted capability.

Examples

<Package
  xmlns:desktop6="http://schemas.microsoft.com/appx/manifest/desktop/windows10/6"
  xmlns:rescap="http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities" 
  IgnorableNamespaces="rescap desktop6">
 
  <!-- ... -->
  <!-- Other entries omitted for brevity. -->
  <!-- ... -->
 
  <Extensions> 
    <desktop6:Extension Category="windows.mutablePackageDirectories">
      <desktop6:MutablePackageDirectories>
        <desktop6:MutablePackageDirectory Target="ContosoGame"/>
      </desktop6:MutablePackageDirectories>
    </desktop6:Extension>
  </Extensions>
 
  <Capabilities>
    <!-- Include the required restricted capability. -->
    <rescap:Capability Name="modifiableApp"/>
  </Capabilities>
</Package>

Requirements

Item	Value
Namespace	`http://schemas.microsoft.com/appx/manifest/desktop/windows10/6`
Minimum OS Version	Windows 10 version 1903 (Build 18362)

Share via