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

Хроники        Interlude
8 d3 }8 ]1 `! K. [; uСборка        L2j
Обратите внимание: в файле htm стартового NCP обязательно должна быть ссылка на квест:
# h; {% }5 V5 z

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

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

Для этого квеста больше ничего не надо. Все необходимое для корректной работы квеста уже добавили. Вот полный текст квеста:

+ m+ n( ]; j3 x! u: S

1. if getCount(st) >= 4 :
   . a3 U2 Z0 J) p: p9 v/ f
2. completed(st)
   
3.   return
   & Y: r# }1 d5 L/ j
4. 
   
5. class Quest (JQuest):
     o) Z6 g. D! Q% [8 G7 R
6.   def __init__(self,id,name,descr): JQuest.__init__(self,id,name,descr)
   ( K, K, f# q+ n$ Y! @  C
7.   def onEvent (self,event,st):
   ! q) G5 x0 s% N. E1 ]# B
8. id = st.getState()
   # d2 W$ T9 d8 Z2 p, G0 a+ v/ x
9. if   id == CREATED  : st.setState(STARTED)
   ' n" x, ?# m  O& ]
10. elif id == COMPLETED: pass
    7 A( h5 [5 p- s7 R  F3 |
11. elif id == STARTED  : check(st)
    
12. return
    
13. 
    ) D" |3 K" ]- j6 P! ?) o( r$ B0 O
14. QUEST     = Quest(201,"Tutorial", "Tutorial quest")
    
15. CREATED   = State('Start',     QUEST)
    ' i, H# `& m7 n/ u6 Q
16. STARTED   = State('Started',   QUEST)
    6 i( \! K& v9 v5 h
17. COMPLETED = State('Completed', QUEST)
    ' _, w8 _! D) C' z$ A6 j
18. 
    
19. QUEST.setInitialState(CREATED)
    8 W% u& i+ v) z, ^7 a
20. QUEST.addStartNpc(7056)
    
21. STARTED.addQuestDrop(KELTIR_NPC_ID,FANGS_ITEM_ID,DROP_RATE)

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

Теперь рассмотрим, как это работает.
; i" x( z" r/ v5 o0 P' b( K" _Игрок подходит к начальному NCP (в данном случае 7056), нажимает на «Quest». Квест будет создан и состояние квеста перейдет к CREATED и игроку будет показана страничка Start.htm с описанием квеста. Тогда метод onEvent, поле открытия странички Start.htm переведет состояние квеста в STARTED и игроку будет показана страничка Started.htm, где будет опсание того, как найти keltirs и .т.д.
$ S* j1 F3 G9 v2 ?
2 l6 @9 k# z. D9 h/ k  B& h+ V
$ |* F4 ~9 B* |% A$ o2 Q, zПри состоянии STARTED будет зарегистрирован дроп «fangs» при убийстве keltirs. Игрок может вернуться к стартовому NCP и спросить о квесте – метод onEvent будет вызван снова. Если у игрока не хватает необходимого количества предметов, то метод check() не переведет квест в следующее состояние и Started.htm будет показана снова. Но если игрок собрал необходимее количество предметов (в данном случае 4 клыка), то метод check() вызовет метод completed() который переведет квест в новое состояние COMPLETED, заберет все клыки, даст карту мира, т.к. это награда за квест, покажет Completed.htm и завершит квест.


Теперь давайте сделаем наш квест более похожим на то, что он должен из себя представлять.
3 a, ]  \. M& vПрежде всего у нас есть 3 метода для объявления их в Яве – onTalk, onKill и onEvent. Если методы onTalk и onKill не объявлены, то за них все будет делать метод onEvent, т.е. определять квестовых монстров и вызывать диалоги NCP. Есть примечание, методы onTalk и onKill будут вызывать только диалоги с NCP в зависимости от текущего состояния квеста. Метод onKill будет вызываться только тогда, когда мы убиваем квестового монстра.


, c4 q& o' n4 v* }Давайте рассмотрим как вызывается метод onKill при убийстве keltir в состоянии квеста STARTED:

1. STARTED.addKillId(KELTIR_NPC_ID)

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

и метод onKill в классе Quest:

% {& o7 P9 ?1 Y1 w! v/ B# {/ a5 I

1. class Quest (JQuest):
   
2.   ...
   ( `, d# Q+ m$ x5 P- u" I0 s  p0 ]
3.   def onKill (self,npcId,st):
   
4. if npcId == KELTIR_NPC_ID:
   $ m  |) H# Q9 ~" f7 F
5.    n = getCount(st)
   
6.    if   n == 0:
   ( ?8 g8 [" Z0 N( Q* p
7.        return "Chat0.htm"
   
8.    elif n == 1:
   
9.        return "Chat1.htm"
   
10.    elif n >= 4:
    
11.        return "Chat4.htm"
    
12.    return "Collected "+str(n)+" of 4 fangs"
    
13. return

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

Метод onKill (а так же метод onTalk) имеет следующие параметры:
: a! l; B4 p7 q& @0 Y# N
. i$ ]0 K, e) ]: @* \2 M: q
• self – квест
3 g. w' P) `+ b% V5 P7 y• npcId – ID NCP, которого мы должны убивать (если это метод onTalk, то ID того NCP, с которым мы должны поговорить).
% X2 {, j% Z( S0 D: ~• st – текущее состояние игрока.


9 ^1 P; m5 }6 x  xВ этом методе мы проверяем и отмечаем, является ли убитый NCP keltir’ом. В основном эта проверка не нужна, т.к. у нас только KELTIR_NPC_ID.
  m% o! K7 @9 R- b+ r6 K- W. O

Затем проверяем количество предметов (в данном случае количество клыков), и если их вообще нет, то возвращаем строку "Chat0.htm", если только один предмет, то возвращаем строку "Chat1.htm", если же предметов 4 или больше, то "Chat4.htm". Если строка возвращена из методов onEvent, onKill или onTalk, то сервер покажет соответствующие htm. В Chat0.htm может иметь следующий текст: «Вы не имеете ни одного клыка, возвращайтесь позже, когда соберете 4 штуки и бла, бла, бла…», в Chat1.htm может быть следующий текст: «У Вас всего 1 клык, по этому соберите еще…». В Chat4.htm – «Вы собрали необходимое количество предметов, возвращайтесь к вашему тренеру, что бы завершить квест…»
( ?/ x- ^: e8 X7 V0 U  Q2 V% @
: Y9 d7 g/ T6 k. {, z! r' u
' i" H  @8 o" H+ \7 C) AПримечание: если в строка return начинается с "<html>", то будет показана страничка html с текстом, который стоит далее. Так вместо:
return "Chat4.htm"


% H, v) R9 g, @можно поставить:
. z" H$ ^- G* x

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

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

Так же если строка заканчивается без .htm или в начале нет <html>, то текст будет выведен, как системное сообщение в окне чата. В нашем случае мы сделаем так, что бы при каждом убийстве keltik выводилось системное сообщение: «Собрано N из 4-х клыков».
: r8 x0 H. Q5 a  \2 Q9 }
/ Z  \% x2 ^7 d( h. X, f3 ]
Наш код для onKill имеет один недостаток. Он будет постоянно показывать Chat0.htm, Chat1.htm и Chat4.htm, нам же необходимо, что бы Chat0.htm и Chat1.htm показывались только один раз. Как нам это сделать? С помощью переменных.


- G( a: F3 r0 p) g* gВ каждом квесте строки могут храниться с помощью переменных. Эти переменные сохраняются в Вашей БД. В каждом методе мы можем назначить, прочитать и удалить переменные. Давайте изменим метод onKill, так что бы каждый диалог вызывался только один раз.

1. def onKill (self,npcId,st):
   
2. if npcId == KELTIR_NPC_ID:
   " r- ^# A- f1 v9 E0 T0 z" B: O
3. n = getCount(st)
   ; _% j: H) h; d+ q
4. if n == 0:
   " V$ `+ N: a* D" Q
5. if st.get('chat0') == None :
   ; Y) Q1 B2 g: w5 x: i
6. st.set("chat0", "true")
   
7. return "Chat0.htm"
   
8. elif n == 1:
   9 y6 Y. i# p) Z$ ]+ a
9. if st.get('chat1') == None :
   3 z( l+ ~; m* S' I
10. st.set("chat1", "true")
    2 K, ]/ [5 f5 }) q' w
11. return "Chat1.htm"
    
12. elif n >= 4:
    
13. return "Chat4.htm"
    
14. return "Collected "+str(n)+" of 4 fangs"
    5 u2 @4 U& Z% x# g; |/ {  e2 G8 e
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% |, M8 q5 F3 K" u. [8 Y

Вот конечный рабочий вариант квеста:
2 d6 `* k; Y$ o6 p% J1 i: C

1. import sys
   
2. from net.sf.l2j.gameserver.model.quest import State
   
3. from net.sf.l2j.gameserver.model.quest import QuestState
   ; V' t6 D& @- W& S; Q
4. from net.sf.l2j.gameserver.model.quest.jython import QuestJython as JQuest
   
5. 
   
6. KELTIR_NPC_ID = 12082
   
7. FANGS_ITEM_ID = 1859
   5 A! c  }( M7 c4 _
8. DROP_RATE    = 500000
   " g' D% R' i2 U+ V
9. 
   
10. WORLD_MAP_ITEM_ID = 1665
    0 W% [$ N6 w: V" u+ m' W& j
11. 
    0 L. V1 J+ |! C* ^, n% F& j/ w
12. def getCount(st) :
    
13. return st.getQuestItemsCount(FANGS_ITEM_ID)
    ) V! P" e7 |0 p
14. 
    7 Q3 H6 H3 ~8 s$ B0 |
15. def completed(st) :
    
16. st.setState(COMPLETED)
    
17. st.clearQuestDrops()
    
18. st.takeItems(FANGS_ITEM_ID,-1)
    5 h& r# q# G% U% m1 o  ~* ~
19. st.giveItems(WORLD_MAP_ITEM_ID,1)
    
20. st.exitQuest(False)
    
21. return
    
22. 
    
23. def check(st) :
    + A2 c9 r" v+ Z
24. if getCount(st) >= 4 :
      }7 K- p  c2 y0 d% g
25. completed(st)
    & d: x: S* {: D& F
26. return
    
27. 
    ' B8 l, d, M$ R# \
28. class Quest (JQuest):
    
29. 
    
30. def __init__(self,id,name,descr): JQuest.__init__(self,id,name,descr)
    
31. 
    * e& G* }4 I1 Z9 M
32. def onEvent (self,event,st):
    , [& A+ ]8 s3 X6 ]; X. j! Y
33. id = st.getState()
    
34. if id == CREATED : st.setState(STARTED)
    2 g3 x: S7 D$ L
35. elif id == COMPLETED: pass
    / p$ X. {6 ]* q
36. elif id == STARTED : check(st)
    
37. return
    ! |9 [6 ?) I1 c/ J% S
38. 
    
39. def onKill (self,npcId,st):
    
40. if npcId == KELTIR_NPC_ID:
    
41. n = getCount(st)
    
42. if n == 0:
    
43. if st.get('chat0') == None :
    
44. st.set("chat0", "true")
    . F5 G/ U; h3 Y8 q# R0 w
45. return "Chat0.htm"
    
46. elif n == 1:
    
47. if st.get('chat1') == None :
    , M! _" d" e0 q" K6 R# w
48. st.set("chat1", "true")
    ( R3 T# k1 o: C* Z: o1 s$ s4 w: C6 X, b
49. return "Chat1.htm"
    6 V7 H/ Q# s8 F% A0 M/ S
50. elif n >= 4:
    
51. return "Chat4.htm"
    
52. return "Collect "+str(n)+" of 4 fangs"
    + \& S2 `6 Q% E
53. return
    ( X2 a, v3 e: S* y+ d6 O: c0 [
54. 
    
55. QUEST    = Quest(201, "Tutorial", "Tutorial quest")
    
56. CREATED = State('Start',    QUEST)
    
57. STARTED = State('Started', QUEST)
    ) o( Y  R3 i/ w
58. COMPLETED = State('Completed', QUEST)
    
59. 
    
60. QUEST.setInitialState(CREATED)
    4 q! X5 `4 j1 N3 R
61. QUEST.addStartNpc(7056)
    
62. QUEST.addStartNpc(7012)
    
63. QUEST.addStartNpc(7009)
    
64. QUEST.addStartNpc(7011)
    
65. 
    3 h: i& E' O4 L5 |8 O
66. STARTED.addQuestDrop(KELTIR_NPC_ID,FANGS_ITEM_ID,DROP_RATE)
    
67. STARTED.addKillId(KELTIR_NPC_ID)
    
68. STARTED.addTalkId(7056)
    
69. STARTED.addTalkI d(7012)
    
70. STARTED.addTalkId(7009)
    
71. STARTED.addTalkId(7011)

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

1 G5 I2 c7 j& H" {( u0 {5 c& N& F