Создаём собственные квесты (часть 2)

Хроники        Interlude
/ Z! y' C$ a2 rСборка        L2j
, m! ]- z% g4 H1 ^' n7 E0 b! HОбратите внимание: в файле htm стартового NCP обязательно должна быть ссылка на квест:

1. STARTED.addQuestDrop(KELTIR_NPC_ID,FANGS_ITEM_ID,DROP_RATE)

Скопировать код

Для этого квеста больше ничего не надо. Все необходимое для корректной работы квеста уже добавили. Вот полный текст квеста:
! U0 `9 h; t# |0 I
4 r4 [8 c& M9 ?% K1 j

1. if getCount(st) >= 4 :
   - k0 F5 G, ]5 A- E3 |9 `# Z4 P
2. completed(st)
   
3.   return
   
4. 
   
5. class Quest (JQuest):
   
6.   def __init__(self,id,name,descr): JQuest.__init__(self,id,name,descr)
   
7.   def onEvent (self,event,st):
   
8. id = st.getState()
   
9. if   id == CREATED  : st.setState(STARTED)
   % |$ t) y6 X& S/ ]# }: ~$ W" f
10. elif id == COMPLETED: pass
    
11. elif id == STARTED  : check(st)
    5 v2 m! K; b5 ~- w) u1 [
12. return
    
13. 
    
14. QUEST     = Quest(201,"Tutorial", "Tutorial quest")
    , x. k3 j* Q7 g' k, n" t
15. CREATED   = State('Start',     QUEST)
    / q! L; M3 [$ p, ~# b
16. STARTED   = State('Started',   QUEST)
    ; v/ m3 r) `2 ~4 s' m9 m" g9 D
17. COMPLETED = State('Completed', QUEST)
    
18. 
    
19. QUEST.setInitialState(CREATED)
    
20. QUEST.addStartNpc(7056)
    
21. STARTED.addQuestDrop(KELTIR_NPC_ID,FANGS_ITEM_ID,DROP_RATE)

Скопировать код

Теперь рассмотрим, как это работает.
0 |9 v: N0 R" U/ y5 }% xИгрок подходит к начальному NCP (в данном случае 7056), нажимает на «Quest». Квест будет создан и состояние квеста перейдет к CREATED и игроку будет показана страничка Start.htm с описанием квеста. Тогда метод onEvent, поле открытия странички Start.htm переведет состояние квеста в STARTED и игроку будет показана страничка Started.htm, где будет опсание того, как найти keltirs и .т.д.


При состоянии STARTED будет зарегистрирован дроп «fangs» при убийстве keltirs. Игрок может вернуться к стартовому NCP и спросить о квесте – метод onEvent будет вызван снова. Если у игрока не хватает необходимого количества предметов, то метод check() не переведет квест в следующее состояние и Started.htm будет показана снова. Но если игрок собрал необходимее количество предметов (в данном случае 4 клыка), то метод check() вызовет метод completed() который переведет квест в новое состояние COMPLETED, заберет все клыки, даст карту мира, т.к. это награда за квест, покажет Completed.htm и завершит квест.

. a6 L. U1 B9 G
/ C9 s+ r% G) eТеперь давайте сделаем наш квест более похожим на то, что он должен из себя представлять.
& b$ J5 B* l4 y2 k' PПрежде всего у нас есть 3 метода для объявления их в Яве – onTalk, onKill и onEvent. Если методы onTalk и onKill не объявлены, то за них все будет делать метод onEvent, т.е. определять квестовых монстров и вызывать диалоги NCP. Есть примечание, методы onTalk и onKill будут вызывать только диалоги с NCP в зависимости от текущего состояния квеста. Метод onKill будет вызываться только тогда, когда мы убиваем квестового монстра.


7 w3 ?1 \  G- _9 xДавайте рассмотрим как вызывается метод onKill при убийстве keltir в состоянии квеста STARTED:

1. STARTED.addKillId(KELTIR_NPC_ID)

Скопировать код

и метод onKill в классе Quest:
$ U' Y  H; z9 h, ~3 u. v

1. class Quest (JQuest):
   & @7 b$ Y0 y' A$ [! n
2.   ...
   
3.   def onKill (self,npcId,st):
   # y' }$ Y/ n: i! H
4. if npcId == KELTIR_NPC_ID:
   
5.    n = getCount(st)
   
6.    if   n == 0:
   $ @  [7 b1 n( J- m! ]7 |
7.        return "Chat0.htm"
   
8.    elif n == 1:
   . Z* @; Y+ k: g- O
9.        return "Chat1.htm"
   
10.    elif n >= 4:
    
11.        return "Chat4.htm"
    . g2 o% U* x. c
12.    return "Collected "+str(n)+" of 4 fangs"
    % {% F" a, f. I. d- J* \
13. return

Скопировать код

Метод onKill (а так же метод onTalk) имеет следующие параметры:

4 G8 l6 S* X, R6 N
6 W, b" C# z5 s& E5 Y. I• self – квест
4 D1 f, |( z( R' ^3 u$ D/ o• npcId – ID NCP, которого мы должны убивать (если это метод onTalk, то ID того NCP, с которым мы должны поговорить).
4 u) d2 }' V; w9 y# d: x, \• st – текущее состояние игрока.
7 C5 W5 h) r  Z2 d, i
5 i, E/ B0 M1 V/ F+ T: I- R
В этом методе мы проверяем и отмечаем, является ли убитый NCP keltir’ом. В основном эта проверка не нужна, т.к. у нас только KELTIR_NPC_ID.


Затем проверяем количество предметов (в данном случае количество клыков), и если их вообще нет, то возвращаем строку "Chat0.htm", если только один предмет, то возвращаем строку "Chat1.htm", если же предметов 4 или больше, то "Chat4.htm". Если строка возвращена из методов onEvent, onKill или onTalk, то сервер покажет соответствующие htm. В Chat0.htm может иметь следующий текст: «Вы не имеете ни одного клыка, возвращайтесь позже, когда соберете 4 штуки и бла, бла, бла…», в Chat1.htm может быть следующий текст: «У Вас всего 1 клык, по этому соберите еще…». В Chat4.htm – «Вы собрали необходимое количество предметов, возвращайтесь к вашему тренеру, что бы завершить квест…»
% m: g* H, ~8 P

+ T6 }- U* ?4 c+ m! o6 i. HПримечание: если в строка return начинается с "<html>", то будет показана страничка html с текстом, который стоит далее. Так вместо:
- {6 u; `7 p# L$ @" _- Treturn "Chat4.htm"

8 b" U9 D5 A. d2 ?% x
9 ~; t0 G% K: nможно поставить:

1. return "<html><body>Return to your trainer to complete the quest</body></html>"

Скопировать код

Так же если строка заканчивается без .htm или в начале нет <html>, то текст будет выведен, как системное сообщение в окне чата. В нашем случае мы сделаем так, что бы при каждом убийстве keltik выводилось системное сообщение: «Собрано N из 4-х клыков».
, F+ C) h9 u! d8 _1 I8 N6 a
3 ]' Y, M$ C0 ]
Наш код для onKill имеет один недостаток. Он будет постоянно показывать Chat0.htm, Chat1.htm и Chat4.htm, нам же необходимо, что бы Chat0.htm и Chat1.htm показывались только один раз. Как нам это сделать? С помощью переменных.
# \2 s' \! r' _+ [
9 K: y' |' {- M$ e" \6 L
, Y% o6 D, h7 T/ o( V; }В каждом квесте строки могут храниться с помощью переменных. Эти переменные сохраняются в Вашей БД. В каждом методе мы можем назначить, прочитать и удалить переменные. Давайте изменим метод onKill, так что бы каждый диалог вызывался только один раз.
9 v# c4 ]4 ^7 z" ]* ~; L

1. def onKill (self,npcId,st):
   
2. if npcId == KELTIR_NPC_ID:
   - ~8 N+ N1 h' g/ l
3. n = getCount(st)
   ! D- V; H% y! Y. C( S
4. if n == 0:
   4 k0 v3 Q* I$ K* C* a
5. if st.get('chat0') == None :
   $ H. F- {) |4 C+ m
6. st.set("chat0", "true")
   8 A% \9 o# C& c- y
7. return "Chat0.htm"
   
8. elif n == 1:
   
9. if st.get('chat1') == None :
   & l2 F9 y1 I$ E1 I9 r0 Y% F$ s
10. st.set("chat1", "true")
    
11. return "Chat1.htm"
    
12. elif n >= 4:
    
13. return "Chat4.htm"
    
14. return "Collected "+str(n)+" of 4 fangs"
    
15. return

Скопировать код

Если у игрока нет клыков (n=0), то мы получаем занчение переменной 'chat0'. Когда метод onKill вызван в первый раз, то пока ни каких переменных не имеется и python возвращает значение None. В этом случае объявляется переменная и показывается диалог Chat0.htm. Когда мы убиваем keltir, но не получаем с него клык, функция st.get('chat0') возвращает строку true, а не None. И во второй раз окно с Chat0.htm не появится, но в окне чата появится строчка «Collected 0 of 4 fangs». По тому же принципу сделано и с Chat1.htm.
5 W! T4 D2 P/ ]  `. y

Вот конечный рабочий вариант квеста:
% f* X0 u( W4 l, h* X1 v

1. import sys
   ( h0 y  u0 Z+ ?. U2 [* \8 @& |
2. from net.sf.l2j.gameserver.model.quest import State
   
3. from net.sf.l2j.gameserver.model.quest import QuestState
   9 Q/ Z* v# I6 E" M; \. L% c' N
4. from net.sf.l2j.gameserver.model.quest.jython import QuestJython as JQuest
   9 J) k7 K& Z( Q3 q1 }
5. 
   0 B& A5 F* I" f$ X$ t# A$ s
6. KELTIR_NPC_ID = 12082
   ) r  w8 L2 [; \" |& t! q
7. FANGS_ITEM_ID = 1859
   
8. DROP_RATE    = 500000
   
9. 
   
10. WORLD_MAP_ITEM_ID = 1665
    ' K: v$ z% z( Q3 `
11. 
    ' b0 k* N  @; ]4 n6 z0 W0 u
12. def getCount(st) :
    1 b2 Y+ [% p8 `3 \; X4 P7 y/ C# v
13. return st.getQuestItemsCount(FANGS_ITEM_ID)
    " H5 i/ q9 t4 D$ ]
14. 
    
15. def completed(st) :
    
16. st.setState(COMPLETED)
    
17. st.clearQuestDrops()
    
18. st.takeItems(FANGS_ITEM_ID,-1)
    
19. st.giveItems(WORLD_MAP_ITEM_ID,1)
    6 t' s; w' u6 Q  H% B6 p$ C8 L: o* i% k
20. st.exitQuest(False)
    
21. return
    + a3 u6 G! H# X' _! Z
22. 
    * w; v5 w$ E/ B- W, B) A3 u5 D
23. def check(st) :
    ( b0 _  m+ d3 o% D) `0 Y
24. if getCount(st) >= 4 :
    
25. completed(st)
    
26. return
    
27. 
    4 t6 g7 w  F! c3 |) M; Q
28. class Quest (JQuest):
    
29. 
    
30. def __init__(self,id,name,descr): JQuest.__init__(self,id,name,descr)
    3 j4 V* o- o$ L5 d" t- Q
31. 
    
32. def onEvent (self,event,st):
    
33. id = st.getState()
    
34. if id == CREATED : st.setState(STARTED)
      H  M4 P. R% O$ }' A
35. elif id == COMPLETED: pass
    
36. elif id == STARTED : check(st)
    
37. return
    0 U9 G% s, y. N2 W: H
38. 
    / C, f* ^; i& ]# B  x
39. def onKill (self,npcId,st):
    % p3 g& E/ }( q
40. if npcId == KELTIR_NPC_ID:
    
41. n = getCount(st)
    
42. if n == 0:
    5 ^2 {9 [5 ?4 _7 K! p0 K
43. if st.get('chat0') == None :
    
44. st.set("chat0", "true")
    . Q/ Z6 B$ _% d; h
45. return "Chat0.htm"
    
46. elif n == 1:
    4 L7 q  D3 c/ P
47. if st.get('chat1') == None :
    
48. st.set("chat1", "true")
    
49. return "Chat1.htm"
    ' }$ Q0 h, ^' T* v3 Y
50. elif n >= 4:
    
51. return "Chat4.htm"
    5 p* g2 h3 I$ e6 G8 R
52. return "Collect "+str(n)+" of 4 fangs"
    
53. return
      B. M9 ^/ N+ [' v
54. 
    
55. QUEST    = Quest(201, "Tutorial", "Tutorial quest")
    
56. CREATED = State('Start',    QUEST)
    
57. STARTED = State('Started', QUEST)
    
58. COMPLETED = State('Completed', QUEST)
    8 v" x) l# Z+ T4 h( F1 p3 P
59. 
    0 {" L4 n5 w) s& D
60. QUEST.setInitialState(CREATED)
    
61. QUEST.addStartNpc(7056)
    1 s- E  Q' |3 V" v
62. QUEST.addStartNpc(7012)
    . T) m9 s7 Z- [, p5 t6 ~
63. QUEST.addStartNpc(7009)
    
64. QUEST.addStartNpc(7011)
    3 b! H9 f4 D2 T5 p8 v
65. 
    6 V3 U, x1 o, \' j; n9 M$ j; e
66. STARTED.addQuestDrop(KELTIR_NPC_ID,FANGS_ITEM_ID,DROP_RATE)
    # W% R" {' K4 v* Y
67. STARTED.addKillId(KELTIR_NPC_ID)
    0 {/ M/ U/ W5 A% W( H! a% C
68. STARTED.addTalkId(7056)
    
69. STARTED.addTalkI d(7012)
    " r  A" k5 a/ X6 ?) q( j$ E2 _4 K7 B
70. STARTED.addTalkId(7009)
    7 P6 P! ~: ^$ V( n" V" c" u
71. STARTED.addTalkId(7011)

Скопировать код

& S3 m" ?4 z9 K4 r
+ \2 }& ]' |! E: |/ [, e! O3 I