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

Хроники        Interlude
6 K( D9 q0 v( L0 J' N% C- L- ~1 jСборка        L2j
9 y, S/ D, i6 e; U' xОбратите внимание: в файле htm стартового NCP обязательно должна быть ссылка на квест:

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

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

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

1. if getCount(st) >= 4 :
   " _, U( l( q! Y( T
2. completed(st)
   
3.   return
   ; k- n7 c- u, X5 t3 m
4. 
   
5. class Quest (JQuest):
   
6.   def __init__(self,id,name,descr): JQuest.__init__(self,id,name,descr)
   ; f$ m# d- F; c/ p6 L
7.   def onEvent (self,event,st):
     Y, ?' o% \! N& [9 ~
8. id = st.getState()
   
9. if   id == CREATED  : st.setState(STARTED)
   + P; c- e. p; ]9 Z4 f& W
10. elif id == COMPLETED: pass
    2 I1 d: n7 @3 c
11. elif id == STARTED  : check(st)
    . J; }! i7 _* y" ]& z
12. return
    
13. 
    ! b8 T( B- N& \: ~1 {# b
14. QUEST     = Quest(201,"Tutorial", "Tutorial quest")
    
15. CREATED   = State('Start',     QUEST)
    : f0 E- w. y; I7 A6 y: W$ e
16. STARTED   = State('Started',   QUEST)
    
17. COMPLETED = State('Completed', QUEST)
    
18. 
    0 z- s. Z  ?- ~- }. m; ?
19. QUEST.setInitialState(CREATED)
    
20. QUEST.addStartNpc(7056)
    # a5 x, g2 j  t2 }0 A
21. STARTED.addQuestDrop(KELTIR_NPC_ID,FANGS_ITEM_ID,DROP_RATE)

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

Теперь рассмотрим, как это работает.
Игрок подходит к начальному NCP (в данном случае 7056), нажимает на «Quest». Квест будет создан и состояние квеста перейдет к CREATED и игроку будет показана страничка Start.htm с описанием квеста. Тогда метод onEvent, поле открытия странички Start.htm переведет состояние квеста в STARTED и игроку будет показана страничка Started.htm, где будет опсание того, как найти keltirs и .т.д.
* ~! Z& u" ?# l) F4 m1 J/ z# O
8 O$ W' z; m7 q
При состоянии STARTED будет зарегистрирован дроп «fangs» при убийстве keltirs. Игрок может вернуться к стартовому NCP и спросить о квесте – метод onEvent будет вызван снова. Если у игрока не хватает необходимого количества предметов, то метод check() не переведет квест в следующее состояние и Started.htm будет показана снова. Но если игрок собрал необходимее количество предметов (в данном случае 4 клыка), то метод check() вызовет метод completed() который переведет квест в новое состояние COMPLETED, заберет все клыки, даст карту мира, т.к. это награда за квест, покажет Completed.htm и завершит квест.
3 w4 q% ]  W6 l
# X& |9 ?8 k- l  K6 ?3 f4 H* H
( W3 F. |3 T2 f) @Теперь давайте сделаем наш квест более похожим на то, что он должен из себя представлять.
0 G' D# r& S8 V2 O2 r8 mПрежде всего у нас есть 3 метода для объявления их в Яве – onTalk, onKill и onEvent. Если методы onTalk и onKill не объявлены, то за них все будет делать метод onEvent, т.е. определять квестовых монстров и вызывать диалоги NCP. Есть примечание, методы onTalk и onKill будут вызывать только диалоги с NCP в зависимости от текущего состояния квеста. Метод onKill будет вызываться только тогда, когда мы убиваем квестового монстра.

. g) p3 g! \  ~$ l
0 F& ^7 l; Z% uДавайте рассмотрим как вызывается метод onKill при убийстве keltir в состоянии квеста STARTED:
5 f0 }2 P0 U; C/ }

1. STARTED.addKillId(KELTIR_NPC_ID)

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

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

, p+ d; r  ?! r

1. class Quest (JQuest):
   
2.   ...
   ! ~  X9 r. M& H' R2 s  k9 V- m
3.   def onKill (self,npcId,st):
   " _# O  X+ q$ H. a' a5 }
4. if npcId == KELTIR_NPC_ID:
   - r- }- f# a/ b4 m9 P+ ^
5.    n = getCount(st)
   3 F" Y9 n8 H+ c  [
6.    if   n == 0:
   " d" _2 s  R  Y0 G) M6 M  S) u/ _
7.        return "Chat0.htm"
   
8.    elif n == 1:
   
9.        return "Chat1.htm"
   
10.    elif n >= 4:
    + G" h: I% y# W9 d1 P, N
11.        return "Chat4.htm"
    ! n( K' k& o( y" Z# O' |
12.    return "Collected "+str(n)+" of 4 fangs"
    : M; `1 X8 b. `. r3 l; [
13. return

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

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


! p+ _+ B( Y% C! `$ u/ i, {, i& B• self – квест
  p/ w, x+ X! _) N  X* e: N• npcId – ID NCP, которого мы должны убивать (если это метод onTalk, то ID того NCP, с которым мы должны поговорить).
• st – текущее состояние игрока.


5 b& M$ x% ]9 N* N- I% dВ этом методе мы проверяем и отмечаем, является ли убитый NCP keltir’ом. В основном эта проверка не нужна, т.к. у нас только KELTIR_NPC_ID.

! Z* N. X( p, Z) t# y  Q* l
6 B0 }0 S* X! X8 i; x% ~& ZЗатем проверяем количество предметов (в данном случае количество клыков), и если их вообще нет, то возвращаем строку "Chat0.htm", если только один предмет, то возвращаем строку "Chat1.htm", если же предметов 4 или больше, то "Chat4.htm". Если строка возвращена из методов onEvent, onKill или onTalk, то сервер покажет соответствующие htm. В Chat0.htm может иметь следующий текст: «Вы не имеете ни одного клыка, возвращайтесь позже, когда соберете 4 штуки и бла, бла, бла…», в Chat1.htm может быть следующий текст: «У Вас всего 1 клык, по этому соберите еще…». В Chat4.htm – «Вы собрали необходимое количество предметов, возвращайтесь к вашему тренеру, что бы завершить квест…»
3 l# a" j- s1 s. x

5 J+ [0 \0 @) i2 i/ pПримечание: если в строка return начинается с "<html>", то будет показана страничка html с текстом, который стоит далее. Так вместо:
$ ]! I1 K( }- Q& [7 _, b7 U* areturn "Chat4.htm"
( W" Z; a0 _" M* d8 K( E

6 H" q( J  A, b. Rможно поставить:
# \3 u8 O# G; ~; ^1 O

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

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

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


$ |( ]1 e  ]( n4 ^1 h1 kНаш код для onKill имеет один недостаток. Он будет постоянно показывать Chat0.htm, Chat1.htm и Chat4.htm, нам же необходимо, что бы Chat0.htm и Chat1.htm показывались только один раз. Как нам это сделать? С помощью переменных.


В каждом квесте строки могут храниться с помощью переменных. Эти переменные сохраняются в Вашей БД. В каждом методе мы можем назначить, прочитать и удалить переменные. Давайте изменим метод onKill, так что бы каждый диалог вызывался только один раз.

1. def onKill (self,npcId,st):
   
2. if npcId == KELTIR_NPC_ID:
   
3. n = getCount(st)
   
4. if n == 0:
     Y* b/ N- q2 c' M  F% F: g+ j. r
5. if st.get('chat0') == None :
   
6. st.set("chat0", "true")
   
7. return "Chat0.htm"
   8 U. I1 X" e# L3 u# @: t
8. elif n == 1:
   0 F  I9 b3 A) D" d8 M
9. if st.get('chat1') == None :
   
10. st.set("chat1", "true")
    1 ]1 w; T$ Y6 F" X; I0 j! L, u
11. return "Chat1.htm"
    
12. elif n >= 4:
    # |' `) m* H2 B5 j
13. return "Chat4.htm"
    1 O9 ^$ T* E$ ~' p8 Z  b4 E
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.

/ z; J0 C5 U/ F5 X
Вот конечный рабочий вариант квеста:
' P$ d; o; t7 j& K; i) x

1. import sys
   - z, N" |2 ~' m: Y; L' `
2. from net.sf.l2j.gameserver.model.quest import State
   
3. from net.sf.l2j.gameserver.model.quest import QuestState
   3 |+ u: z5 @* m
4. from net.sf.l2j.gameserver.model.quest.jython import QuestJython as JQuest
   + K1 f) E' ^; l; T! _5 Z% g
5. 
   : h( ]9 t% d5 Z  G
6. KELTIR_NPC_ID = 12082
   
7. FANGS_ITEM_ID = 1859
   8 T  [( ~$ h: L" a
8. DROP_RATE    = 500000
   % }5 C* A( i, z7 C3 b9 q" v6 x& _1 M
9. 
   
10. WORLD_MAP_ITEM_ID = 1665
    * Q/ P9 I/ V" F4 t5 Q
11. 
    
12. def getCount(st) :
    3 \% G% u2 T4 G8 k9 i; R
13. return st.getQuestItemsCount(FANGS_ITEM_ID)
    
14. 
    / f5 S  B" H* {) g2 m5 Q
15. def completed(st) :
    # o' Y% d5 J7 Y2 U
16. st.setState(COMPLETED)
    
17. st.clearQuestDrops()
    
18. st.takeItems(FANGS_ITEM_ID,-1)
    
19. st.giveItems(WORLD_MAP_ITEM_ID,1)
    ! U  I4 G6 C6 H2 p
20. st.exitQuest(False)
    
21. return
    
22. 
    ' r- K! g! V0 p% L
23. def check(st) :
    ( b6 P% K; F2 k1 o* W( \3 S5 X
24. if getCount(st) >= 4 :
    - M1 j) M' E' I' h  E
25. completed(st)
    
26. return
    0 p/ ~, s, J+ B
27. 
    3 c& E: {- J; |8 R& y" _( K3 N/ K
28. class Quest (JQuest):
    * r% V9 _; O7 n/ t" ]0 y
29. 
    
30. def __init__(self,id,name,descr): JQuest.__init__(self,id,name,descr)
    $ v3 v1 N4 ]1 y& `" x
31. 
    
32. def onEvent (self,event,st):
    
33. id = st.getState()
    ! k1 G9 j0 U2 A, Z5 R; J
34. if id == CREATED : st.setState(STARTED)
    
35. elif id == COMPLETED: pass
    6 c0 _. Z6 P: @
36. elif id == STARTED : check(st)
    " D8 Y, o% d3 Z, i1 L6 {
37. return
    
38. 
    
39. def onKill (self,npcId,st):
    
40. if npcId == KELTIR_NPC_ID:
    + R$ g( n: z3 g' b1 _: W: c2 l
41. n = getCount(st)
    4 r# X, y4 L( r; ~
42. if n == 0:
    2 I6 u$ n! ]. j5 m1 _4 G6 i
43. if st.get('chat0') == None :
    
44. st.set("chat0", "true")
    
45. return "Chat0.htm"
    
46. elif n == 1:
    
47. if st.get('chat1') == None :
    
48. st.set("chat1", "true")
    
49. return "Chat1.htm"
    # p1 c8 v* z/ d3 Z* b5 w2 K' ]+ H
50. elif n >= 4:
    3 E+ L, o4 d1 Y6 D" @
51. return "Chat4.htm"
    
52. return "Collect "+str(n)+" of 4 fangs"
    
53. return
    
54. 
    ( b! ?! [; P2 u) n
55. QUEST    = Quest(201, "Tutorial", "Tutorial quest")
    ' r! o) y) @# C
56. CREATED = State('Start',    QUEST)
    
57. STARTED = State('Started', QUEST)
    
58. COMPLETED = State('Completed', QUEST)
    - l' B1 |! v, o+ t
59. 
      K/ `0 d2 r6 g" G/ `, o$ z
60. QUEST.setInitialState(CREATED)
    3 b) c; T, ^! m$ [+ n
61. QUEST.addStartNpc(7056)
    
62. QUEST.addStartNpc(7012)
    , {" e1 k# e; U, R
63. QUEST.addStartNpc(7009)
    * c. v3 h% R/ P. `5 E* s
64. QUEST.addStartNpc(7011)
    6 E4 g( @" M0 `- e1 m
65. 
    
66. STARTED.addQuestDrop(KELTIR_NPC_ID,FANGS_ITEM_ID,DROP_RATE)
    * |4 |; x* e$ f; Y% r
67. STARTED.addKillId(KELTIR_NPC_ID)
    
68. STARTED.addTalkId(7056)
    5 V& o. R! _+ `: i9 ?- N0 o* X) f+ B" ~
69. STARTED.addTalkI d(7012)
    # g5 ?4 {8 A  }4 d* m- N+ F
70. STARTED.addTalkId(7009)
    
71. STARTED.addTalkId(7011)

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

' Y3 b. w5 F; t