Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ploxxxy/tdf.js
Implements EA's TDF packet format in JS
https://github.com/ploxxxy/tdf.js
Last synced: about 10 hours ago
JSON representation
Implements EA's TDF packet format in JS
- Host: GitHub
- URL: https://github.com/ploxxxy/tdf.js
- Owner: ploxxxy
- License: mit
- Created: 2024-02-05T19:47:14.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-10-16T07:36:50.000Z (4 months ago)
- Last Synced: 2024-10-17T22:36:31.413Z (4 months ago)
- Language: TypeScript
- Homepage:
- Size: 101 KB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# tdf.js
Library for reading and writing the TDF packet format used in many EA Games (Intended for Mirror's Edge: Catalyst server emulation)
## Usage
### Reading
TDF.js relies on Node's [Readable](https://nodejs.org/api/stream.html#readable-streams) to consume chunks of data of specific length
```js
const { Readable } = require('node:stream')
const { TDF, TDFString } = require('tdf.js')
const stream = new Readable({
read() {}, // supresses errors in console when reading data
})
stream.push(tdfpayload)
const payload = []
while (stream.readableLength) {
const tdf = TDF.readTDF(stream) // read and process any TDF type
payload.push(tdf)
}
// manually parse a specific type
// note that in this case you need to provide the label
const specificTdf = TDFString.read('LABL', stream)
```
### Writing
```ts
const { TDFString, TDFInteger } = require('tdf.js')
const tdfString = new TDFString('VALU', 'Hello, World!')
const buffer = tdfString.write() //
const payload: TDF[] = [new TDFString('HLLO', 'world'), new TDFInteger('INT1', 43)]
const buffer2 = Buffer.concat(payload.map((tdf) => tdf.write())) //
```
### Creating complex packets
```ts
const payload = [
new TDFString('ASRC', '308903'),
new TDFList(
'CIDS',
TDFType.Integer,
20,
[
30728, 24, 1, 30729, 25, 30730, 27, 9, 10, 33, 63490, 15, 30720, 30722, 30723, 30724, 21,
30726, 2000, 30727,
]
),
new TDFString('CLID', 'MirrorsEdgeCatalyst-SERVER-PC'),
new TDFStruct('CONF', [
new TDFDictionary('CONF', TDFType.String, TDFType.String, 17, {
associationListSkipInitialSet: '1',
autoReconnectEnabled: '0',
bytevaultHostname: 'bytevault.gameservices.ea.com',
bytevaultPort: '42210',
bytevaultSecure: 'true',
connIdleTimeout: '40s',
defaultRequestTimeout: '20s',
nucleusConnect: 'https://accounts.ea.com',
nucleusConnectTrusted: 'https://accounts2s.ea.com',
nucleusPortal: 'https://signin.ea.com',
nucleusProxy: 'https://gateway.ea.com',
pingPeriod: '20s',
userManagerMaxCachedUsers: '0',
voipHeadsetUpdateRate: '1000',
xblTokenUrn: 'accounts.ea.com',
xboxOneStringValidationUri: 'client-strings.xboxlive.com',
xlspConnectionIdleTimeout: '300',
}),
]),
new TDFString('ESRC', '308903'),
new TDFString('INST', 'mirrorsedgecatalyst-2016-pc'),
new TDFInteger('MAID', 1129238128),
new TDFInteger('MINR', 0),
new TDFString('NASP', 'cem_ea_id'),
new TDFString('PILD', ''),
new TDFString('PLAT', 'pc'),
new TDFStruct('QOSS', [
new TDFStruct('BWPS', [
new TDFString('PSA ', ''),
new TDFInteger('PSP ', 0),
new TDFString('SNA ', ''),
]),
new TDFInteger('LNP ', 10),
new TDFDictionary('LTPS', TDFType.String, TDFType.Struct, 6, {
'bio-dub': [
new TDFString('PSA ', 'qos-prod-bio-dub-common-common.gos.ea.com'),
new TDFInteger('PSP ', 17504),
new TDFString('SNA ', 'bio-dub-prod'),
],
'bio-iad': [
new TDFString('PSA ', 'qos-prod-bio-iad-common-common.gos.ea.com'),
new TDFInteger('PSP ', 17504),
new TDFString('SNA ', 'bio-iad-prod'),
],
'bio-sjc': [
new TDFString('PSA ', 'qos-prod-bio-sjc-common-common.gos.ea.com'),
new TDFInteger('PSP ', 17504),
new TDFString('SNA ', 'bio-sjc-prod'),
],
'bio-syd': [
new TDFString('PSA ', 'qos-prod-bio-syd-common-common.gos.ea.com'),
new TDFInteger('PSP ', 17504),
new TDFString('SNA ', 'bio-syd-prod'),
],
'm3d-brz': [
new TDFString('PSA ', 'qos-prod-m3d-brz-common-common.gos.ea.com'),
new TDFInteger('PSP ', 17504),
new TDFString('SNA ', 'm3d-brz-prod'),
],
'm3d-nrt': [
new TDFString('PSA ', 'qos-prod-m3d-nrt-common-common.gos.ea.com'),
new TDFInteger('PSP ', 17504),
new TDFString('SNA ', 'm3d-nrt-prod'),
],
}),
new TDFInteger('SVID', 1161889797),
new TDFInteger('TIME', 5000000),
]),
new TDFString('RSRC', '308903'),
new TDFString('SVER', 'Blaze 15.1.1.0.5 (CL# 1893137)\n'),
]
```
## Credits
Big thanks to
- [WarrantyVoider](https://github.com/zeroKilo) for their intesive, public research, open-source materials and personal help
- [The Beat Revival](https://discord.gg/jbnNzA6Uk9) for the help with gathering packets and in-game knowledge