d2s_save_item_format_1.13d.txt
80.9 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
-------------------------------------------------------------------------------
originally extracted from here:
http://www.coreyh.org/diablo-2-files/documentation/d2s_save_item_format_1.13d.html
-------------------------------------------------------------------------------
Diablo II Item Format
for Diablo II v1.13d Expansion Set: Lord of Destruction
Updated June 23, 2012
This file was originally written by Trevin Beattie, whose site is no more (his
latest version of this file is available here though).
Welcome!
Thanks for showing an interest in my Diablo II Item Format page. While you're
browsing, be sure to check out the preview of my game editor for unix+Motif. I
currently have the item editor in development!
Introduction
Having searched the web, I found very few references to the Diablo II .d2s file
format, and most of them covered the old (pre-1.08) version. Diablo II v1.09
has significantly changed the file format. I have started another page which
details the layout of the major parts of the .d2s file. This document focuses
specifically on the item structure — all those pieces of the file tagged "JM".
Rather than describe everything in terms of byte offsets, I'm going to define
the layout as a series of variable-length bit fields. This is a critical part
of the item format, because the position of many of the fields can change
depending on what comes before it. If I say a certain value is a 3-bit field
starting at bit position 150, for example, this translates to bits 6 and 7 of
the byte 18 and bit 0 of byte 19 in the data structure. You can read an
arbitrary bit field programatically using the following code (in C):
#define read_bits(start,size) \
((*((unsigned long *) &data[(start) / 8])
>> ((start) & 7)) & ((1 << (size)) - 1))
Item List Header
An item list begins with the following simple header:
┌────────┬───────┬────────────────────────────────────────────────────────────┐
│ Byte │ Size │ Contents │
│Position│ │ │
├────────┼───────┼────────────────────────────────────────────────────────────┤
│0 │2 chars│Identifier string "JM" { 0x4A, 0x4D } │
├────────┼───────┼────────────────────────────────────────────────────────────┤
│ │ │The number of items your character has. This does not │
│2 │16 bits│include gems or jewels which have been glued into socketed │
│ │ │items. │
└────────┴───────┴────────────────────────────────────────────────────────────┘
Your item list ends with another 4-byte structure similar to the above, except
the second field is zero (i.e., { 0x4A, 0x4D, 0x00, 0x00 }).
In the Expansion Set, your hireling has his/her own item list. This list is
separated from yours by the 2-character identifier "jf". This is followed by an
item list header for the hireling, and then his/her items. The second item list
is not terminated with the same 4-byte structure as the first; instead, it is
followed by the 2-character identifier "kf".
Item Structure part 1: Simple Items
There are still many fields in the item structure which I haven't figured out
yet, but I'll leave placeholders for them in case I find out what they mean in
the future. All sizes are in bits unless otherwise specified.
┌────────┬───────┬────────────────────────────────────────────────────────────┐
│ Bit │ Size │ Contents │
│Position│ │ │
├────────┼───────┼────────────────────────────────────────────────────────────┤
│0 │2 chars│Identifier string "JM" { 0x4A, 0x4D } │
├────────┼───────┼────────────────────────────────────────────────────────────┤
│16 │4 │unknown │
├────────┼───────┼────────────────────────────────────────────────────────────┤
│20 │1 │Item has been identified │
├────────┼───────┼────────────────────────────────────────────────────────────┤
│21 │6 │unknown │
├────────┼───────┼────────────────────────────────────────────────────────────┤
│27 │1 │Item is Socketed │
├────────┼───────┼────────────────────────────────────────────────────────────┤
│28 │1 │unknown │
├────────┼───────┼────────────────────────────────────────────────────────────┤
│29 │1 │This bit is set on items which you have picked up since the │
│ │ │last time the game was saved. Why?... │
├────────┼───────┼────────────────────────────────────────────────────────────┤
│30 │2 │unknown │
├────────┼───────┼────────────────────────────────────────────────────────────┤
│32 │1 │Item is a Player Ear │
│ │ │Thanks go to Mike of Denmark for identifying this bit. │
├────────┼───────┼────────────────────────────────────────────────────────────┤
│ │ │"Newbie" item. This bit is set on the weapon and shield your│
│33 │1 │character is given when you start the game. Apparently, this│
│ │ │gives the item the property of having a repair cost of 1gp, │
│ │ │as well as a sell value of 1gp. │
├────────┼───────┼────────────────────────────────────────────────────────────┤
│34 │3 │unknown │
├────────┼───────┼────────────────────────────────────────────────────────────┤
│ │ │Item is simple (only 111 bits {14 bytes} of item data) │
│37 │1 │Thanks go to Guillaume Courtin of France for discovering the│
│ │ │meaning of this bit. │
├────────┼───────┼────────────────────────────────────────────────────────────┤
│38 │1 │Item is Ethereal (Cannot be Repaired) │
├────────┼───────┼────────────────────────────────────────────────────────────┤
│39 │1 │unknown; this bit is 1 on the items I've looked at │
├────────┼───────┼────────────────────────────────────────────────────────────┤
│40 │1 │Item has been personalized (by Anya in Act V) │
├────────┼───────┼────────────────────────────────────────────────────────────┤
│41 │1 │unknown │
├────────┼───────┼────────────────────────────────────────────────────────────┤
│42 │1 │It looks like this bit indicates the item has been given a │
│ │ │Rune Word. │
├────────┼───────┼────────────────────────────────────────────────────────────┤
│43 │15 │unknown; some of these bits may be set │
├────────┼───────┼────────────────────────────────────────────────────────────┤
│ │ │Item location. Actually, I have only seen a few values for │
│ │ │these bits, so I'm not 100% certain of its validity. If you │
│ │ │see any other value here, let me know what it is and where │
│ │ │the item is located. │
│ │ │┌───────────┬──────────────────────────────────┐ │
│ │ ││0 │Item is stored (see bit field 73) │ │
│ │ │├───────────┼──────────────────────────────────┤ │
│ │ ││1 │Item is equipped (somewhere on │ │
│58 │3 ││ │your body) │ │
│ │ │├───────────┼──────────────────────────────────┤ │
│ │ ││2 │Item is tucked in your belt (or │ │
│ │ ││ │sash) │ │
│ │ │├───────────┼──────────────────────────────────┤ │
│ │ ││4 │Item is being moved (i.e., has │ │
│ │ ││ │been picked up by the mouse). │ │
│ │ │├───────────┼──────────────────────────────────┤ │
│ │ ││6 │Item is glued into a socket. │ │
│ │ │└───────────┴──────────────────────────────────┘ │
├────────┼───────┼────────────────────────────────────────────────────────────┤
│ │ │If the item is equipped, this field tells where it is. │
│ │ │Possible values are: │
│ │ │┌───────────┬──────────────────────────────────┐ │
│ │ ││1 │head (helmet) │ │
│ │ │├───────────┼──────────────────────────────────┤ │
│ │ ││2 │neck (amulet) │ │
│ │ │├───────────┼──────────────────────────────────┤ │
│ │ ││3 │torso (armor) │ │
│ │ │├───────────┼──────────────────────────────────┤ │
│ │ ││4 │right hand (weapon) │ │
│ │ │├───────────┼──────────────────────────────────┤ │
│ │ ││5 │left hand (shield) │ │
│ │ │├───────────┼──────────────────────────────────┤ │
│ │ ││6 │right finger (ring) │ │
│61 │4 │├───────────┼──────────────────────────────────┤ │
│ │ ││7 │left finger (ring) │ │
│ │ │├───────────┼──────────────────────────────────┤ │
│ │ ││8 │waist (belt) │ │
│ │ │├───────────┼──────────────────────────────────┤ │
│ │ ││9 │feet (boots) │ │
│ │ │├───────────┼──────────────────────────────────┤ │
│ │ ││10 │hands (gloves) │ │
│ │ │├───────────┼──────────────────────────────────┤ │
│ │ ││11 │alternate right hand (Expansion │ │
│ │ ││ │Set only) │ │
│ │ │├───────────┼──────────────────────────────────┤ │
│ │ ││12 │alternate left hand (Expansion Set│ │
│ │ ││ │only) │ │
│ │ │└───────────┴──────────────────────────────────┘ │
├────────┼───────┼────────────────────────────────────────────────────────────┤
│ │ │Column number of the left corner of the item, counting from │
│ │ │0. Your inventory has ten columns (numbered 0-9), your stash│
│ │ │has six, and the Horadric Cube has four. │
│ │ │ │
│ │ │Note: Your belt is considered (for the purposes of the item │
│ │ │format) to have no rows, but either 4, 8, 12, or 16 columns.│
│65 │4 │If you prefer, you can divide this field and use the 2 bits │
│ │ │at position 67-68 for the row (but only for belts). │
│ │ │ │
│ │ │Note 2: If the item is equipped, glued to a socket, or in │
│ │ │transit, then this field appears to contain old data from │
│ │ │the last time the item was stored. I.e., it may be non-zero,│
│ │ │but the value is unused. │
├────────┼───────┼────────────────────────────────────────────────────────────┤
│ │ │Row number of the top of the item, counting from 0. Your │
│ │ │inventory has four rows (numbered 0-3), your stash has four │
│ │ │in normal characters or eight in Expansion Set characters, │
│ │ │and the Horadric Cube has four. (In the belt, this field is │
│69 │3 │always zero.) │
│ │ │ │
│ │ │Note: If the item is equipped, tucked in your belt, glued to│
│ │ │a socket, or in transit, then this field appears to contain │
│ │ │old data from the last time the item was stored. I.e., it │
│ │ │may be non-zero, but the value is unused. │
├────────┼───────┼────────────────────────────────────────────────────────────┤
│72 │1 │Set Name Has Suffix (?) │
├────────┼───────┼────────────────────────────────────────────────────────────┤
│ │ │Actually, bit 74 seems to always be 0, but since bits 73 and│
│ │ │75 are related I just lump them all together. If the item is│
│ │ │neither equipped nor in your belt, this field tells where it│
│ │ │is. Possible values are: │
│ │ │┌───────────┬──────────────────────────────────┐ │
│ │ ││0 │not here (check bit field 58) │ │
│ │ │├───────────┼──────────────────────────────────┤ │
│73 │3 ││1 │inventory │ │
│ │ │├───────────┼──────────────────────────────────┤ │
│ │ ││4 │Horadric Cube │ │
│ │ │├───────────┼──────────────────────────────────┤ │
│ │ ││5 │stash │ │
│ │ │└───────────┴──────────────────────────────────┘ │
│ │ │If you find an item having any other value in this field, │
│ │ │let me know what the value is and the item's location! │
├────────┼───────┼────────────────────────────────────────────────────────────┤
│ │ │Item's type. The type is 3 lower-case letters or numbers │
│ │ │followed by a space; e.g., "amu " (Amulet) or "2hs " │
│ │4 chars│(Two-Handed Sword). I have started a list of item │
│76 │(8 bits│identifiers (not posted; sorry), but it is by no means │
│ │ea.) │complete; I'm sure I don't even have half of what's out │
│ │ │there! │
│ │ │Warning: This field is not byte-aligned! It starts in the │
│ │ │middle of byte 9 and runs to the middle of byte 13. │
├────────┼───────┼────────────────────────────────────────────────────────────┤
│ │ │The number of gems (or skulls or jewels) which have been │
│ │ │glued to this item (if socketed). There will be this many │
│108 │3 │additional item structures for the gems immediately │
│ │ │following this item, in the order that the gems were │
│ │ │inserted. │
└────────┴───────┴────────────────────────────────────────────────────────────┘
Item Variant: Player Ears
The following information was provided by Mike of Denmark.
If the item is a Player Ear, its structure is slightly different than the
Simple Items above. The last two fields in the Simple Item structure are
replaced by the following:
┌────────┬───────┬────────────────────────────────────────────────────────────┐
│ Bit │ Size │ Contents │
│Position│ │ │
├────────┼───────┼────────────────────────────────────────────────────────────┤
│ │ │Character class of the ear's former owner. The defined │
│ │ │classes are: │
│ │ │ 0 Amazon │
│ │ │ 1 Sorceress │
│76 │3 │ 2 Necromancer │
│ │ │ 3 Paladin │
│ │ │ 4 Barbarian │
│ │ │ 5 Druid (Expansion character only) │
│ │ │ 6 Assassin (Expansion character only) │
├────────┼───────┼────────────────────────────────────────────────────────────┤
│79 │7 │Character level of the ear's former owner. │
├────────┼───────┼────────────────────────────────────────────────────────────┤
│86 │7 │First character of the former owner's name. │
├────────┼───────┼────────────────────────────────────────────────────────────┤
│93 │7 × N-1│Second character of the former owner's name; Repeat until │
│ │ │you get the whole name (15 characters maximum). │
├────────┼───────┼────────────────────────────────────────────────────────────┤
│86 + 7 ×│7 │0 (this indicates the end of the name) │
│N │ │ │
└────────┴───────┴────────────────────────────────────────────────────────────┘
Following the end of the name, the rest of the final byte will be padded with
0's if necessary, and the Player Ear structure ends there.
Item Structure part 2: Extended Items
By "extended items" I mean any items which are not simple. Simple items are
those which need no further information than that given above — such as gems,
potions, and small quest items — and their structure length is fixed at 14
bytes. Everything else has an extended structure with a possibly variable
length set of bit fields. First, I'll describe the part of the structure that
appears to be the same for all extended items. From that point on, there will
be no more "bit positions"; only "this field follows that field, if it exists".
┌────────┬───────┬────────────────────────────────────────────────────────────┐
│ Bit │ Size │ Contents │
│Position│ │ │
├────────┼───────┼────────────────────────────────────────────────────────────┤
│ │ │Unique identifier. Diablo II randomly generates a value for │
│ │ │this field in order to discourage cheaters from "duping" │
│111 │32 │items. Supposedly, if it detects more than one extended item│
│ │ │with the same unique Id, it will delete the duplicates. (It │
│ │ │hasn't done that for me in single player mode, though.) │
├────────┼───────┼────────────────────────────────────────────────────────────┤
│ │ │This appears to be the item's level; i.e., the level with │
│ │ │which the item was created (or 'dropped'). The item level is│
│ │ │based on the level of the monster who dropped it, the level │
│143 │7 │of the area you're in if found in a chest, or, in rare │
│ │ │cases, your characters level. The item level determines what│
│ │ │modifiers are allowed on the item. │
│ │ │Note: this is just a theory at this point, but it seems to │
│ │ │hold for the items I've examined. │
├────────┼───────┼────────────────────────────────────────────────────────────┤
│ │ │Item quality. This field can be one of the following values,│
│ │ │which determines the quality-specific bit fields that │
│ │ │follow: │
│ │ │┌───────────┬──────────────────────────────────┐ │
│ │ ││1 │low quality │ │
│ │ │├───────────┼──────────────────────────────────┤ │
│ │ ││2 │normal │ │
│ │ │├───────────┼──────────────────────────────────┤ │
│ │ ││3 │high quality │ │
│ │ │├───────────┼──────────────────────────────────┤ │
│150 │4 ││4 │magically enhanced │ │
│ │ │├───────────┼──────────────────────────────────┤ │
│ │ ││5 │part of a set │ │
│ │ │├───────────┼──────────────────────────────────┤ │
│ │ ││6 │rare │ │
│ │ │├───────────┼──────────────────────────────────┤ │
│ │ ││7 │unique │ │
│ │ │├───────────┼──────────────────────────────────┤ │
│ │ ││8 │crafted │ │
│ │ │└───────────┴──────────────────────────────────┘ │
│ │ │Thanks go to Guillaume Courtin of France for finding the │
│ │ │value of crafted items. │
└────────┴───────┴────────────────────────────────────────────────────────────┘
WARNING: DATA BELOW THIS POINT MAY CONTAIN ERRORS
Ring Data
After the above data, if the item is a ring, amulet, jewel, or charm, then it
has a 1 bit followed by three more bits. All other items (that I've seen) have
just a single 0 bit.
┌───────────────┬─────────────────────────────────────────────────────────────┐
│ Size │ Contents │
├───────────────┼─────────────────────────────────────────────────────────────┤
│ │If this bit is set, the item has one of multiple pictures │
│ │associated with it; the next field determines which picture a│
│1 │particular item uses. If this bit is 0, the next field is │
│ │absent. The picture field is used for rings, amulets, jewels,│
│ │and charms. │
├───────────────┼───────────────────────────────────┬─────────────────────────┤
│ │Picture. Optional; only present if │ │
│3 │the previous bit is 1. This field │[Ring_of_the_Leech] │
│ │chooses the particular graphic used│ │
│ │to display the ring. │ │
└───────────────┴───────────────────────────────────┴─────────────────────────┘
From this point on, my information is very iffy.
Unknown Field
┌───────────────┬─────────────────────────────────────────────────────────────┐
│ Size │ Contents │
├───────────────┼─────────────────────────────────────────────────────────────┤
│ │This bit apparently is set for certain class-specific │
│1 │Expansion Set items. It indicates the presence of the next │
│ │11-bit field. If this bit is 0, the next field is absent. │
├───────────────┼─────────────────────────────────────────────────────────────┤
│ │Credit for the discovery of this field's meaning goes │
│ │entirely to Guillaume Courtin of France. Thanks! │
│ │This field indicates magic properties which are inherent in │
│ │certain class-specific items. A given class-specific item │
│ │will (almost) always start with the same set of properties, │
│ │even if its quality is "normal". Other quality ratings may │
│11 │add more properties to the standard set. It appears that │
│ │items which will have this field are: │
│ │ │
│ │ • Amazon-only bows, spears, and javelins │
│ │ • Voodoo heads (Necromancer-only shields) │
│ │ • Paladin-only shields │
│ │ • Orbs (Sorceress-Only wands) │
└───────────────┴─────────────────────────────────────────────────────────────┘
Low Quality Item Data
If the item is one of low quality, it has 3 more bits that give the quality
details:
┌───────────────┬─────────────────────────────────────────────────────────────┐
│ Size │ Contents │
├───────────────┼────────────────────────────────────┬────────────────────────┤
│ │Quality: │ │
│ │┌──────┬───────────────────┐ │ │
│ ││0 │Crude │ │ │
│ │├──────┼───────────────────┤ │ │
│ ││1 │Cracked │ │ │
│ │├──────┼───────────────────┤ │ │
│ ││2 │Damaged │ │ │
│ │├──────┼───────────────────┤ │ │
│3 ││3 │Low Quality │ │[Crude_Heavy_Boots] │
│ │└──────┴───────────────────┘ │ │
│ │I haven't recorded any instances of │ │
│ │other values, but that doesn't mean │ │
│ │there won't be any. Also, I'm │ │
│ │certain the value has something to │ │
│ │do with mods on an item's inherent │ │
│ │(non-recorded) properties, such as │ │
│ │weapon damage, but I haven't figured│ │
│ │out yet what the correlation is. │ │
└───────────────┴────────────────────────────────────┴────────────────────────┘
Normal Item Data
Normal items have no extra quality data.
High Quality ("Superior") Item Data
If the item is one of high quality, it has 3 additional bits.
┌───────────────┬─────────────────────────────────────────────────────────────┐
│ Size │ Contents │
├───────────────┼─────────────────────────────────────────────────────────────┤
│ │unknown. I'm certain the value has something to do with mods │
│3 │on an item's inherent (non-recorded) properties, such as │
│ │weapon damage, but I haven't figured out yet what the │
│ │correlation is. │
└───────────────┴─────────────────────────────────────────────────────────────┘
Magically Enhanced Item Data
[Sturdy_Spi] Magically enhanced items have two 11-bit fields representing the
item's prefix and suffix. Either one (but not both) may be omitted. The prefix
and suffix each are used in choosing the magical enhancements for an item
(although the enhancements are modifiable), and can also increase the minimum
level required to use them item and affect the item's color.
[Mesh_Belt_]
┌───────────────┬─────────────────────────────────────────────────────────────┐
│ Size │ Contents │
├───────────────┼─────────────────────────────────────────────────────────────┤
│ │Item prefix (i.e., "Gold" or "Tangerine"). I've started a │
│11 │list of prefix identifiers, but it is very sparse at this │
│ │time. If this field is 0, the item has no prefix. │
├───────────────┼─────────────────────────────────────────────────────────────┤
│ │Item suffix (i.e., "of Greed" or "of Life"). I've started a │
│11 │list of suffix identifiers, but it is very sparse at this │
│ │time. If this field is 0, the item has no suffix. │
└───────────────┴─────────────────────────────────────────────────────────────┘
Set Item Data
Set items have a 12-bit field containing the ID of the set. (Not the set
member, but the whole set.) The set member is identified by cross-referencing
the item type with the set Id. Also note that set items have an extra field
following the item-specific data.
┌───────────────┬─────────────────────────────────────────────────────────────┐
│ Size │ Contents │
├───────────────┼─────────────────────────┬───────────────────────────────────┤
│ │Set identifier; i.e., all│ │
│ │items which are part of │ │
│ │the set will have the │ │
│ │same value in this field.│ │
│ │Since I've only │ │
│ │identified a few set │ │
│ │items, I'll give their │ │
│ │ID's here: │ │
│ │┌────┬─────────────┐ │ │
│ ││2 │Cleglaw's │ │ │
│ ││ │Brace │ │ │
│ │├────┼─────────────┤ │ │
│ ││3 │Iratha's │ │ │
│ ││ │Finery │ │ │
│ │├────┼─────────────┤ │ │
│ ││4 │Isenhart's │ │ │
│12 ││ │Armory │ │[Deaths_Hand_Leather_Gloves] │
│ │├────┼─────────────┤ │ │
│ ││6 │Milabrega's │ │ │
│ ││ │Regalia │ │ │
│ │├────┼─────────────┤ │ │
│ ││7 │Cathan's │ │ │
│ ││ │Traps │ │ │
│ │├────┼─────────────┤ │ │
│ ││11 │Berserker's │ │ │
│ ││ │Arsenal │ │ │
│ │├────┼─────────────┤ │ │
│ ││12 │Death's │ │ │
│ ││ │Disguise │ │ │
│ │├────┼─────────────┤ │ │
│ ││13 │Angelic │ │ │
│ ││ │Raiment │ │ │
│ │└────┴─────────────┘ │ │
└───────────────┴─────────────────────────┴───────────────────────────────────┘
Rare Item Data
[Loath_Song_Battle_Axe] This is by far the worst beast to decode. Rare items
have a variable number of bits before we get to the item contents, and this
number can vary anywhere from 55 to 88!
[Eagle_Mark_Amulet] Update 3/14/2002: EUREKA!! I've finally figured out the
variable fields!; See the table below.
┌───────────────┬─────────────────────────────────────────────────────────────┐
│ Size │ Contents │
├───────────────┼─────────────────────────────────────────────────────────────┤
│8 │This is the Id for the first word of the item's name (i.e., │
│ │"Stone" or "Doom"). │
├───────────────┼─────────────────────────────────────────────────────────────┤
│8 │This is the ID for the second word of the item's name (i.e., │
│ │"Finger" or "Shroud"). │
├───────────────┼─────────────────────────────────────────────────────────────┤
│1 │If this field is 1, the next 11-bit field is present. If 0, │
│ │the next field is absent. │
├───────────────┼─────────────────────────────────────────────────────────────┤
│ │First magic prefix (optional). Although this "prefix" isn't │
│11 │actually shown in the item name, it is used in determining │
│ │the magical properties, required level, coloring, and other │
│ │attributes of the rare item. │
├───────────────┼─────────────────────────────────────────────────────────────┤
│1 │If this field is 1, the next 11-bit field is present. If 0, │
│ │the next field is absent. │
├───────────────┼─────────────────────────────────────────────────────────────┤
│ │First magic suffix (optional). Although this "suffix" isn't │
│11 │actually shown in the item name, it is used in determining │
│ │the magical properties, required level, coloring, and other │
│ │attributes of the rare item. │
├───────────────┼─────────────────────────────────────────────────────────────┤
│1 │If this field is 1, the next 11-bit field is present. If 0, │
│ │the next field is absent. │
├───────────────┼─────────────────────────────────────────────────────────────┤
│11 │Second magic prefix (optional) │
├───────────────┼─────────────────────────────────────────────────────────────┤
│1 │If this field is 1, the next 11-bit field is present. If 0, │
│ │the next field is absent. │
├───────────────┼─────────────────────────────────────────────────────────────┤
│11 │Second magic suffix (optional) │
├───────────────┼─────────────────────────────────────────────────────────────┤
│1 │If this field is 1, the next 11-bit field is present. If 0, │
│ │the next field is absent. │
├───────────────┼─────────────────────────────────────────────────────────────┤
│11 │Third magic prefix (optional) │
├───────────────┼─────────────────────────────────────────────────────────────┤
│1 │If this field is 1, the next 11-bit field is present. If 0, │
│ │the next field is absent. │
├───────────────┼─────────────────────────────────────────────────────────────┤
│11 │Third magic suffix (optional) │
└───────────────┴─────────────────────────────────────────────────────────────┘
Unique Item Data
Unique items have an additional 12 bit field, which in most cases is the unique
item ID. The few exceptions are certain quest items (e.g., the Horadric Malus).
┌──────────────┬─────────────────────────────────────────────────────────────────┐
│ Size │ Contents │
├──────────────┼─────────────────────┬───────────────────────────────────────────┤
│ │Item identifier. │ │
│ │Since I've only │ │
│ │identified a few │ │
│ │unique items, I'll │ │
│ │give their ID's │ │
│ │here: │ │
│ │┌───────┬───────────┐│ │
│ ││ │Ume's ││ │
│ ││13 │Lament Grim││ │
│ ││ │Wand ││ │
│ │├───────┼───────────┤│ │
│ ││31 │Hellplague ││ │
│ ││ │Long Sword ││ │
│ │├───────┼───────────┤│ │
│ ││75 │Wormskull ││ │
│ ││ │Bone Helm ││ │
│ │├───────┼───────────┤│ │
│ ││ │Undead ││ │
│ ││ │Crown Crown││ │
│ ││77 │(no, that ││ │
│ ││ │is not a ││ │
│ ││ │typo!) ││ │
│12 │├───────┼───────────┤│[Hellplague] │
│ ││ │Goldskin ││ │
│ ││91 │Full Plate ││ │
│ ││ │Mail ││ │
│ │├───────┼───────────┤│ │
│ ││ │Nagelring ││ │
│ ││ │Ring (not a││ │
│ ││120 │typo ││ │
│ ││ │either; I ││ │
│ ││ │checked) ││ │
│ │├───────┼───────────┤│ │
│ ││123 │Amulet of ││ │
│ ││ │the Viper ││ │
│ │├───────┼───────────┤│ │
│ ││125 │Horadric ││ │
│ ││ │Staff ││ │
│ │├───────┼───────────┤│ │
│ ││126 │Hell Forge ││ │
│ ││ │Hammer ││ │
│ │├───────┼───────────┤│ │
│ ││4095 │(other; ││ │
│ ││(0xFFF)│probably a ││ │
│ ││ │quest item)││ │
│ │└───────┴───────────┘│ │
└──────────────┴─────────────────────┴───────────────────────────────────────────┘
Crafted Item Data
Crafted items appear to be coded exactly like rare items, having a rare name
(two parts) and six optional prefixes / suffixes.
┌───────────────┬─────────────────────────────────────────────────────────────┐
│ Size │ Contents │
├───────────────┼─────────────────────────────────────────────────────────────┤
│8 │This is the Id for the first word of the item's name (i.e., │
│ │"Stone" or "Doom"). │
├───────────────┼─────────────────────────────────────────────────────────────┤
│8 │This is the Id for the second word of the item's name (i.e., │
│ │"Finger" or "Shroud"). │
├───────────────┼─────────────────────────────────────────────────────────────┤
│1 │If this field is 1, the next 11-bit field is present. If 0, │
│ │the next field is absent. │
├───────────────┼─────────────────────────────────────────────────────────────┤
│ │First magic prefix (optional). Although this "prefix" isn't │
│11 │actually shown in the item name, it is used in determining │
│ │the magical properties, required level, coloring, and other │
│ │attributes of the crafted item. │
├───────────────┼─────────────────────────────────────────────────────────────┤
│1 │If this field is 1, the next 11-bit field is present. If 0, │
│ │the next field is absent. │
├───────────────┼─────────────────────────────────────────────────────────────┤
│ │First magic suffix (optional). Although this "suffix" isn't │
│11 │actually shown in the item name, it is used in determining │
│ │the magical properties, required level, coloring, and other │
│ │attributes of the crafted item. │
├───────────────┼─────────────────────────────────────────────────────────────┤
│1 │If this field is 1, the next 11-bit field is present. If 0, │
│ │the next field is absent. │
├───────────────┼─────────────────────────────────────────────────────────────┤
│11 │Second magic prefix (optional) │
├───────────────┼─────────────────────────────────────────────────────────────┤
│1 │If this field is 1, the next 11-bit field is present. If 0, │
│ │the next field is absent. │
├───────────────┼─────────────────────────────────────────────────────────────┤
│11 │Second magic suffix (optional) │
├───────────────┼─────────────────────────────────────────────────────────────┤
│1 │If this field is 1, the next 11-bit field is present. If 0, │
│ │the next field is absent. │
├───────────────┼─────────────────────────────────────────────────────────────┤
│11 │Third magic prefix (optional) │
├───────────────┼─────────────────────────────────────────────────────────────┤
│1 │If this field is 1, the next 11-bit field is present. If 0, │
│ │the next field is absent. │
├───────────────┼─────────────────────────────────────────────────────────────┤
│11 │Third magic suffix (optional) │
└───────────────┴─────────────────────────────────────────────────────────────┘
Rune Word
If the item has a rune word (indicated by bit 42 being set), there is an
additional field at this point.
┌───────────────┬─────────────────────────────────────────────────────────────┐
│ Size │ Contents │
├───────────────┼─────────────────────────────────────────────────────────────┤
│ │This appears to be an index to the rune word, although I │
│12 │can't say what the index is based on. The first rune word, │
│ │"Ancient's Pledge", has a value of 27. The next rune word, │
│ │"Black", has a value of 32. etc. │
├───────────────┼─────────────────────────────────────────────────────────────┤
│4 │Unknown; the value is 5 on all items I've looked at. │
└───────────────┴─────────────────────────────────────────────────────────────┘
Personalization
The following segment is present if and only if the item is personalized (i.e.,
bit 40 is set). Only armor and weapons (except for quest items) can be
personalized.
┌───────────────┬─────────────────────────────────────────────────────────────┐
│ Size │ Contents │
├───────────────┼─────────────────────────────────────────────────────────────┤
│7 │First character of the owner's name (just plain ASCII!) │
├───────────────┼─────────────────────────────────────────────────────────────┤
│7 │Second character of the owner's name │
├───────────────┼─────────────────────────────────────────────────────────────┤
│7 × N-2 │Repeat until you get the whole name (15 characters maximum) │
├───────────────┼─────────────────────────────────────────────────────────────┤
│7 │0 (this indicates the end of the name) │
└───────────────┴─────────────────────────────────────────────────────────────┘
Unknown Field MAYBE WROOOOONG
All items have this field between the personalization (if it exists) and the
item-specific data:
┌───────────────┬─────────────────────────────────────────────────────────────┐
│ Size │ Contents │
├───────────────┼─────────────────────────────────────────────────────────────┤
│1 │unknown; this usually is 0, but is 1 on a Tome of Identify. │
│ │(It's still 0 on a Tome of Townportal.) │
└───────────────┴─────────────────────────────────────────────────────────────┘
Item Structure part 3: Item-Specific Data
The presence of the following fields depends on the item type. Fields which are
present will be stored in the order shown. Unfortunately there is no means of
telling which fields are present from the item data itself; you need to look up
the item type in a table to figure out whether it is a weapon, armor, or stack,
and read the fields accordingly.
Armor: Defense Rating
┌───────────────┬─────────────────────────────────────────────────────────────┐
│ Size │ Contents │
├───────────────┼─────────────────────────────────────────────────────────────┤
│ │Defense value +10. i.e., a defense rating of 23 would be │
│ │stored in this field as 33; thus the maximum defense value │
│10 │you can store is 1013 (although I haven't tried it). Note │
│ │that this is the base defense rating, before applying any │
│ │magical enhancements (i.e., the number shown in white). │
└───────────────┴─────────────────────────────────────────────────────────────┘
Armor and Weapons: Durability
Even though stacked weapons don't show any durability rating in the game, they
still have two 8-bit fields in the same spot. This includes bombs (exploding
and gas potions). The values in such cases are very small, so I'm not sure what
they mean.
┌───────────────┬─────────────────────────────────────────────────────────────┐
│ Size │ Contents │
├───────────────┼─────────────────────────────────────────────────────────────┤
│ │Maximum Durability. Note that this is the base durability, │
│ │before applying any magical enhancements (i.e., the number │
│8 │shown in white). │
│ │Note: I've found an indestructable item, and it appears that │
│ │in such a case the maximum durability field is zero! │
├───────────────┼─────────────────────────────────────────────────────────────┤
│ │Current Durability. This may be greater than the maximum │
│8 │durability if the item is magically enhanced. │
│ │Note: I've found an indestructable item, and it appears that │
│ │in such a case the current durability field is missing! │
└───────────────┴─────────────────────────────────────────────────────────────┘
Armor and (non-stacked) Weapons: Sockets
The following field is present if and only if the item is socketed (i.e., bit
27 is set).
┌───────────────┬─────────────────────────────────────────────────────────────┐
│ Size │ Contents │
├───────────────┼───────────────────────────────────┬─────────────────────────┤
│ │Number of sockets │ │
│ │Note that even though this field is│ │
│ │4 bits wide, each item type has a │ │
│4 │built-in upper limit to the total │[Socketed_Mask] │
│ │number of sockets. This limit is │ │
│ │built into the game. The most I've │ │
│ │ever seen is 6 for, e.g., a gothic │ │
│ │axe. │ │
└───────────────┴───────────────────────────────────┴─────────────────────────┘
Tomes:
Tomes have an extra 5 bits inserted at this point. I have no idea what purpose
they serve. It looks like the value is 0 on all of my tomes.
┌───────────────┬─────────────────────────────────────────────────────────────┐
│ Size │ Contents │
├───────────────┼─────────────────────────────────────────────────────────────┤
│5 │unknown │
└───────────────┴─────────────────────────────────────────────────────────────┘
Stacked Weapons, Quivers, Keys, and Tomes: Quantity
┌───────────────┬─────────────────────────────────────────────────────────────┐
│ Size │ Contents │
├───────────────┼─────────────────────────────────────────────────────────────┤
│9 │Quantity │
└───────────────┴─────────────────────────────────────────────────────────────┘
Item Structure part 3: Magical Enhancements
Item Structure part 2^bis: Set Item Data Revisited
Items which are part of a set have an additional 5 bits following the
item-specific data.
┌───────────────┬─────────────────────────────────────────────────────────────┐
│ Size │ Contents │
├───────────────┼─────────────────────────────────────────────────────────────┤
│ │This appears to be an indicator of how many lists of magic │
│ │properties follows. The first list are the properties the │
│5 │item has if you do not have any other members of the set. │
│ │Following lists are applied once you equip other items in the│
│ │set. The value is 1 if there are two (total) property lists, │
│ │or 3 if there are three property lists. │
└───────────────┴─────────────────────────────────────────────────────────────┘
Following the item-specific data are a variable number of variable length bit
fields describing any magical enhancements placed on the item. Each property
begins with a 9-bit identifier. An identifier of 0x1FF (all 1's) indicates the
end of the property list ... except in the event the item belongs to a set, in
which case there will be another one or two groups of magical properties
following, depending on whether the set item data (above) is 1 or 3,
respectively. Also, if an item has been given a Rune Word, it appears that the
Rune Word's properties begin with a 0x1FF identifier (presumably to set them
apart from the item's normal properties... but I need to examine more items to
be certain.)
Because the number of bits (and fields) after the 9-bit identifier varies, I do
not give a field width here. Instead, check my table of magic properties for
field sizes. I'm sure it's not complete, but it does have most of the common
properties.
Following the last 9-bit value of 0x1FF, the rest of the final byte will be
padded with 0's if necessary, and the item structure ends there. For example,
if the item had 341 bits of data, the last (43^rd) byte will be 0x1F. If the
item had 248 bits of data, the last (31^st) byte will be 0xFF.