vault backup: 2023-02-04 14:56:18
This commit is contained in:
parent
51d39cbbe4
commit
65f5a81960
|
|
@ -0,0 +1 @@
|
|||
.obsidian
|
||||
|
|
@ -0,0 +1 @@
|
|||
# Appendix
|
||||
|
|
@ -0,0 +1,140 @@
|
|||
# Chunked Formats
|
||||
|
||||
# General Block format
|
||||
|
||||
```cpp
|
||||
struct Block {
|
||||
unsigned char block_id[4],
|
||||
uint32_t size,
|
||||
unsigned char data[size],
|
||||
}
|
||||
|
||||
template<typename T>
|
||||
struct Block {
|
||||
unsigned char block_id[4],
|
||||
uint32_t size,
|
||||
T data,
|
||||
}
|
||||
```
|
||||
|
||||
# Block IDs
|
||||
|
||||
File ID | Chunk IDs
|
||||
------- | ------------------------------------------------------------------------------
|
||||
AMC | AMC, CMSH, QUAD
|
||||
CM3 | ANI, CM3, EVA, NAE, NAM, SCN
|
||||
DUM | DUM, INI
|
||||
EMI | EMI, LFVF, MAP, MAT, TRI
|
||||
SM3 | ANI, CAM, INI, LFVF, LUZ, MAP, MAT, MD3D, NAE, NAM, PORT, SCN, SM3, SPR3, SUEL
|
||||
|
||||
Read types:
|
||||
|
||||
- `i`: 4-byte unsigned integer
|
||||
- `s`: 4-byte signed integer
|
||||
- `p`: length prefixed string
|
||||
- `f`: 4-byte float
|
||||
- `3f`: array of 3 4-byte floats
|
||||
- `3i`: array of 3 4-byte unsigned integers
|
||||
|
||||
Chunk ID | Description | Reads
|
||||
-------- | --------------------------- | ------------------------
|
||||
AMC | Collision Data |
|
||||
ANI | Animation data? |
|
||||
CAM | Camera info? |
|
||||
CMSH | Collision Mesh Data |
|
||||
DUM | Dummy (map object) data |
|
||||
INI | INI-Configuration data |
|
||||
LFVF | FVF Vertex Data |
|
||||
LUZ | Lighting information |
|
||||
MAP | UV Map? |
|
||||
MAT | Material information |
|
||||
NAE | Animation Data? |
|
||||
NAM | Animation Data? |
|
||||
PORT | Map portals? | i==1, i, i, 4, 4
|
||||
QUAD | Mesh data? |
|
||||
SCN | Scene data? |
|
||||
SUEL | Ground plane? | 0x18, 0xc, 4, 4, 4, 0x18
|
||||
TRI | Triangle strip definitions? |
|
||||
MD3D | 3D Model definition? |
|
||||
|
||||
# Format of Specific chunks
|
||||
|
||||
## INI
|
||||
|
||||
Configuration Data
|
||||
|
||||
```cpp
|
||||
struct INI {
|
||||
uint32_t num_sections;
|
||||
struct {
|
||||
uint32_t num_lines;
|
||||
struct {
|
||||
uint32_t num_chars;
|
||||
char line[num_chars]
|
||||
} lines[num_lines];
|
||||
} sections[num_sections];
|
||||
};
|
||||
```
|
||||
|
||||
|
||||
## LFVF
|
||||
|
||||
DirectX Flexible Vertex Format Data
|
||||
|
||||
```cpp
|
||||
struct Vertex { // fields according to flags
|
||||
float position[3]; // D3DFVF_XYZ | D3DFVF_XYZRHW | D3DFVF_XYZB*
|
||||
float rhw; // D3DFVF_XYZRHW
|
||||
float weights[3]; // D3DFVF_XYZB*
|
||||
float normal[3]; // D3DFVF_NORMAL
|
||||
float point_size; // D3DFVF_PSIZE
|
||||
uint32_t diffuse; // D3DFVF_DIFFUSE, RGBA
|
||||
uint32_t specular; //D3DFVF_SPECULAR, RGBA
|
||||
float tex_coords[D3DFVF_TEXTUREFORMAT][D3DFVF_TEX]; // D3DFVF_TEX* and D3DFVF_TEXTUREFORMAT*
|
||||
};
|
||||
|
||||
struct LFVF {
|
||||
uint32_t unk;
|
||||
uint32_t num_entries;
|
||||
struct {
|
||||
uint32_t FVF; // FVF vertex data configuration
|
||||
uint32_t vert_size; //?,
|
||||
uint32_t num_verts;
|
||||
Vertex vertices[num_vers];
|
||||
} entry[num_entries];
|
||||
};
|
||||
```
|
||||
|
||||
## DUM
|
||||
|
||||
Map object data
|
||||
|
||||
```cpp
|
||||
struct DUM {
|
||||
uint32_t unk_1;
|
||||
uint32_t num_dummies;
|
||||
uint32_t unk_2;
|
||||
struct {
|
||||
uint32_t name_length;
|
||||
char name[name_length];
|
||||
float position[3];
|
||||
float rotation[3];
|
||||
uint32_t has_ini;
|
||||
if (has_ini) {
|
||||
Block<INI> ini;
|
||||
};
|
||||
uint32_t unk_1; // has_next?
|
||||
} sections[num_sections];
|
||||
};
|
||||
```
|
||||
|
||||
## MAP
|
||||
|
||||
```cpp
|
||||
struct MAP {
|
||||
uint32_t version;
|
||||
uint32_t tex_name_len;
|
||||
char tex_name[tex_name_len];
|
||||
// TODO: rest
|
||||
}
|
||||
```
|
||||
|
|
@ -0,0 +1,130 @@
|
|||
# Classes
|
||||
|
||||
<!-- TODO: autogenerate? -->
|
||||
|
||||
`new()` @ 0x415ca0
|
||||
|
||||
`delete()` @ 0x415cb0
|
||||
|
||||
> Lots of constructor calls at `0x68367b`
|
||||
|
||||
| Name | Size | Constructor | VMT | Inherits From |
|
||||
| --------------- | ------ | ----------- | -------- | ------------- |
|
||||
| Action | 0xc | 0x584d50 | 0x790fe0 | |
|
||||
| ActionClassList | 0x724 | 0x582eb0 | 0x790fb4 | |
|
||||
| App | ??? | 0x4023e0 | 0x78b4d8 | |
|
||||
| Cam | 0x13c | 0x4b1210 | 0x78d2d8 | Entity |
|
||||
| CamPath | 0x1788 | 0x4b1a50 | 0x78d340 | Cam |
|
||||
| Car | 0x970 | 0x49b300 | 0x78cd40 | WithLife |
|
||||
| Entity | 0x7c | 0x4e97e0 | 0x78da88 | |
|
||||
| EntityList | 0xa4 | 0x474d70 | ??? | |
|
||||
| FCam | 0x274 | 0x4b28e0 | 0x78d3a8 | Cam |
|
||||
| Missile | 0x9a4 | 0x4ec120 | 0x78db90 | WithLife |
|
||||
| Obj | 0x288 | 0x4efa40 | 0x78dca8 | Entity |
|
||||
| SaveVar | 0xc | 0x416540 | | |
|
||||
| WalkChar | 0x760 | 0x4cdf90 | 0x78d4d8 | WithLife |
|
||||
| Window | 0x88 | 0x4010e0 | 0x78b480 | App |
|
||||
| WithLife | 0x544 | 0x4f2a60 | 0x78de00 | Obj |
|
||||
| World | 0x225c | 0x479870 | 0x78cc6c | |
|
||||
| item | 0x458 | 0x4ea790 | 0x78dad8 | Obj |
|
||||
| Py_Entity | ???? | ??? | ??? | |
|
||||
|
||||
## Class Inheritance
|
||||
|
||||
```mermaid
|
||||
graph LR
|
||||
World
|
||||
ActionClassList
|
||||
SaveVar
|
||||
App --> Window
|
||||
Cam --> CamPath
|
||||
Entity --> Cam
|
||||
Cam --> FCam
|
||||
Entity --> Obj
|
||||
Obj --> item
|
||||
Obj --> WithLife
|
||||
WithLife --> Car
|
||||
WithLife --> WalkChar
|
||||
WithLife --> Missile
|
||||
```
|
||||
|
||||
# Attributes (VMT index 16,17,18 for accessor functions)
|
||||
|
||||
## Entity
|
||||
|
||||
- LLogic
|
||||
- Name
|
||||
- Type
|
||||
- EntityList
|
||||
- NextInSlot
|
||||
- NextInList
|
||||
|
||||
## FCam
|
||||
|
||||
- OnSwitch
|
||||
- QuakeFactor
|
||||
- MainTarget
|
||||
- Target
|
||||
- EntityLink
|
||||
- QuakeFactor
|
||||
- QuakeTime
|
||||
- HSpeed
|
||||
- VSpeed
|
||||
- RetSpd
|
||||
- CamDist
|
||||
- CamAng
|
||||
- CamRot
|
||||
- AddTurn
|
||||
- AddTurnSpeed
|
||||
|
||||
## Cam
|
||||
|
||||
- Fov
|
||||
- clipNear
|
||||
- clipFar
|
||||
-
|
||||
|
||||
|
||||
|
||||
## Obj
|
||||
|
||||
- OnEndMove
|
||||
- CamName
|
||||
- NetRes
|
||||
- OnObjSlot
|
||||
- LinkModel?
|
||||
|
||||
## item
|
||||
|
||||
- TakeSound
|
||||
- OnReset
|
||||
- OnTake
|
||||
- Owner
|
||||
- TgTypeMarker
|
||||
|
||||
## Car
|
||||
|
||||
- Traf
|
||||
- Model
|
||||
- Target
|
||||
|
||||
## WithLife
|
||||
|
||||
- Descriptor
|
||||
- Attacker
|
||||
- ActCtrl
|
||||
- HeadModel
|
||||
- Pyromaniac
|
||||
- OnDeath
|
||||
- Hit?
|
||||
- OnDamage
|
||||
- CanPhoto
|
||||
- AlwaysUse
|
||||
- ArrowCanView
|
||||
- ArrowCanMission
|
||||
- ArrowCanUse
|
||||
- ArrnOpt
|
||||
- ArriOpt
|
||||
- UseAngSel
|
||||
- UseMapCheck
|
||||
- UseAbsAngSel
|
||||
|
|
@ -0,0 +1,18 @@
|
|||
# File Formats
|
||||
|
||||
|
||||
File Extension | Description | Chunked
|
||||
-------------- | ------------------------ | -------
|
||||
.packed | Game Data Archive | n
|
||||
.cm3 | Animation file | y
|
||||
.sm3 | 3d model file | y
|
||||
.dum | Dummy (map object) file | y
|
||||
.pth | AI Path | n
|
||||
.emi | Emission maps/Materials? | y
|
||||
.amc | Collision Data | y
|
||||
.ini | Configuration | n
|
||||
.txa | Texture Animation Config | n
|
||||
|
||||
- [Chunked](Chunked.md)
|
||||
- [Packed](Packed.md)
|
||||
- [AI Pathfinding Graph](Nodegraph.md)
|
||||
|
|
@ -0,0 +1 @@
|
|||
# File Formats
|
||||
|
|
@ -0,0 +1,17 @@
|
|||
# MultiSpriteTable
|
||||
|
||||
```cpp
|
||||
struct Tile {
|
||||
uint16_t pos[2];
|
||||
uint16_t size[2];
|
||||
}
|
||||
|
||||
struct MST {
|
||||
char magic[4]; // always "MST\0"
|
||||
uint32_t data_size;
|
||||
uint32_t version; // should be 100
|
||||
uint32_t image_size[2]; // width and height of base image
|
||||
uint32_t num_tiles; // number of tiles/subsprites
|
||||
Tile tiles[num_tiles];
|
||||
}
|
||||
```
|
||||
|
|
@ -0,0 +1,75 @@
|
|||
# Encryption (v1.1)
|
||||
|
||||
Fixed Key: `020406080a0c0e10121416181a1c1e20222426282a2c2e30323436383a3c3e40`
|
||||
Packet Structure:
|
||||
```
|
||||
[0..nonce_len]: nonce
|
||||
[nonce_len..(16-nonce_len%16)]: padding
|
||||
[16..ciphertext_len]: Ciphertext
|
||||
[nonce_len+(16-nonce_len%16)+ciphertext_len]
|
||||
|
||||
|
||||
00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F
|
||||
0000 ED C9 C2 F4 7C 6D F2 54 42 EF 46 F6 00 00 00 00 ....|m.TB.F.....
|
||||
0010 68 13 5C 9A 2B 18 DB 9C 76 BE A0 8A 3E 49 79 3C h.\.+...v...>Iy<
|
||||
0020 8D 7A C4 4C 8B B0 A4 94 E5 B5 89 54 A6 ED 6D 75 .z.L.......T..mu
|
||||
0030 1A CA A8 4B 22 B5 03 84 F7 3C DE 4E B0 30 81 29 ...K"....<.N.0.)
|
||||
0040 3B 70 45 15 33 C0 97 67 85 6B 28 EF 2E 2E D1 83 ;pE.3..g.k(.....
|
||||
0050 E6 56 A7 81 53 89 3E 52 D8 82 CF 77 92 CF C2 D6 .V..S.>R...w....
|
||||
0060 9F 37 C5 DE EE 14 4D 3F 1F 82 32 7E 00 00 00 00 .7....M?..2~....
|
||||
0070 0C 00 00 00 00 00 00 00 5C 00 00 00 00 00 00 00 ........\.......
|
||||
0080 89 7A A8 32 93 56 B6 68 24 E0 58 63 7F 70 5A D2 .z.2.V.h$.Xc.pZ.
|
||||
```
|
||||
Decrypted:
|
||||
```
|
||||
00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F
|
||||
0000 BA CE 01 01 8B 6D 06 00 00 00 01 4D 53 45 31 3A .....m.....MSE1:
|
||||
0010 20 46 6C 61 67 20 48 75 6E 74 20 32 2D 36 00 05 Flag Hunt 2-6..
|
||||
0020 00 00 00 00 00 05 18 01 88 AA 9B 46 6C 61 67 48 ...........FlagH
|
||||
0030 75 6E 74 00 54 A9 2F 05 F0 B4 4F 43 41 00 00 00 unt.T./...OCA...
|
||||
0040 4D 07 18 01 60 A3 00 05 00 00 80 3F 20 4A DA 3D M...`......? J.=
|
||||
0050 68 F8 8F 01 19 6A 71 77 20 8B FB 76 h....jqw ..v
|
||||
```
|
||||
|
||||
# Netplay
|
||||
|
||||
Game Info Packet
|
||||
|
||||
```
|
||||
Server 'B':FZ (0/10) Ver 1.0 at 192.168.99.1:28086
|
||||
[0-2] ID (0xbace)
|
||||
[2-4] Version
|
||||
[4-5] port (16-bit)
|
||||
[6-7] max_players (16-bit)
|
||||
[8-9] curr_player (16-bit)
|
||||
[10-x] server name (char*)
|
||||
|
||||
0 1 2 3 4 5 6 7 8 9 A B C D E F 0123456789ABCDEF
|
||||
0019fdc0 ba ce 00 01 b6 6d 0a 00 00 00 42 00 30 fe 19 00 .....m....B.0...
|
||||
0019fdd0 ff ff ff ff 27 2b b3 9b c7 3e bb 00 9c af 29 00 ....'+...>....).
|
||||
0019fde0 db 69 00 00 00 00 00 00 00 00 44 65 61 74 68 4d .i........DeathM
|
||||
0019fdf0 61 74 63 68 00 00 00 00 ff ff 46 5a 00 4a 91 f0 atch......FZ.J..
|
||||
0019fe00 92 8b 57 4e 7f 00 00 00 10 21 fe 38 0d ae 00 00 ..WN.....!.8....
|
||||
0019fe10 f0 ce f3 36 a0 e8 0b 77 a0 e8 ...6...w..
|
||||
```
|
||||
|
||||
|
||||
Player Join Packet
|
||||
|
||||
```
|
||||
[0-3] header/ID?
|
||||
[6-x] Player name
|
||||
|
||||
0 1 2 3 4 5 6 7 8 9 A B C D E F 0123456789ABCDEF
|
||||
09c9dfe8 7f 47 00 00 00 0e 55 6e 6e 61 6d 65 64 20 50 6c .G....Unnamed Pl
|
||||
09c9dff8 61 79 65 72 06 53 42 6f 73 73 31 b9 00 07 50 5f ayer.SBoss1...P_
|
||||
09c9e008 42 65 74 74 79 06 4d 42 4f 53 53 31 06 4d 42 4f Betty.MBOSS1.MBO
|
||||
09c9e018 53 53 31 00 00 10 30 2c 31 35 2c 30 2c 30 2c 31 SS1...0,15,0,0,1
|
||||
09c9e028 35 2c 31 35 2c 31 02 00 00 00 5,15,1....
|
||||
```
|
||||
|
||||
Message | Description
|
||||
---------------------------------------- | -----------------------------------------------------------------
|
||||
`5c68625c32383230395c73637261706c616e64` | "Scrapland Server" announcement broadcast (`\hb\28209\scrapland`)
|
||||
`7f01000007` | Retrieve Game info
|
||||
`48423d35323932322c3235363a323830383600` | Connection Information (`HB=52922,256:28086`)
|
||||
|
|
@ -0,0 +1,146 @@
|
|||
# Protocol notes
|
||||
|
||||
Raw UDP Payload:
|
||||
|
||||
```
|
||||
0f0000020007007544b3c59018374774c6b246009805000009955f3c00067134
|
||||
0281062c090900001d007f5e0e22c6ddf52247cce2b64655163b8c8e0b4a272f
|
||||
44e7afc745ef91354600000000000000000008155f8300035186005100e9fb08
|
||||
050040007e5700ffff6301000010ff2365f96e1e00000002000000105f000006
|
||||
21e000daf7b1f73a0000c800ff7544b3c59018374774c6b24697f5d702000000
|
||||
00000000000000000000000000000000002c2502159ba419d1c4012d3c47252d
|
||||
af465359899e7745e6531142b96009c4ffff2402159e7f005800b5ff20f1f019
|
||||
04210bd5f5ffff2302159f4a6cd1c44625314792e5b04614cb45d6da5c26aa4e
|
||||
44a2ca72c5cdb4edc3ffff2202159e7e0014009efff6e8c89f0822fc8ff3ffff
|
||||
```
|
||||
|
||||
Hexdump:
|
||||
|
||||
```
|
||||
0000 0F 00 00 02 00 07 00 75 44 B3 C5 90 18 37 47 74 .......uD....7Gt
|
||||
0010 C6 B2 46 00 98 05 00 00 09 95 5F 3C 00 06 71 34 ..F......._<..q4
|
||||
0020 02 81 06 2C 09 09 00 00 1D 00 7F 5E 0E 22 C6 DD ...,.......^."..
|
||||
0030 F5 22 47 CC E2 B6 46 55 16 3B 8C 8E 0B 4A 27 2F ."G...FU.;...J'/
|
||||
0040 44 E7 AF C7 45 EF 91 35 46 00 00 00 00 00 00 00 D...E..5F.......
|
||||
0050 00 00 08 15 5F 83 00 03 51 86 00 51 00 E9 FB 08 ...._...Q..Q....
|
||||
0060 05 00 40 00 7E 57 00 FF FF 63 01 00 00 10 FF 23 ..@.~W...c.....#
|
||||
0070 65 F9 6E 1E 00 00 00 02 00 00 00 10 5F 00 00 06 e.n........._...
|
||||
0080 21 E0 00 DA F7 B1 F7 3A 00 00 C8 00 FF 75 44 B3 !......:.....uD.
|
||||
0090 C5 90 18 37 47 74 C6 B2 46 97 F5 D7 02 00 00 00 ...7Gt..F.......
|
||||
00a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................
|
||||
00b0 00 2C 25 02 15 9B A4 19 D1 C4 01 2D 3C 47 25 2D .,%........-<G%-
|
||||
00c0 AF 46 53 59 89 9E 77 45 E6 53 11 42 B9 60 09 C4 .FSY..wE.S.B.`..
|
||||
00d0 FF FF 24 02 15 9E 7F 00 58 00 B5 FF 20 F1 F0 19 ..$.....X... ...
|
||||
00e0 04 21 0B D5 F5 FF FF 23 02 15 9F 4A 6C D1 C4 46 .!.....#...Jl..F
|
||||
00f0 25 31 47 92 E5 B0 46 14 CB 45 D6 DA 5C 26 AA 4E %1G...F..E..\&.N
|
||||
0100 44 A2 CA 72 C5 CD B4 ED C3 FF FF 22 02 15 9E 7E D..r......."...~
|
||||
0110 00 14 00 9E FF F6 E8 C8 9F 08 22 FC 8F F3 FF FF ..........".....
|
||||
```
|
||||
|
||||
Split up into chunks:
|
||||
|
||||
```
|
||||
0f 00 0002 0007 00 7544b3c5 90183747 74c6b246 0098
|
||||
|
||||
0500 00 09955f3c000671340281062c090900001d007f5e0e22c6ddf52247cce2b64655163b8c8e0b4a272f44e7afc745ef913546000000000000
|
||||
0000 00 08155f8300035186005100e9fb08050040007e5700ffff6301000010ff2365f96e1e000000
|
||||
0200 00 00105f00000621e000daf7b1f73a0000c800ff7544b3c59018374774c6b24697f5d70200000000000000000000000000000000000000002c
|
||||
2502 15 9ba419d1c4012d3c47252daf465359899e7745e6531142b96009c4ffff
|
||||
2402 15 9e7f005800b5ff20f1f01904210bd5f5ffff
|
||||
2302 15 9f4a6cd1c44625314792e5b04614cb45d6da5c26aa4e44a2ca72c5cdb4edc3ffff
|
||||
2202 15 9e7e0014009efff6e8c89f0822fc8ff3ffff
|
||||
```
|
||||
|
||||
Log message:
|
||||
|
||||
```
|
||||
Size: 0285 PlyId: 002 NumVals: 007
|
||||
( 0:'net 5'-00) 09955f3c000671340281062c090900001d007f5e0e22c6ddf52247cce2b64655163b8c8e0b4a272f44e7afc745ef913546000000000000
|
||||
( 1:'net 0'-00) 08155f8300035186005100e9fb08050040007e5700ffff6301000010ff2365f96e1e000000
|
||||
( 2:'net 2'-00) 00105f00000621e000daf7b1f73a0000c800ff7544b3c59018374774c6b24697f5d70200000000000000000000000000000000000000002c
|
||||
( 3:'net549'-15) 9ba419d1c4012d3c47252daf465359899e7745e6531142b96009c4ffff
|
||||
( 4:'net548'-15) 9e7f005800b5ff20f1f01904210bd5f5ffff
|
||||
( 5:'net547'-15) 9f4a6cd1c44625314792e5b04614cb45d6da5c26aa4e44a2ca72c5cdb4edc3ffff
|
||||
( 6:'net546'-15) 9e7e0014009efff6e8c89f0822fc8ff3ffff
|
||||
```
|
||||
|
||||
Structure:
|
||||
|
||||
```
|
||||
|
||||
0f00 # Unk
|
||||
0002 # PlayerID
|
||||
0007 # Num Vals
|
||||
00 # Unk
|
||||
7544b3c5 # Pos.X
|
||||
90183747 # Pos.Y
|
||||
74c6b246 # Pos.Z
|
||||
00 # Player Index
|
||||
98 # Rtt
|
||||
0500 00 09955f3c000671340281062c090900001d007f5e0e22c6ddf52247cce2b64655163b8c8e0b4a272f44e7afc745ef913546000000000000
|
||||
0000 00 08155f8300035186005100e9fb08050040007e5700ffff6301000010ff2365f96e1e000000
|
||||
0200 00 00105f00000621e000daf7b1f73a0000c800ff7544b3c59018374774c6b24697f5d70200000000000000000000000000000000000000002c
|
||||
2502 15 9ba419d1c4012d3c47252daf465359899e7745e6531142b96009c4ffff
|
||||
2402 15 9e7f005800b5ff20f1f01904210bd5f5ffff
|
||||
2302 15 9f4a6cd1c44625314792e5b04614cb45d6da5c26aa4e44a2ca72c5cdb4edc3ffff
|
||||
2202 15 9e7e0014009efff6e8c89f0822fc8ff3ffff
|
||||
|
||||
```
|
||||
|
||||
```c
|
||||
#pragma endian big
|
||||
|
||||
struct NetValue {
|
||||
le u16 entity_index;
|
||||
u8 entity_type;
|
||||
char data[?]; // TODO: how is length determined?
|
||||
};
|
||||
|
||||
struct NetData {
|
||||
le u16 unk;
|
||||
u16 player_id;
|
||||
u16 num_vals;
|
||||
u8 unk_2;
|
||||
le float pos[3];
|
||||
u8 player_idx;
|
||||
u8 rtt_ms;
|
||||
NetValue values[num_vals];
|
||||
};
|
||||
|
||||
```
|
||||
|
||||
Packets are split into Data packets (map change, resources, chat message, etc) and entity (position?) updates
|
||||
|
||||
## Packet types
|
||||
|
||||
- 00: MapChange:
|
||||
- str map_name
|
||||
- str game_mode
|
||||
|
||||
- 01: Resource:
|
||||
- u8: unk
|
||||
- u16?: num_resources
|
||||
- [str: resource_name]*num_resources
|
||||
|
||||
- 02: Unknown (Keepalive?)
|
||||
|
||||
- 03: ChatMessage
|
||||
- str: message
|
||||
|
||||
- 04: UsrString:
|
||||
- str: data
|
||||
|
||||
- 05: Player join:
|
||||
- u8: player_id
|
||||
- str: player_name
|
||||
- str: ship_model
|
||||
- u16: max_health
|
||||
- str[4]: engine_models
|
||||
- str: pilot_model
|
||||
- str: loadout
|
||||
- u32: unknown
|
||||
|
||||
- 06: unknown
|
||||
- u8: ent_index
|
||||
|
||||
- 07: unknown (reload?)
|
||||
|
|
@ -0,0 +1,26 @@
|
|||
# AI Nodegraph
|
||||
|
||||
Used for pathfinding using the A*-Algorithm.
|
||||
|
||||
```cpp
|
||||
// n= number of dimension (3 or 2)
|
||||
|
||||
template<size_t n>
|
||||
struct Node {
|
||||
float pos[n];
|
||||
};
|
||||
|
||||
template<size_t n>
|
||||
struct Edge {
|
||||
uint32_t num_edge_nodes;
|
||||
Node<n> nodes[];
|
||||
};
|
||||
|
||||
template<size_t n>
|
||||
struct Graph {
|
||||
uint32_t num_nodes;
|
||||
Node<n> nodes[];
|
||||
uint32_t num_edges;
|
||||
Edge<n> edges[];
|
||||
};
|
||||
```
|
||||
|
|
@ -0,0 +1,6 @@
|
|||
# Overview
|
||||
|
||||
- Developer Studio: Mercury Steam
|
||||
- Engine: [ScrapEngine](./ScrapEngine.md)
|
||||
- Scripting System: embedded Python 1.5.2 interpreter
|
||||
- Game Data Archive Format: [.packed](./packed.md)
|
||||
File diff suppressed because it is too large
Load Diff
|
|
@ -0,0 +1,15 @@
|
|||
# Packed
|
||||
|
||||
```cpp
|
||||
struct Header {
|
||||
unsigned char magic[4]; // always BFPK
|
||||
uint32_t version;
|
||||
uint32_t number_of_files;
|
||||
struct File {
|
||||
uint32_t path_length;
|
||||
char path[]; // latin1 encoding
|
||||
uint32_t data_size;
|
||||
uint32_t data_offset; // offset includes header size so it can be used directly in a seek() call
|
||||
} files[];
|
||||
};
|
||||
```
|
||||
|
|
@ -0,0 +1 @@
|
|||
# Python API
|
||||
File diff suppressed because one or more lines are too long
|
|
@ -0,0 +1,18 @@
|
|||
# Summary
|
||||
|
||||
- [Overview](./Overview.md)
|
||||
- [ScrapEngine](./ScrapEngine.md)
|
||||
- [Engine Variables](./Variables.md)
|
||||
- [Classes](./Classes.md)
|
||||
- [World](./World.md)
|
||||
- [Netplay](Netplay.md)
|
||||
- [Python API](./Python_API.md)
|
||||
- [Modules](./Python_Modules.md)
|
||||
- [File Formats](./File_Formats.md)
|
||||
- [Chunked Formats](./Chunked.md)
|
||||
- [Packed](./Packed.md)
|
||||
- [AI Nodegraph](./Nodegraph.md)
|
||||
- [MultiSpriteTable](MultiSpriteTable.md)
|
||||
- [ScrapHacks](./ScrapHacks.md)
|
||||
- [Appendix](./Appendix.md)
|
||||
- [PE Metadata](./PE_metadata.md)
|
||||
|
|
@ -0,0 +1,89 @@
|
|||
# ScrapEngine
|
||||
|
||||
- Based on Mercury Engine
|
||||
- Ingame Scripting Language: Python 1.5.2
|
||||
|
||||
## Launch options
|
||||
|
||||
Checked in `0x00401010`
|
||||
|
||||
- `-console`: open external console window on start
|
||||
- `-inifile`: *unknown* some kind of `.ini` file, seems to be related to `m3d.ini` in `Data.packed`
|
||||
|
||||
Checked in `0x004039b0`
|
||||
|
||||
- `-build`: Rebuild `Data.packed` (needs a `filelist.2Bpack`)
|
||||
- `-dedicated`: start in multiplayer dedicated server mode (needs to be used with `-server`)
|
||||
- `-server`: start in multiplayer server mode
|
||||
- `-<var_name>:<var_value>`: override engine variable (example: `-debug:10`)
|
||||
|
||||
Checked in `0x00401180`
|
||||
|
||||
- `-wideWindow`: start game in widescreen mode
|
||||
|
||||
|
||||
## Files
|
||||
|
||||
- `engine.txt`: Contains engine commands? Lexer/Parser @ `0x6168a0`
|
||||
- Errors get printed to Scene graph debugging console
|
||||
- Command buffer @ `0x8c1b30`
|
||||
- Commands:
|
||||
- `Load`: Load Model?
|
||||
- `AddAnim`: Load Animation data?
|
||||
- `PlayAnim`: Play Animation?
|
||||
- `PivotPos`: ?
|
||||
- `FUNDIR_NODOS`: ?
|
||||
- `EFEC_MALLA`: ?
|
||||
- Values:
|
||||
- `true`
|
||||
- `false`
|
||||
- `engine.log`: Created when `engine.txt` exists
|
||||
|
||||
`engine.txt` containing `Load("Models/Vehicles/Ships/SBoss1/SBoss1.SM3", 1)` results in error `D:\Games\Deep Silver\Scrapland\engine.txt (1): Error: missing a ( character`
|
||||
|
||||
|
||||
## Ingame-Console
|
||||
|
||||
(Ctrl+\^ or right click on window title bar and select "switch console") (Handler @ `0x402190`)
|
||||
|
||||
* `<Code>`: Evaluate Python code
|
||||
* `:<Var>`: Get Game Engine Variable
|
||||
* `:<Var> <Val>`: Set Game Engine Variable
|
||||
* `?`: Show all Game Engine Variables
|
||||
* `?<String>`: Show all Game Engine Variables matching `<String>`
|
||||
* `/<command>`: Run Command defined in `QuickConsole.py`
|
||||
* Expands to `import quickconsole;quickconsole.%s()`
|
||||
* `/<command> <arg>,<arg>`: Run function in `QuickConsole.py` with argument(s)
|
||||
* Expands to `import quickconsole;quickconsole.%s(%s)`
|
||||
|
||||
## External Console
|
||||
|
||||
(Scene graph debugging?) (Handler @ `0x5f9520`)
|
||||
|
||||
* `listar luces` List lights in scene
|
||||
* `listar` list models in scene
|
||||
* `arbol <model_name>` show details for model
|
||||
* `mem` (doesn't do anything?)
|
||||
* `ver uniones`
|
||||
* Easter Eggs:
|
||||
* `imbecil`
|
||||
* `idiota`
|
||||
* `capullo`
|
||||
|
||||
## Window Messages
|
||||
|
||||
**TODO**
|
||||
|
||||
## Other interesting Memory Addresses
|
||||
|
||||
- `0x852914`: D3D8-Device pointer
|
||||
- `0x7FCC00`: number of opened `.packed` files
|
||||
- `0x84cb64`: pointer to console command handler
|
||||
- `0x7fac84`: pointer to C++ callback list structure
|
||||
- `0x80b2cc`: pointer to ActionClassList (???)
|
||||
- `0x807a20`: pointer to SScorer (ingame GUI/Menu/Text system) structure (???)
|
||||
- `0x80a398`: pointer to SoundSystem (???)
|
||||
- `0x8b18f0`: pointer to Models Data (can be dumped using scene graph debugging console)
|
||||
- `0x8b18f4`: pointer to Scenes Data (can be dumped using scene graph debugging console)
|
||||
- `0x8b18f8`: pointer to active Models Data (can be dumped using scene graph debugging console)
|
||||
- for more see `config.yml`
|
||||
|
|
@ -0,0 +1 @@
|
|||
# ScrapHacks
|
||||
File diff suppressed because it is too large
Load Diff
|
|
@ -0,0 +1,86 @@
|
|||
# World
|
||||
|
||||
## Game World/State Pointer @ `0x7fe944`
|
||||
|
||||
Object size: `0x225c` bytes
|
||||
|
||||
Constructor Address: `0x479870`
|
||||
|
||||
Points to World struct
|
||||
|
||||
|
||||
| Offset | Type | Description |
|
||||
| ------ | ------------------------ | -------------------------------------- |
|
||||
| 0x0000 | `void**` | Virtual Method Table |
|
||||
| 0x0004 | `uint32_t` | Slots in Entity Hashtable |
|
||||
| 0x0008 | `void**` | Pointer to Entity Hashtable |
|
||||
| 0x00B0 | `??` | Pointer to Ground Object (?) |
|
||||
| 0x0288 | `pyEntity*` | UsrEntity_0 |
|
||||
| 0x028C | `pyEntity*` | UsrEntity_1 |
|
||||
| 0x0290 | `pyEntity*` | UsrEntity_2 |
|
||||
| 0x0294 | `pyEntity*` | UsrEntity_3 |
|
||||
| 0x0298 | `uint32_t` | Slots in Model Hashtable |
|
||||
| 0x029C | `void**` | Pointer to Model Hashtable |
|
||||
| 0x02B8 | `uint32_t` | Slots in Entity lists Hashtable |
|
||||
| 0x02BC | `void**` | Pointer to Entity list Hashtable |
|
||||
| 0x0330 | `float[3]` | Time (why 3 times?) |
|
||||
| 0x1C6C | `float` | Alarm level |
|
||||
| 0x1C68 | `float` | Alarm Grow Level |
|
||||
| 0x2158 | `float` | Used in `World_Init` |
|
||||
| 0x2170 | `???` | Used in `World_Init` |
|
||||
| 0x2180 | `float` | Used in `World_Init` |
|
||||
| 0x2188 | `void*` | Used in `World_Init` |
|
||||
| 0x218C | `void*` | Used in `World_Init` |
|
||||
| 0x2190 | `float` | Used in `World_Init` |
|
||||
| 0x2198 | `void*` | Used in `World_Init` |
|
||||
| 0x219C | `void*` | Used in `World_Init` |
|
||||
| 0x21A0 | `void**` | Used in `World_Init` (VTable pointer?) |
|
||||
| 0x21B4 | `void**` | Used in `World_Init` (VTable pointer?) |
|
||||
| 0x21C8 | `???` | Used in `World_Init` |
|
||||
| 0x2204 | `uint32_t` or `uint16_t` | Used in `World_Init` |
|
||||
| 0x2230 | `float` | Used in `World_Init` |
|
||||
| 0x2238 | `???` | Used in `World_Init` |
|
||||
| 0x2254 | `float` | Used in `World_Init` |
|
||||
|
||||
|
||||
## cPyEntity structure
|
||||
|
||||
Offset | Type | Description
|
||||
------ | -------- | --------------------
|
||||
0x0000 | `void**` | Virtual Method Table
|
||||
0x0004 | `char*` | Name
|
||||
0x0008 | `void*` | ???
|
||||
|
||||
|
||||
## Entity Hash Table
|
||||
|
||||
Hash-function used: [PJW](https://en.wikipedia.org/wiki/PJW_hash_function) (Same parameters as the example implementation)
|
||||
|
||||
Entry format:
|
||||
|
||||
```cpp
|
||||
struct HT_Entry {
|
||||
void* data;
|
||||
const char* key;
|
||||
HT_Entry* next;
|
||||
}
|
||||
```
|
||||
|
||||
Data format:
|
||||
|
||||
Offset | Type | Description
|
||||
------ | ------------- | ------------------------
|
||||
0x0 | `void**` | Virtual Method Table (?)
|
||||
0x4 | `const char*` | name as string
|
||||
0x14 | `void*` | pointer to self (why?)
|
||||
0x28 | `float[3]` | Position in Game World
|
||||
|
||||
## EntityList Hash Table
|
||||
|
||||
Attributes:
|
||||
- `Near`
|
||||
- `First`
|
||||
- `Num`
|
||||
- `OnDeath`
|
||||
- `OnDamage`
|
||||
- ...
|
||||
Loading…
Reference in New Issue