Difference between revisions of "Piñata Vision barcode/Accessory bits"

Latest revision as of 08:43, 1 May 2011

Accessories can be found in the 1900-2000s range of the ID table. There appear to be less than 256 accessories in-game, and the accessory data does in fact code the accessory items as 8-bit values.

Encoded (8-bit) accessory item values are normalized PlaceTag IDs. (E.g., item 1 is PlaceTag ID 1905, item 2 is 1906, and so on.)

Accessories with color choices also have a 4-bit encoded color value. (Refer to the Encoded data for accessories.)

Although the village shop limits purchases to 5 accessories per pinata, six-accessory cards do exist. It's possible that cards could be generated with accessories for each possible slot.

Payload type

While it is possible to encode accessory details by supplying (accessory PlaceTagIDs in) successive ID payloads (see themed card sets), this is generally less compact than using the accessory payload. Payload type 11101 is the preferred method of encoding accessory details (and also supports specifying accessory colors).

Accessory data

The optional accessory data is variable length, starting off with a 4-bit color accessory count, followed by that number of 8-bit accessory item and 4-bit color values. A second 4-bit count (for default color accessories) indicates the number of additional 8-bit accessory item values.

Location of accessory data

Accessory data generally starts in row 1, immediately after the ID data.

Sample encoded data

The encoded data for the Parrybo Congo card looks like this:

¹(4-bit) count of color accessories, i.e., one item and color value follows.

²The (8-bit) item value of the accessory, i.e. 53 (or Bushy Mustache)

³The preceeding item's (4-bit) color choice, i.e. 12 (or Black)

⁴(4-bit) count of (remaining) accessories (with no color details), i.e. one additional accessory

⁵The (8-bit) item value of the accessory, i.e. 15 (or Pillager's Helmet)

Decoding accessory data

An easy way to spot accessoried pinatas at VivaPinata.com is to check how many barcode rows are on the card. A player-created card with 3 rows definitely has 5 or more accessories. A player-created non-wildcard non-variant card with 2 rows definitely has accessories. (A normal pinata without accessories has a 1 row barcode.)

EaglairVariant1     	00011000                     24         Yee-Haw Spurs
MoojooRussia        	01000110                     70		Squazzil Hat
Twingersnap0D00FC0E1	00100111 01011000            39  88	Tussle Tricorn, Blackeye Patch
ParryboPeru         	01010011 01110000            83 112	Bling Earrings, Bling Nose-Ring
MacaraccoonWildcard1	01100000 10000111            96 135	Von Ghoul Helmet, Non-Resident Scarf
BunnycombPV         	00111001 01000001 00101111   57  65  47	Beaded Wig, Big Jolly Lips, Butcha's
DoenutPV            	10100111 01010111 01111011  167  87 123	Tail Bow, Eighties Watch, Edo Wig
SweetlePV           	00101101 01010010 10010101   45  82 149	Clockwork Key, Halloween Bolts, Sweaty Wrist Band

VulchurroUSA        	01011011 01111010            91 122	Cook Hat, Reading Glasses
VulchurroVariant3   	01111010 01011011           122  91	Reading Glasses, Cook Hat

3F5A88CD1408B374C1EA	00110001 01010000 01100111   49  80 103	Conga's Top Hat, Toff Monocle, Secret Agent Bowtie
PengumC13B26F2140937	01010000 00110001 01100111   80  49 103	Conga's Top Hat, Secret Agent Bowtie, Toff Monocle

Reader script

Since the standard color values and accessory items names are now known, it's a simple matter to convert accessory data to human-readable colors and names.

% ./barcodetxt2bitdiff.pl --short --accessory | ./reader.pl --parse --verbose
10-CrowlaPV         	2	A3EAE49C5B162AAAEBE5E52221BD97AAB71175819A00A742
 00000: Start of data
 00001/ID: 27
 11101/Accessory: 2 items Red Non-Resident Scarf, Gold Medal
 00111/Name: Dark Heart
 00000: End of data

Cluckles2FA0CA8B1409	5	E07B798438D90A70965D91904833CD2CC78875735A2DC646
 00000: Start of data
 00001/ID: 22
 11101/Accessory: 5 items Yellow Romance Earrings, Traditional Watch, Romantic Flower, Golden Necklace, Dellmonty
 10110/Reuse: 00001
 11000/UseCost: 83000000
 01001/Wildcard: 1
 00000: End of data

...

Sample of cards with accessories

This is an incomplete list of cards where scanned pinatas are wearing accessories. Most of the cards are official versions released by Rare before the launch of Trouble in Paradise. (Recognized by a SpeciesPV name, and a picture of 3 accessories on the front of the card.) A few of the cards are date-locked, while the remaining cards are player-created from VivaPinata.com.

In addition to having accessories, pinatas may be variants and/or wildcards, or even have pinata names (Rare-only) encoded in the data.

The order of the accessories must exactly match the Journal accessories list, seen when viewing the scanned pinata's information. (Likewise, the variant numbering is from the Journal, not the wiki.)

The more accurate data we can collect for cards from the same obfuscation set, the more likely we can decode the underlying accessory data, and start to read accessory details from future/other cards.