DayZ Helper

DayZ Helpert zorgt ervoor dat je je inventory kan bij houden en bevat een kaart.

Hoe te gebruiken

De Kaart:
Je kan met twee vingers pinch-to-zoom gebruiken om in en uit te zoomen.
De kan met een vinger de kaart verschuiven.
De gebruikte kaart komt van: dayzmap.info

De Inventory:
Je kan op het plaatje van een item drukken om meer informatie over die item te zien. De meeste wapen hebben bijvoord informatie over hoe zeldzaam het is en welke mags je nodig hebt. Ook kan je door op het plaatje te drukken bij de wiki-pagina van die item komen. Handig als de informatie die je zoekt er niet bij het item staat vermeld. Onder het plaatje zijn Plus en Min knoppen. Hiermee kan je aangeven hoeveel van dat item je bij je hebt. Dit moet je zelf bijhouden, de applicatie synchronseerd Niet met het spel!

Hoe te modden

json-bestand
De informatie staat opgeslagen in een json-bestand op de sdkaart. json is een notatie waarmee objecten kunnen worden beschreven op een manier die voor computers te lezen is, en ook redelijk goed leesbaar voor mensen. Meer informatie over json is te vinden op Wikipedia: http://nl.wikipedia.org/wiki/JSON

Het bestand is te vinden in:
/sdcard/Android/data/nl.frankkie.dayz/files/DayZHelperItems.json
Kopieer dit bestand vanaf je telefoon of tablet naar je computer, pas het aan, en plaats het terug op het apparaat. Zorg ervoor dat de applicatie niet geopent is op het moment dat je het bestand terug-plaats. Zorg er ook voor dat het bestand nog precies hetzelde heet, anders kan de applicatie het bestand niet vinden. Zorg er ook voor dat je geen fouten maakt in het json-bestand anders kan de applicatie crashen! Om te controleren of er geen fouten in het bestand zitten kan je de inhoud van het bestand plakken op http://jsonlint.com/. Als er geen fouten in zitten zal de website de melding 'Valid JSON' geven.

Plaatjes
Plaats plaatjes in dezelfde map (/sdcard/Android/data/nl.frankkie.dayz/files/). Hoe de bestanden heten maakt niet uit, de plaatjes moeten een afmeting hebben van 256x256 pixels. Dit is belangrijk, want anders geeft de applicatie de plaatjes verkeerd weer. Het mogen png of jpg plaatjes zijn.

Items toevoegen aan het bestand:
Laten we het bekijken aan de hand van een voorbeeld:


  {
        "cat": "Medical",
        "class": "nl.frankkie.dayz.DayZItem",
        "id": 0,
        "image": "Item_Bandage.png",
        "isFavo": false,
        "locations": [

        ],
        "magInfo": null,
        "name": "Bandage",
        "number": 1,
        "rarity": "",
        "url": "http://www.dayzwiki.com/wiki/Bandage",
        "weaponInfo": null
    },

Een object begint met een '{' en eindig met een '}'. Als het niet het laatste item is komt er een ',' achter. Let op: Alle velden en waardes zijn hoofdlettergevoelig!
Een item bevat altijd de velden:

cat: dit is dat categorie, wordt gebruikt bij het filteren. De mogelijke waardes zijn: 'Medical', 'Food', 'Weapon', 'Ammo', 'Other'.
class: dit wordt gebruikt door de app, is altijd: 'nl.frankkie.dayz.DayZItem".
id: dit is een uniek nummer, wordt (nog) niet gebruikt door de app.
image: Vul hier de naam van het plaatje-bestand in.
isFavo: mogelijke waardes: 'true' (is favoriet) en 'false' (is niet favoriet)
itemType: mogelijke waardes: "item" (gewoon item), "weapon" (wapen) en "ammo" (mags). Wordt niet gebruikt door de app, je kan het weglaten.
locations: dit is een lijst van lokaties waar dit item voorkomt. '[ ]' is een lege lijst. '["plek1", "plek2"]' is een lijst met 2 lokaties.
magInfo: wat voor Mag dit item is. Gebruik 'null' als dit item geen Mag is. Voorbeeld voor Mag volgt hieronder.
name: De naam voor dit item, is zichtbaar voor de gebruiker in de app.
number: hoeveel je er hebt van dit item
rarity: Hoe zeldzaam dit is, bijvoorbeeld: 'Rare'. of "" (lege quotes) als het niet weet.
url: De url naar de Wiki-pagina.
weaponInfo: extra informatie die alleen van toepassing is op wapens. of 'null' als dit geen wapen is.

Voor wapens ziet het er zo uit:


{
        "cat": "Weapon",
        "class": "nl.frankkie.dayz.DayZItem",
        "id": 18,
        "image": "Weapon_Revolver.png",
        "isFavo": false,
        "locations": [
            "Residential/Civilian"
        ],
        "magInfo": null,
        "name": "Revolver",
        "number": 0,
        "rarity": "Common",
        "url": "http://www.dayzwiki.com/wiki/Revolver",
        "weaponInfo": {
            "attachments": [

            ],
            "class": "nl.frankkie.dayz.DayZWeapon",
            "damage": 1389,
            "effectiveRange": 100,
            "fireModes": [
                "Semi"
            ],
            "fireRate": "",
            "mags": [
              "M1911 Mag", ".45 ACP"
            ],
            "noise": "Moderate",
            "recoil": "High",
            "shotsToKill": "body:3, head:1",
            "weaponType": "Sidearms",
            "zeroing": "No"
        }
    },

Een wapen heeft dezelfde velden als een gewoon item maar dan ook een weaponInfo gedeelte.

attachments: een lijst met attachments, '[ ]' is een lege lijst.
class: dit moet alijd 'nl.frankkie.DayZWeapon' zijn.
damage: vul hier in hoeveel schade dit wapen doet.
effectiveRange: de afstand waarbinnen dit wapen effectief is
fireModes: lijst met modi
fireRate: hoe snel het wapen vuurt.
mags: lijst van mags die passen in dit wapen, naam moet exact gelijk zijn aan naam van een bestaande mag in je inventory, dan zie je namelijk bij het wapen hoeveel mags je nog hebt.
noise: hoeveel herrie dit wapen maakt
recoil: de terugslag.
shotsToKill: hoeveel schoten nodig zijn voor een kill
weaponType: wat voor type wapen het is
zeroing: of het wapen wel of niet zeroing heeft. "No" als dat niet zo is, "Yes" als dat wel zo is.

Een Mag wordt zo gemaakt:


{
      "cat": "Ammo",
      "class": "nl.frankkie.dayz.DayZItem",
      "id": 29,
      "image": "Ammo_M1911_Mag.png",
      "isFavo": false,
      "itemType": "ammo",
      "locations": ["Residential", "Civilian"],
      "magInfo": {
        "class": "nl.frankkie.dayz.DayZMag",
        "caliber": "11.43x23mm",
        "magSize": 7
      },
      "name": "M1911 Mag",
      "number": 0,
      "rarity": "Common",
      "url": "http://www.dayzwiki.com/wiki/M1911_Mag",
      "weaponInfo": null
    }

Credits

De plaatjes en de informatie in de applicatie komen van:
http://www.dayzwiki.com/wiki/

De kaart komt van:
http://dayzmap.info/

Verder maakt de applicatie gebruik van FlexJson om het json-bestand te kunnen lezen, zie:
http://flexjson.sourceforge.net/

Changelog

Version 1.0.2 (3):
Android 2.2 support (was eerst alleen 4.0+)
added mags
added more weapons (complete)
images in een andere map gezet xodat ze niet in Gallery meer komen (hoop ik)

Wil je meer info, of heb je een spelfout gevonden?
twitter me: @frankkienl
mail me: frankkie12345 AT gmail DOT com
Youtube me: frankkie12345
Formspring me: frankkie12345
Facebook me: frankkie12345
Blog-comment me: Blog-link