gm:navody:freeperks [Wiki]

Freeperks je systém garantování perků zdarma podle nastavených předpokladů.

Systém funguje tak že při otevření gumpu perků (a při několika dalších situacích) prověří nároky na perk zdarma.
Pokud má nárok na perk nebo na výběr ze skupiny perků, bude mu příslušný perk nastaven na danou úroveň.
Pokud už perk má, začne se mu počítat jako perk zdarma (až do nastavené úrovně).
Pozor: Změnou požadavků nebo odstraněním perku ze souboru perk hráčům nezmizí. Pouze se jim začne počítat cena jako by se ho naučili.

Pro nastavování systémů slouží soubor „FreePerks.xml“.
Vzorový příklad:

<?xml version="1.0" encoding="utf-8" ?>
<FreePerks>
  <FreePerk GrantedPerk="UseLightArmor" GrantedPerkLevel="4"   Profession="Warrior, Rogue, Ranger, Bard, AllPriests"/>
  <FreePerk GrantedPerk="UseMediumArmor" GrantedPerkLevel="4"  Profession="Warrior"/>
  <FreePerk GrantedPerk="Thug" GrantedPerkLevel="1"            Profession="Warrior"/>
  
  <FreePerk GrantedPerk="StealthCamouflage" GrantedPerkLevel="1" Group="StealthPerks" Skills="Stealth=1">
    <SubPerk GrantedPerk="StealthCamouflage" GrantedPerkLevel="2" Group="StealthPerks" Level="12" Skills="Stealth=1">
        <SubPerk GrantedPerk="StealthCamouflage" GrantedPerkLevel="3" Group="StealthPerks" Level="24" Skills="Stealth=1">
            <SubPerk GrantedPerk="StealthCamouflage" GrantedPerkLevel="4" Group="StealthPerks" Level="36" Skills="Stealth=1"/>
        </SubPerk>
    </SubPerk>
  </FreePerk>
  
  <FreePerk GrantedPerk="StealthOdorMasking" GrantedPerkLevel="1" Group="StealthPerks" Skills="Stealth=1">
    <SubPerk GrantedPerk="StealthOdorMasking" GrantedPerkLevel="2" Group="StealthPerks" Level="12" Skills="Stealth=1">
        <SubPerk GrantedPerk="StealthOdorMasking" GrantedPerkLevel="3" Group="StealthPerks" Level="24" Skills="Stealth=1">
            <SubPerk GrantedPerk="StealthOdorMasking" GrantedPerkLevel="4" Group="StealthPerks" Level="36" Skills="Stealth=1"/>
        </SubPerk>
    </SubPerk>
  </FreePerk>

  <FreePerk GrantedPerk="StealthSilentMove" GrantedPerkLevel="1" Group="StealthPerks" Skills="Stealth=1">
    <SubPerk GrantedPerk="StealthSilentMove" GrantedPerkLevel="2" Group="StealthPerks" Level="12" Skills="Stealth=1">
        <SubPerk GrantedPerk="StealthSilentMove" GrantedPerkLevel="3" Group="StealthPerks" Level="24" Skills="Stealth=1">
            <SubPerk GrantedPerk="StealthSilentMove" GrantedPerkLevel="4" Group="StealthPerks" Level="36" Skills="Stealth=1"/>
        </SubPerk>
    </SubPerk>
  </FreePerk>

  <FreePerk GrantedPerk="StealthLightSteps" GrantedPerkLevel="1" Group="StealthPerks" Skills="Stealth=1">
    <SubPerk GrantedPerk="StealthLightSteps" GrantedPerkLevel="2" Group="StealthPerks" Level="12" Skills="Stealth=1">
        <SubPerk GrantedPerk="StealthLightSteps" GrantedPerkLevel="3" Group="StealthPerks" Level="24" Skills="Stealth=1">
            <SubPerk GrantedPerk="StealthLightSteps" GrantedPerkLevel="4" Group="StealthPerks" Level="36" Skills="Stealth=1"/>
        </SubPerk>
    </SubPerk>
  </FreePerk>

  <FreePerk GrantedPerk="Pyrophor" GrantedPerkLevel="1" Skills="Explosives=30">
    <SubPerk GrantedPerk="Pyrophor" GrantedPerkLevel="2" Skills="Explosives=50">
      <SubPerk GrantedPerk="Pyrophor" GrantedPerkLevel="3" Skills="Explosives=75">
        <SubPerk GrantedPerk="Pyrophor" GrantedPerkLevel="4" Skills="Explosives=100">
        </SubPerk>
      </SubPerk>
    </SubPerk>
  </FreePerk>

  <Group Group="StealthPerks" GrantedPerks="2" Description="Skupina perků nastavující vliv dovednosti Plížení. Tyto perky obdržíš na 1. úrovni, každý dvanáctý level se zvýší. Dobře si rozmysli svoji volbu! Doporučené nastavení: Kamufláž + Tichý krok proti humanoidům, nebo Tichý krok + Zakrytí pachu proti zvěři." Skills="Stealth=1"/>
</FreePerks>

Popis prvků:
<FreePerk /> je nastavení jaký perk a za jakých okolností hráč obdrží. Parametry:
- GrantedPerk=„?“ = udělený perk. (povinná položka)
- GrantedPerkLevel=„?“ = level uděleného perku. (povinná položka)
- Race=„?“ = podmínka udělení perku, rasa. Více ras se odděluje čárkou. Pozor, ork je „Ogre“.
- Profession=„?“ = podmínka udělení perku, povolání postavy. Více povolání se odděluje čárkou. Pozor u kněze: Poustevník je „Priest“, konkrétní kněz je např. „HelmPriest“, všichni kněží jsou „AllPriests“.
- Skills=„?“ = podmínka udělení perku, dovednost postavy. Zápis je „skill=hodnota“ (bez mezer), více požadavků se odděluje čárkou.
- Level=„?“ = podmínka udělení perku, level postavy.
- Stats=„?“ = podmínka udělení perku, staty postavy. Staty se zapisují zkratkou nebo plným názvem: Str (Strengh), Dex (Dexterity), Int(Inteligence). Zápis je „stat=hodnota“, více statů se odděluje čárkou.
- Group=„?“ = skupina do které perk patří. Detaily viz. vysvětlení skupin níž. Lze použít parametr „true“ = perk bude zahrnut do skupiny „General“. (zatím nevyužito) Pozor: Pokud je perk zahrnut do nějaké skupiny, pak se ho lze naučit pouze v rámci dané skupiny. Jinak se nezobrazí ani nepřiřadí, a to i kdyby hráč splňoval jeho požadavky.

<SubPerk /> je rozvinutí daného perku.
Jeho parametry jsou zcela stejné jako parametry FreePerku. Subperk může rozvíjet i jiný SubPerk.
Příklad 1: Postupný růst perku Pyrofor podle úrovně dovednosti Výbušniny. Hráč dostane 1. úroveň při dovednosti 30, 2. při 50, další při 75 a poslední při 100.

  <FreePerk GrantedPerk="Pyrophor" GrantedPerkLevel="1" Skills="Explosives=30">
    <SubPerk GrantedPerk="Pyrophor" GrantedPerkLevel="2" Skills="Explosives=50">
      <SubPerk GrantedPerk="Pyrophor" GrantedPerkLevel="3" Skills="Explosives=75">
        <SubPerk GrantedPerk="Pyrophor" GrantedPerkLevel="4" Skills="Explosives=100">
        </SubPerk>
      </SubPerk>
    </SubPerk>
  </FreePerk>

Příklad 2: Kombinace perků: Hráč dostane perk Pyrofor 1 při dovednosti Výbušniny 30. Navíc pokud splní i podmínku SubPerku, dostane perk Použití těžké zbroje 1.

  <FreePerk GrantedPerk="Pyrophor" GrantedPerkLevel="1" Skills="Explosives=30">
    <SubPerk GrantedPerk="UseheavyArmor" GrantedPerkLevel="1" Stats="Str=100, Dex=50" />
  </FreePerk>

Příklad 3: Kombinace perků může jít i do víceúrovňového stromečku. Pozor, pokud hráč splní všechny podmínky, dostane vše co stromeček nabízí.

  <FreePerk GrantedPerk="Pyrophor" GrantedPerkLevel="1" Skills="Explosives=30">
    <SubPerk GrantedPerk="UseHeavyArmor" GrantedPerkLevel="1" Stats="Str=100, Dex=50">
        <SubPerk GrantedPerk="UseHeavyArmor" GrantedPerkLevel="2" Skills="BlackSmith=100" />
    </SubPerk>
    <SubPerk GrantedPerk="UseMediumArmor" GrantedPerkLevel="1" Stats="Str=50, Dex=100">
        <SubPerk GrantedPerk="UseMediumArmor" GrantedPerkLevel="2" Race="Dwarf, Ogre" />
    </SubPerk>
  </FreePerk>

<Group /> je skupina perků, které postava po splnění podmínek dostane k nabídnutí. Z nich se může daný počet naučit.
Parametry jsou shodné s Freeperkem, s tímto rozšířením:
- Group=„?“ = název skupiny. Do skupiny budou pro výběr nabídnuty všechny FreePerky, které mají označení Group s názvem této skupiny. (povinný parametr)
- GrantedPerks=„?“ = kolik perků ze skupiny si lze vybrat. (povinný parametr)
- Description=„?“ = popis skupiny, zobrazovaný při nabídce perků k výběru.
Pozor, skupiny (zatím) nepodporují podskupinu (ala SubPerk) ani stromečkování.

Příklad: Hráč který má Plížení alespoň 1, dostane k nabídce všechny FreePerky s nastavenou skupinou „StealthPerks“. Vybrat si z nich může 2:

  <Group Group="StealthPerks" GrantedPerks="2" Description="Skupina perků nastavující vliv dovednosti Plížení. Bla bla bla...." Skills="Stealth=1"/>

(zápisu perků se skupinou viz. vzorový příklad nahoře)