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

Хроники        Interlude
' o3 W( P4 q; EСборка        L2j
Обратите внимание: в файле htm стартового NCP обязательно должна быть ссылка на квест:
7 d- Y  e* ?) ]1 K( i  }

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

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

Для этого квеста больше ничего не надо. Все необходимое для корректной работы квеста уже добавили. Вот полный текст квеста:
* U2 ]+ w8 x0 R% C, T' _/ z( G5 I9 m
% o6 V! N4 H  c. ]3 _; g

1. if getCount(st) >= 4 :
   
2. completed(st)
   - U# L( Z5 Q8 `: H! s. }
3.   return
   
4. 
   
5. class Quest (JQuest):
   , Q% |5 T* a6 [3 U; n+ L
6.   def __init__(self,id,name,descr): JQuest.__init__(self,id,name,descr)
   
7.   def onEvent (self,event,st):
   + [: W! V& Q% z/ E: v3 R: C! S
8. id = st.getState()
   , z; D# a- j) [2 H
9. if   id == CREATED  : st.setState(STARTED)
   $ I6 }# l' b( j; _/ V
10. elif id == COMPLETED: pass
    
11. elif id == STARTED  : check(st)
    
12. return
    
13. 
    2 ^4 E: C+ s, |0 [7 n0 Z
14. QUEST     = Quest(201,"Tutorial", "Tutorial quest")
    1 ^4 i, h+ h$ d
15. CREATED   = State('Start',     QUEST)
    
16. STARTED   = State('Started',   QUEST)
    
17. COMPLETED = State('Completed', QUEST)
    / O+ N4 _: W  v. [
18. 
    & A* j9 M% I: d( u; g  B. R" D* K
19. QUEST.setInitialState(CREATED)
    
20. QUEST.addStartNpc(7056)
    
21. STARTED.addQuestDrop(KELTIR_NPC_ID,FANGS_ITEM_ID,DROP_RATE)

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

Теперь рассмотрим, как это работает.
Игрок подходит к начальному NCP (в данном случае 7056), нажимает на «Quest». Квест будет создан и состояние квеста перейдет к CREATED и игроку будет показана страничка Start.htm с описанием квеста. Тогда метод onEvent, поле открытия странички Start.htm переведет состояние квеста в STARTED и игроку будет показана страничка Started.htm, где будет опсание того, как найти keltirs и .т.д.
4 c2 y2 M2 B) O  e% N9 M
( E7 m' k  M* g3 }
При состоянии STARTED будет зарегистрирован дроп «fangs» при убийстве keltirs. Игрок может вернуться к стартовому NCP и спросить о квесте – метод onEvent будет вызван снова. Если у игрока не хватает необходимого количества предметов, то метод check() не переведет квест в следующее состояние и Started.htm будет показана снова. Но если игрок собрал необходимее количество предметов (в данном случае 4 клыка), то метод check() вызовет метод completed() который переведет квест в новое состояние COMPLETED, заберет все клыки, даст карту мира, т.к. это награда за квест, покажет Completed.htm и завершит квест.
+ L$ @' ]- v+ `& P! K
5 ~3 d. D& {% O8 X
4 Q, T3 S# M# c0 _) L7 |Теперь давайте сделаем наш квест более похожим на то, что он должен из себя представлять.
Прежде всего у нас есть 3 метода для объявления их в Яве – onTalk, onKill и onEvent. Если методы onTalk и onKill не объявлены, то за них все будет делать метод onEvent, т.е. определять квестовых монстров и вызывать диалоги NCP. Есть примечание, методы onTalk и onKill будут вызывать только диалоги с NCP в зависимости от текущего состояния квеста. Метод onKill будет вызываться только тогда, когда мы убиваем квестового монстра.
+ Z$ I" V$ g# e% Q! m6 `

Давайте рассмотрим как вызывается метод onKill при убийстве keltir в состоянии квеста STARTED:

1. STARTED.addKillId(KELTIR_NPC_ID)

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

и метод onKill в классе Quest:
9 {& B4 p$ d, s

1. class Quest (JQuest):
   
2.   ...
   
3.   def onKill (self,npcId,st):
   ) [; N" N0 B3 l% K' t- J
4. if npcId == KELTIR_NPC_ID:
   
5.    n = getCount(st)
   
6.    if   n == 0:
   
7.        return "Chat0.htm"
   0 s9 k+ O# a2 q: ?
8.    elif n == 1:
   " C' D, t( x- a
9.        return "Chat1.htm"
   & w) d$ V+ K# B* K+ P
10.    elif n >= 4:
    
11.        return "Chat4.htm"
      n3 I2 C$ w) f* n( f, w
12.    return "Collected "+str(n)+" of 4 fangs"
    
13. return

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

Метод onKill (а так же метод onTalk) имеет следующие параметры:
+ q" f# ]0 k: f* {- m: J' n$ i
3 T* |9 @, ~3 e' P! l9 e3 A
4 w1 x7 J+ x0 R- X• self – квест
" Q& P& _' W1 x6 K4 Z+ G$ N• npcId – ID NCP, которого мы должны убивать (если это метод onTalk, то ID того NCP, с которым мы должны поговорить).
• st – текущее состояние игрока.


В этом методе мы проверяем и отмечаем, является ли убитый NCP keltir’ом. В основном эта проверка не нужна, т.к. у нас только KELTIR_NPC_ID.
. }; Q  W8 ?2 r# `; H4 q4 f/ @6 W- [

$ t9 J; U8 Q# ZЗатем проверяем количество предметов (в данном случае количество клыков), и если их вообще нет, то возвращаем строку "Chat0.htm", если только один предмет, то возвращаем строку "Chat1.htm", если же предметов 4 или больше, то "Chat4.htm". Если строка возвращена из методов onEvent, onKill или onTalk, то сервер покажет соответствующие htm. В Chat0.htm может иметь следующий текст: «Вы не имеете ни одного клыка, возвращайтесь позже, когда соберете 4 штуки и бла, бла, бла…», в Chat1.htm может быть следующий текст: «У Вас всего 1 клык, по этому соберите еще…». В Chat4.htm – «Вы собрали необходимое количество предметов, возвращайтесь к вашему тренеру, что бы завершить квест…»
% s5 k8 B) s! J6 }0 |' j! S
  J, _5 `' B' y0 p3 \/ n% d" f
  E2 k: n2 q5 [. ~Примечание: если в строка return начинается с "<html>", то будет показана страничка html с текстом, который стоит далее. Так вместо:
return "Chat4.htm"
: l) O. a6 p2 d, G* ^1 O4 E

3 \+ y% q! A( V# ^9 {можно поставить:
; l' R$ ?' `. A5 z0 R/ E9 E

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

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

Так же если строка заканчивается без .htm или в начале нет <html>, то текст будет выведен, как системное сообщение в окне чата. В нашем случае мы сделаем так, что бы при каждом убийстве keltik выводилось системное сообщение: «Собрано N из 4-х клыков».


& T: g! H2 k& m# J$ A' ~% Q; @9 cНаш код для onKill имеет один недостаток. Он будет постоянно показывать Chat0.htm, Chat1.htm и Chat4.htm, нам же необходимо, что бы Chat0.htm и Chat1.htm показывались только один раз. Как нам это сделать? С помощью переменных.


2 {$ M) U8 K- {: f4 ~В каждом квесте строки могут храниться с помощью переменных. Эти переменные сохраняются в Вашей БД. В каждом методе мы можем назначить, прочитать и удалить переменные. Давайте изменим метод onKill, так что бы каждый диалог вызывался только один раз.

1. def onKill (self,npcId,st):
   
2. if npcId == KELTIR_NPC_ID:
   ! E7 ~2 \; P& w
3. n = getCount(st)
   
4. if n == 0:
   ; g5 C3 a3 [) s; ]3 o& v
5. if st.get('chat0') == None :
   " i8 o* u0 Y( f* C
6. st.set("chat0", "true")
   $ r" ^) T$ l: L. P" H
7. return "Chat0.htm"
   
8. elif n == 1:
   
9. if st.get('chat1') == None :
   
10. st.set("chat1", "true")
      \4 N) J: g0 b7 e# i1 i# Q' i  b
11. return "Chat1.htm"
    ) b% r1 L# B2 y- C; \( M
12. elif n >= 4:
    
13. return "Chat4.htm"
    9 f' b: ^: F! q1 E* @3 Z: n
14. return "Collected "+str(n)+" of 4 fangs"
    & P- X4 E# a& z% }) x8 u# X2 i
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.
/ f% E3 _# T# n/ D8 V3 B

0 h8 F; b7 E% u- q+ NВот конечный рабочий вариант квеста:

1. import sys
   
2. from net.sf.l2j.gameserver.model.quest import State
   
3. from net.sf.l2j.gameserver.model.quest import QuestState
   ' d, F$ {3 T$ R. V  O
4. from net.sf.l2j.gameserver.model.quest.jython import QuestJython as JQuest
   ( `+ b4 B6 [+ j. A
5. 
   
6. KELTIR_NPC_ID = 12082
   ) N, j' _& m4 e* M3 P
7. FANGS_ITEM_ID = 1859
   " w; {  W$ M* T& G: C4 H( w
8. DROP_RATE    = 500000
   
9. 
   
10. WORLD_MAP_ITEM_ID = 1665
    
11. 
    
12. def getCount(st) :
    - H* m1 s& I8 V+ D- t- B
13. return st.getQuestItemsCount(FANGS_ITEM_ID)
    
14. 
    & T& B+ |1 x: D9 H: |+ c
15. def completed(st) :
    7 W4 K, S% W2 z( M* O
16. st.setState(COMPLETED)
    
17. st.clearQuestDrops()
    
18. st.takeItems(FANGS_ITEM_ID,-1)
    
19. st.giveItems(WORLD_MAP_ITEM_ID,1)
    3 ~6 O, K9 Q/ r0 o) E, c+ H
20. st.exitQuest(False)
    
21. return
    
22. 
    6 {2 a( ]( w* v; F+ o, w, ~
23. def check(st) :
    
24. if getCount(st) >= 4 :
    2 a% t9 [. u# p! d) S2 W, R
25. completed(st)
    
26. return
    , o$ b" \1 h" ]
27. 
    
28. class Quest (JQuest):
    " H/ ^" ?+ w7 K1 g: t
29. 
    7 U' S" H& ?+ U2 ^
30. def __init__(self,id,name,descr): JQuest.__init__(self,id,name,descr)
    
31. 
    
32. def onEvent (self,event,st):
    2 k/ ~$ D, [$ U) ~& m' E
33. id = st.getState()
    
34. if id == CREATED : st.setState(STARTED)
    
35. elif id == COMPLETED: pass
    % S9 O4 P- T  |4 V6 y* \* A
36. elif id == STARTED : check(st)
    
37. return
    
38. 
    1 F6 @( k. F+ v$ Y, Q9 X
39. def onKill (self,npcId,st):
    " w8 T' Y* B: I8 e  Z& T
40. if npcId == KELTIR_NPC_ID:
    + E- V# f' v  J8 M# v4 {0 E5 Y
41. n = getCount(st)
    
42. if n == 0:
    . W( a1 g9 w) }9 |( v
43. if st.get('chat0') == None :
    
44. st.set("chat0", "true")
    - q0 o& L0 ?' F) F0 l# ]
45. return "Chat0.htm"
    1 c& I: p5 E' j4 J1 `& Y5 ^
46. elif n == 1:
    , u/ |- I4 L- @' M& A. z7 Q
47. if st.get('chat1') == None :
    $ K9 P) K. d# Z' _" j) Z
48. st.set("chat1", "true")
    4 p; Y( @9 I" H( I. O7 B1 p/ I& Q
49. return "Chat1.htm"
    
50. elif n >= 4:
    * D( I& s: E6 j4 K6 P' `3 N& A
51. return "Chat4.htm"
    # }/ o, @/ D, K$ k' ~4 a5 e
52. return "Collect "+str(n)+" of 4 fangs"
    
53. return
    $ f4 q2 A& j3 g
54. 
    
55. QUEST    = Quest(201, "Tutorial", "Tutorial quest")
    8 `5 G" u* A: o0 f  l
56. CREATED = State('Start',    QUEST)
    
57. STARTED = State('Started', QUEST)
    $ [. \, ]1 W6 ^. c
58. COMPLETED = State('Completed', QUEST)
    " P5 |8 p. N8 ~7 h! |
59. 
    
60. QUEST.setInitialState(CREATED)
    
61. QUEST.addStartNpc(7056)
    
62. QUEST.addStartNpc(7012)
    ! Y5 ^- ^7 {1 j% y2 v
63. QUEST.addStartNpc(7009)
    
64. QUEST.addStartNpc(7011)
    2 z' `3 c& P, x" K
65. 
    1 P% G4 p# X7 D* z. m9 G
66. STARTED.addQuestDrop(KELTIR_NPC_ID,FANGS_ITEM_ID,DROP_RATE)
    2 M8 i- b0 S+ d/ K
67. STARTED.addKillId(KELTIR_NPC_ID)
    
68. STARTED.addTalkId(7056)
    5 g# N: P# Y- {1 J3 U
69. STARTED.addTalkI d(7012)
    & ?8 S, P; w9 b. J; t
70. STARTED.addTalkId(7009)
    
71. STARTED.addTalkId(7011)

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

, \- Q2 G0 `+ ]2 G! W9 r