Nintendo Switch Brew

NACP: Difference between revisions

← Older edit
Added info from a GameShare S2 NACP, etc.
 
(38 intermediate revisions by 8 users not shown)
Line 1: Line 1:
This is '''control.nacp''', "nn::ns::ApplicationControlProperty".
Roughly equivalent to non-gfx areas of 3DS SMDH. All strings for language-entries are UTF-8, unlike SMDH which uses UTF-16.
Roughly equivalent to non-gfx areas of 3DS SMDH. All strings for language-entries are UTF-8, unlike SMDH which uses UTF-16.


Total size is 0x4000-bytes.
Total size is 0x4000-bytes.


=Structure=
= Structure =
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
Line 11: Line 13:
|-
|-
| 0x0
| 0x0
| 0x2D00 (0x300*15)
| 0x3000 (0x300 * 16)
| Language entries
| [[#ApplicationTitle|Title]]
|-
| 0x3000
| 0x25
| Isbn
|-
|-
| 0x2D00
| 0x3025
| 0x300
| 0x1
| Normally all-zero?
| StartupUserAccount
|-
|-
| 0x3000
| 0x3026
| 0x24
| 0x1
| Zeros?
| UserAccountSwitchLock
|-
|-
| 0x3024
| 0x3027
| 0x4
| 0x1
| ?
| AddOnContentRegistrationType
|-
|-
| 0x3028
| 0x3028
| 0x4
| 0x4
| ?
| AttributeFlag
|-
|-
| 0x302C
| 0x302C
| 0x4
| 0x4
| ?
| SupportedLanguageFlag
|-
|-
| 0x3030
| 0x3030
| 0x4
| 0x4
| ?
| ParentalControlFlag
|-
|-
| 0x3034
| 0x3034
| 0x4
| 0x1
| ?
| Screenshot
|-
| 0x3035
| 0x1
| [[#VideoCapture]]
|-
| 0x3036
| 0x1
| DataLossConfirmation
|-
| 0x3037
| 0x1
| [[#PlayLogPolicy]]
|-
|-
| 0x3038
| 0x3038
| 0x8
| 0x8
| Application titleID
| PresenceGroupId
|-
|-
| 0x3040
| 0x3040
| 0x20
| 0x20
| ?
| RatingAge
|-
|-
| 0x3060
| 0x3060
| 0x10
| 0x10
| Application version string, encoding unknown.
| DisplayVersion
|-
|-
| 0x3070
| 0x3070
| 0x8
| 0x8
| Base titleID for DLC, set even when DLC is not used. Usually app_titleID+0x1000?
| AddOnContentBaseId
|-
|-
| 0x3078
| 0x3078
| 0x8
| 0x8
| Application titleID
| SaveDataOwnerId
|-
|-
| 0x3080
| 0x3080
| 0x4
| 0x8
| ?
| UserAccountSaveDataSize
|-
| 0x3088
| 0x8
| UserAccountSaveDataJournalSize
|-
|-
| 0x3084
| 0x3090
| 0x4
| 0x8
| ?
| DeviceSaveDataSize
|-
|-
| 0x3088
| 0x3098
| 0x4
| 0x8
| ?
| DeviceSaveDataJournalSize
|-
|-
| 0x308C
| 0x30A0
| 0x24
| 0x8
| Zeros?
| BcatDeliveryCacheStorageSize
|-
|-
| 0x30B0
| 0x30A8
| 0x8
| 0x8
| Application titleID
| ApplicationErrorCodeCategory
|-
|-
| 0x30B8
| 0x30B0
| 0x38 (0x8*0x7)
| 0x40 (0x8 * 8)
| Array of application titleIDs, normally the same as the above app-titleIDs. Only set for game-updates?
| LocalCommunicationId
|-
|-
| 0x30F0
| 0x30F0
| 0x4
| 0x1
| ?
| LogoType
|-
| 0x30F1
| 0x1
| LogoHandling
|-
| 0x30F2
| 0x1
| RuntimeAddOnContentInstall
|-
| 0x30F3
| 0x1
| RuntimeParameterDelivery
|-
|-
| 0x30F4
| 0x30F4
| 0x4
| 0x1
| ?
| AppropriateAgeForChina
|-
| 0x30F5
| 0x1
| Reserved
|-
| 0x30F6
| 0x1
| CrashReport
|-
| 0x30F7
| 0x1
| Hdcp
|-
|-
| 0x30F8
| 0x30F8
| 0x8
| 0x8
| Application titleID. Only set for game-updates?
| SeedForPseudoDeviceId
|-
|-
| 0x3100
| 0x3100
| 0x41
| [[BCAT_Content_Container|BcatPassphrase]] (all-zero when unused)
|-
| 0x3141
| 0x1
| StartupUserAccountOption
|-
| 0x3142
| 0x6
| ReservedForUserAccountSaveDataOperation
|-
| 0x3148
| 0x8
| UserAccountSaveDataSizeMax
|-
| 0x3150
| 0x8
| UserAccountSaveDataJournalSizeMax
|-
| 0x3158
| 0x8
| DeviceSaveDataSizeMax
|-
| 0x3160
| 0x8
| DeviceSaveDataJournalSizeMax
|-
| 0x3168
| 0x8
| TemporaryStorageSize
|-
| 0x3170
| 0x8
| CacheStorageSize
|-
| 0x3178
| 0x8
| CacheStorageJournalSize
|-
| 0x3180
| 0x8
| CacheStorageDataAndJournalSizeMax
|-
| 0x3188
| 0x2
| CacheStorageIndexMax
|-
| 0x318A
| 0x1
| Reserved
|-
| 0x318B
| 0x1
| RuntimeUpgrade
|-
| 0x318C
| 0x4
| SupportingLimitedApplicationLicenses
|-
| 0x3190
| 0x80 (0x8 * 16)
| PlayLogQueryableApplicationId
|-
| 0x3210
| 0x1
| PlayLogQueryCapability
|-
| 0x3211
| 0x1
| RepairFlag
|-
| 0x3212
| 0x1
| ProgramIndex
|-
| 0x3213
| 0x1
| RequiredNetworkServiceLicenseOnLaunchFlag
|-
| 0x3214
| 0x1
| [20.0.0+] [[#ApplicationErrorCodePrefix|ApplicationErrorCodePrefix]]
|-
| 0x3215
| 0x1
| Reserved
|-
| 0x3216
| 0x1
| [20.0.0+] AcdIndex
|-
| 0x3217
| 0x1
| [20.0.0+] [[#ApparentPlatform|ApparentPlatform]]
|-
| 0x3218
| 0x198
| [[#ApplicationNeighborDetectionClientConfiguration|NeighborDetectionClientConfiguration]]
|-
| 0x33B0
| 0x10
| [[#ApplicationJitConfiguration|JitConfiguration]]
|-
| 0x33C0
| 0x40
| 0x40
| [[BCAT_Content_Container|BCAT]] passphrase, all-zero when unused.
| [[#RequiredAddOnContentsSetBinaryDescriptor|RequiredAddOnContentsSetBinaryDescriptor]]
|-
| 0x3400
| 0x1
| PlayReportPermission
|-
| 0x3401
| 0x1
| CrashScreenshotForProd
|-
| 0x3402
| 0x1
| CrashScreenshotForDev
|-
| 0x3403
| 0x1
| ContentsAvailabilityTransitionPolicy
|-
|-
| 0x3140
| 0x3404
| 0xEC0
| 0x4
| Normally all-zero?
| Reserved
|-
| 0x3408
| 0x40
| [[#AccessibleLaunchRequiredVersionValue|AccessibleLaunchRequiredVersion]]
|-
| 0x3448
| 0x89
| [20.0.0+] [[#ApplicationControlDataCondition|ApplicationControlDataCondition]]
|-
| 0x34D1
| 0x1
| [20.0.0+] InitialProgramIndex
|-
| 0x34D2
| 0x2
| Reserved
|-
| 0x34D4
| 0x4
| [20.0.0+] AccessibleProgramIndexFlags
|-
| 0x34D8
| 0x1
| [20.0.0+] AlbumFileExport
|-
| 0x34D9
| 0x7
| Reserved
|-
| 0x34E0
| 0x80
| [20.0.0+] [[#SaveDataCertificateBytes|SaveDataCertificateBytes]]
|-
| 0x3560
| 0x1
| [20.0.0+] HasInGameVoiceChat
|-
| 0x3561
| 0x3
| Reserved
|-
| 0x3564
| 0x4
| [20.0.0+] SupportedExtraAddOnContentFlag
|-
| 0x3568
| 0x698
| Reserved
|-
| 0x3C00
| 0x400
| [20.0.0+] [[#PlatformSpecificRegion|PlatformSpecificRegion]]
|}
|}


==Language Entry==
== ApplicationTitle ==
Total size is 0x300-bytes.
Total size is 0x300-bytes.


Line 118: Line 336:
| 0x0
| 0x0
| 0x200
| 0x200
| Application name string
| Application name strings
|-
|-
| 0x200
| 0x200
| 0x100
| 0x100
| Application developer string
| Application publisher strings
|}
|}


Line 157: Line 375:
| 12 || "Korean"
| 12 || "Korean"
|-
|-
| 13 || "Taiwanese"
| 13 || "TraditionalChinese"
|-
| 14 || "SimplifiedChinese"
|-
| 15 || [10.1.0+] "BrazilianPortuguese"
|}
 
Official apps tend to have most of the title entries' strings set only to English. Some apps don't have certain title entries set at all.
 
== VideoCapture ==
This is the enum used to determine how gameplay recording can occur, if at all.
 
{| class="wikitable" border="1"
|-
! Value || Meaning
|-
| 0 || Disabled
|-
| 1 || Enabled
|-
| 2 || Automatic
|}
 
When this value is 0, gameplay cannot be recorded. When this value is 1, the game must manually sacrifice some of its heap as transfer memory for AM's IApplicationProxy->InitializeGamePlayRecording(). When this value is 2, AM will call NS->BoostSystemMemoryResourceSize(), and allocate the required memory for recording automatically without the usermode process having to do anything.
 
== PlayLogPolicy ==
[[Applet_Manager_services|AM]] passes [[Shared_Database_services#PlayLogPolicy|this]] to [[Shared_Database_services|pdm:ntfy]] cmd9.
 
== PlayLogQueryCapability ==
This is used with [[Applet_Manager_services|AM]] commands QueryApplicationPlayStatistics and QueryApplicationPlayStatisticsByUid, to verify whether querying the specified titleIDs are allowed. When not allowed, error 0x3E880 is returned.
 
{| class="wikitable" border="1"
|-
! Value || Meaning || Description
|-
| 0 || None || The specified titleIDs must match the user-process titleID.
|-
| 1 || WhiteList || The specified titleIDs must match the user-process titleID, or one of the titleIDs from PlayLogQueryableApplicationId.
|-
| 2 || All || All titleIDs are allowed.
|}
 
== ApplicationErrorCodePrefix ==
S1 games (including S2-Edition) built for [20.0.0+] set this to 0x2. This is set to 0x3 with S2-only games.
 
== ApparentPlatform ==
This is 0x0 with S1 games. This is set to 0x1 with S2-only and Switch 2 Edition games.
 
== ApplicationNeighborDetectionClientConfiguration ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x18
| [[#ApplicationNeighborDetectionGroupConfiguration|SendGroupConfiguration]]
|-
| 0x18
| 0x180 (0x18 * 16)
| [[#ApplicationNeighborDetectionGroupConfiguration|ReceivableGroupConfigurations]]
|}
 
=== ApplicationNeighborDetectionGroupConfiguration ===
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x8
| GroupId
|-
|-
| 14 || "Chinese"
| 0x8
| 0x10
| Key
|}
|}


Official apps tend to have the language entries' strings set to only English. Some apps don't have certain language entries set at all. In addition, official apps usually (?) don't have the following language entries set: Korean, Taiwanese, and Chinese.
== ApplicationJitConfiguration ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x8
| Flags
|-
| 0x8
| 0x8
| MemorySize
|}
 
== RequiredAddOnContentsSetBinaryDescriptor ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x40 (0x2 * 32)
| Descriptors
|}
 
== AccessibleLaunchRequiredVersionValue ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x40 (0x8 * 8)
| Array of [[NCM_services#ApplicationId|ApplicationId]]
|}
 
== ApplicationControlDataCondition ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x8 (0x1 * 8)
| Type
|-
| 0x8
| 0x80 (0x10 * 8)
| [[#ApplicationControlDataConditionData|Data]]
|-
| 0x88
| 0x1
| Count
|}
 
=== ApplicationControlDataConditionData ===
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x1
| Priority
|-
| 0x1
| 0x7
| Reserved
|-
| 0x8
| 0x2
| AocIndex
|-
| 0xA
| 0x6
| Reserved
|}
 
== SaveDataCertificateBytes ==
When initialized, the first two bytes here are both 0x1. With S2-only games, the second byte is instead set to 0x4.
 
u8 +0x11 is 0x0 with S1 games, this is 0x1 with S2-only games.
 
== PlatformSpecificRegion ==
Data here is only initialized with S2-only games.
Retrieved from "https://switchbrew.org/wiki/NACP"