Itemshop v2 Dokumentation

Inhalt
Kategorie erstellen.................................................................................................................................2
Item........................................................................................................................................................4
Item einfgen.....................................................................................................................................4
Item Einstellungen..............................................................................................................................4
id.....................................................................................................................................................4
category_id.....................................................................................................................................4
vnum...............................................................................................................................................4
shop................................................................................................................................................4
price................................................................................................................................................4
socket0 5......................................................................................................................................5
attrtype0 6...................................................................................................................................5
attrvalue0 6.................................................................................................................................5
percent...........................................................................................................................................5
end_date........................................................................................................................................5
after_run_out.................................................................................................................................6
bought............................................................................................................................................6
Banner....................................................................................................................................................6
Banner einfgen.................................................................................................................................6
Banner wechseln................................................................................................................................7
Banner Einstellungen..........................................................................................................................7
folder .............................................................................................................................................7
time................................................................................................................................................7
timeToFade & interval ...................................................................................................................7
banner_0 & banner_1.....................................................................................................................7
Sonstiges................................................................................................................................................7
COINS KAUFEN Button....................................................................................................................7
Texte ndern......................................................................................................................................8
Meist gekauft *Trick*.........................................................................................................................8
Meist gekauft zurcksetzen................................................................................................................9

Kategorie erstellen
ffne die Datei:
root/uiitemshop_v2.py
Suche nach:
## Item/voteshop category options
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.

## Item / voteshop category options

categorys = {
'itemshop': [
['Geiststeine', 1],
['Haustiere', 2],
['Mounts', 3],
['Buff-Items', 4],
['Veredelung', 5],
['Biologenitems', 6],
['Fertigkeiten', 7],
['Sonstiges', 8],
['Rstung', 9],
['Waffen', 10],
['Schmuck', 11],
],
'voteshop': [
['Sonstiges', 7],
['Haustiere', 8],
['Reittiere', 9],
],
'achievementshop': [
['Waffis', 7],
['Haustiereies', 8],
['Reittiereies', 9],
],
}

Hier stehen nun die Kategorie Namen und die zugehrige Kategorie ID.
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.

categorys = {
'itemshop': [
['Kategorie Name', Kategorie ID],
]
'voteshop': [
['Kategorie Name', Kategorie ID],
],
'achievementshop': [
['Kategorie Name', Kategorie ID],
],
}

Die Kategorie ID wird in der MySQL Tabelle itemshop in der Spalte category_id verwendet, um
die Kategorie fr das jeweilige Item zu identifizieren. Da die Shops untereinander noch einmal durch
die Spalte shop differenziert werden, ist es nicht ntig fr jeden Shop andere Kategorie IDs zu
verwenden.

Die Kategorie ID kann frei vergeben werden, jedoch sollte keine Kategorie ID in demselben Shop
mehrfach vorkommen.
Beispiel:
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.

categorys = {
'itemshop': [
['Waffen', 1],
['Ruestungen', 2],
['Schwerter', 56],
]
'voteshop': [
['Sonstiges', 1],
],
'achievementshop': [

11.
12.
13.
14.

['Esel', 1],
['Eseldummer', 56],
],
}

Achtung!
Nachdem eine neue Kategorie eingefgt wurde, mssen die User dementsprechend patchen
root um in Ihrem Client die Kategorie angezeigt zu bekommen.

Item
Item einfgen
Ein neues Item kann in der MySQL Tabelle itemshop eingefgt werden.
Beispiel Ablauf:
1. Neuen Eintrag hinzufgen
2. vnum (Item Vnum) eingeben
3. price (Preis) eingeben
4. category_id (Kategorie ID) eingeben
5. shop (Shopart) festlegen
Mehr wird zum Erstellen eines neuen Items nicht zwingend bentigt.

Item Einstellungen
id
Gibt den Index des eingetragenen Items an.
Die id wird automatisch festgelegt, hier muss kein Wert eingetragen werden.

category_id
Gibt an in welcher Kategorie sich das Item befindet.
Die category_id ist die Zahl, welche in der root/uiitemshop_v2.py bei dem jeweiligen
Kategorienamen eingestellt wurde.
Siehe dazu: Kategorie erstellen

vnum
Gibt die Vnum fr das Item an.

shop
Gibt an in welchem Shop sich das Item befindet.
Siehe dazu: Kategorie erstellen

price
Gibt den Preis fr das Item an.

socket0 5
Geben die Sockets fr das Item an.
Hier kann z.B. fr ein Pet oder Lolli Item die Zeit eingestellt werden.
Dazu einfach mal die MySQL Tabelle item aufrufen und schauen welche Sockets gesetzt werden bei
einem Pet Item. Sollte socket0 sein wo eine Zeit eingetragen wird. Bei Mounts glaube socket2.

attrtype0 6
Geben die Boniarten an.
Die Boniarten knnen hier festgelegt werden.
Beispiel fr 2000 TP:
attrtype0 = 1
attrvalue0 = 2000
Siehe auch:
attrvalue0 6

attrvalue0 6
Geben die Boniwerte an.
Die Boniwerte knnen hier festgelegt werden.
Beispiel fr 2000 TP:
attrtype0 = 1
attrvalue0 = 2000
Siehe auch:
attrtype0 6

percent
Gibt den Rabatt fr das Item in % an.
Das Item wird dann mit einem Rabattschild gekennzeichnet.
Beispiel:
Der Wert wird auf 50 gesetzt, dann entspricht der Preis automatisch 50% von dem eingetragenen
Preis in price. Bei 100 Coins dann also 50 Coins nurnoch.
Siehe auch:
end_date
after_run_out

end_date
Gibt an wie lange das Item im verfgbar sein soll.
Siehe auch:
after_run_out
percent

after_run_out
Gibt an ob das Item nach Ablauf der angebenden Zeit in end_date weiterhin zum Kauf zur
Verfgung stehen soll oder nicht.
Ein Szenario dafr wre zum Beispiel:
Es wurde ein Item mit 50% Rabatt bis Montag reingestellt.
after_run_out = BUYABLE
Nach Ablauf der Zeit steht das Item mit dem Normalpreis wieder zur Verfgung.
after_run_out = NOT BUYABLE
Nach Ablauf der Zeit steht das Item nichtmehr zur Verfgung.
Siehe auch:
end_date
percent

bought
Gibt an wie oft ein Item gekauft wurde.
Dieser Wert wird automatisch gesetzt.
Aus den Werten wird die Anzeige fr die Meist gekauften Items im Itemshop erstellt.
Siehe auch:
Meist gekauft *Trick*
Meist gekauft zurcksetzen

Banner
Banner einfgen
ffne den standartmig festgelegten Pfad:
locale/de/ui/itemshop/banner
Ein neues Banner wird hinzugefgt, indem es in den festgelegten Pfad eingefgt wird.
Der Name sollte so gewhlt werden, dass dieser spter auch in der Datenbank zu identifizieren ist.
Bannermae: 553x242
Format: JPEG
Der Banner muss nun noch in der MySQL Tabelle itemshop_banner hinzugefgt werden.
Dafr mssen die beiden Spalten bearbeitet (Strg+D) werden und ein neuer Enum Wert, mit dem
Namen des Banners, hinzufgt werden. Danach steht er dort zur Auswahl.
Beispiel:
1. Banner im Client hinzufgen mit dem Namen: feuer_20_rabatt.jpg
2. Dann wird als neuer Enum Wert in der MySQL Tabelle itemshop_banner in beiden Spalten
feuer_20_rabatt hinzugefgt.
3. In der MySQL Tabelle itemshop_banner den gewnschte Bannernamen auswhlen.
Achtung!
Nachdem ein neues Banner eingefgt wurde, mssen die User dementsprechend patchen locale
um ihn in Ihrem Client zu haben, sodass er fr sie angezeigt wird.

Banner wechseln
Die Banner knnen in der MySQL Tabelle itemshop_banner in den Spalten banner_0 und
banner_1 gewechselt werden.

Banner Einstellungen
ffne die Datei:
root/uiitemshop_v2.py
Suche nach:
## Banner options
1.
2.
3.
4.
5.
6.
7.
8.
9.

## Banner options
bannerOptions = {
'folder': 'locale/de/ui/itemshop/banner/',
'time': 5,
'timeToFade': 0.04,
'interval': 0.05,
'banner_0': 'banner_0',
'banner_1': 'banner_1',
}

Hier stehen nun die verfgbaren Banner Optionen welche bearbeitet werden knnen.

folder
Gibt den Dateipfad an, wo die Banner Bilder im Client gespeichert sind.

time
Gibt die Zeit in Sekunden an, bis er zum nchsten Banner berspringt.

timeToFade & interval

Bestimmen die Geschwindigkeit des bergangseffekts.

banner_0 & banner_1

Geben den Bannernamen an. Da diese aber durch die Datenbank festgelegt werden, knnen diese
beiden Eintrge ignoriert werden.

Sonstiges
COINS KAUFEN Button
Suche nach:
## Buy coins
1.
2.
3.
4.

## Buy coins
link = {
'buyCoins': URL
}

Hier kann der aufgerufene Link zum Kaufen der Coins bearbeitet werden.
Beispiel:
5.
6.
7.
8.

## Buy coins
link = {
'buyCoins': http://www.google.de
}

Texte ndern
Text
Itemshop Titel

Datei
uiscript/itemshop_v2.py

Suche nach
"name":"TitleName"

Startseite

uiscript/itemshop_v2.py

"name" : "btn_startpage"

Itemshop

uiscript/itemshop_v2.py

"name" : "btn_itemshop"

Voteshop

uiscript/itemshop_v2.py

"name" : "btn_voteshop"

Achievementsh
op

uiscript/itemshop_v2.py

"name" : "btn_achievementshop"

"HEIE
ANGEBOTE

uiscript/itemshop_v2.py

"name" : "tx_hotOffers"

MEIST
GEKAUFT

uiscript/itemshop_v2.py

"name" : "tx_mostBought"

COINS
KAUFEN

uiscript/itemshop_v2.py

"name" : "btn_buy_coins"

STK.

uiscript/itemshop_v2_ite
mbox.py
uiscript/itemshop_v2_ite
mbox.py
root/uiitemshop_v2.py
root/uiitemshop_v2.py

"name" : "tx_itemAmountText"

root/uiitemshop_v2.py

self.lb_0.SetText

Kaufen
Abgelaufen
Moechtest du
xx fr xx
kaufen?
Laden

"name" : "btn_buy"

Bearbeiten
"text" :
"ITEMSHOP
"text" :
"Startseite
"text" :
"Itemshop
"text" :
"Voteshop
"text" :
"Achievemen
tshop
"text" :
"HEIE
ANGEBOTE
"text" :
"MEIST
GEKAUFT
"text" :
"COINS
KAUFEN
"text" :
"STK."
"text" :
"Kaufen"

self.countdown.SetText
self.itemBuyQuestionDialog.SetTex
t

Meist gekauft *Trick*

Die Anzeige fr die Meist gekauften Items kann manipuliert werden, indem in der MySQL Tabelle
itemshop in der letzten Spalte bought bei einem bestimmten Item ein hoher Wert eingegeben
wird.
Die Spalte bought gibt an wie oft ein Item gekauft wird. Dies geschieht in der Regel automatisch.

Meist gekauft zurcksetzen

Folgende Query in der MySQL Tabelle itemshop ausfhren um die Spalte bought bei jedem Item
auf 0 zu setzen:
UPDATE `itemshop` set bought = 0;