Files
AnyPS5/docs/dev/debt/libSceNpUniversalDataSystem.md
T
Yunus Shaikh 5a0ee9c799 docs(debt): record the AgcDriver, Ngs2.native and NpUniversalDataSystem pending exports
libSceAgcDriver, libSceNgs2.native and libSceNpUniversalDataSystem now
build their Export.cpp stubs, but their debt files had no entry for
them. Each gains one in the wording of the other pending-export
entries: names and NIDs from the PS5 3.20 export table, no credible
prototype, and a throw through NotImplemented_nid_no_patch.
2026-10-25 13:50:42 +00:00

15 KiB

libSceNpUniversalDataSystem technical debt

Unknown function info

Functional

  • Trophy events: sceNpUniversalDataSystemPostEvent stores an _UnlockTrophy event with an int32 _trophy_id of 0 or more as an unlock for the user and service label of its context, as KytyPS5 does, except an id that libSceNpTrophy2 refuses when the title's trophy data is loaded (one not in the data, a platinum or a progressive trophy). _UpdateTrophyProgress, named only by a third-party unlocker, is logged once per trophy and not interpreted. A context need not be registered, and every post of an event that sceNpUniversalDataSystemCreateEvent returned and that is not yet destroyed returns success (a null or any other event pointer stops the game): KytyPS5's errors for an unknown or unregistered context and for a malformed unlock are not verified. The storage statistics stay zero.
  • Statistics: every other event goes through the title's rules in sce_sys/uds/udsNN.ucp, which libSceNpTrophy2 reads. Only statistics with "aggregation":"latest" and dataType uint32 or uint64 are kept, as in KytyPS5; no public source documents the other aggregations or types, so their definitions and rules are skipped. Only rules whose condition is an eventName alone and whose input is a $.name path (dotted for nested objects) are applied. A value is used when it is an integer of any width that is not negative and fits the statistic's type and minValue/maxValue; KytyPS5 requires the statistic's exact width, and whether the console converts, clamps or rejects other values is not known. Statistics are stored per user and service label, and every trophy's unlockCondition is compared after each event that sets one.