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

Хроники        Interlude
# u0 }6 J" f& J; b  uСборка        L2j
! x# B, b; j$ \/ zОбратите внимание: в файле htm стартового NCP обязательно должна быть ссылка на квест:
0 Q" b7 o0 g; K" g8 D

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

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

Для этого квеста больше ничего не надо. Все необходимое для корректной работы квеста уже добавили. Вот полный текст квеста:
: j0 g7 Z' ?& t
6 R: F" g/ k( R

1. if getCount(st) >= 4 :
   7 `9 m# D0 u/ X3 M
2. completed(st)
   6 T' V: B( ]- [$ b" e
3.   return
   6 t: j) }1 q# |- u
4. 
   , p4 b  F9 t0 y2 U! @8 f. w
5. class Quest (JQuest):
   
6.   def __init__(self,id,name,descr): JQuest.__init__(self,id,name,descr)
   / S1 M2 q# k/ o% f% M
7.   def onEvent (self,event,st):
   
8. id = st.getState()
   6 V; D" K" f+ H8 P  O8 ?
9. if   id == CREATED  : st.setState(STARTED)
   ) ?3 C5 }. C3 R- x& G9 r
10. elif id == COMPLETED: pass
    ' n) y- l" z' p
11. elif id == STARTED  : check(st)
    6 R8 ]  @1 A9 {- [! M4 i9 g# j" U
12. return
    + {4 J0 S2 }0 B0 u$ J' [; W; ]
13. 
    
14. QUEST     = Quest(201,"Tutorial", "Tutorial quest")
    
15. CREATED   = State('Start',     QUEST)
    ; Q  `/ w6 a: F& l! A
16. STARTED   = State('Started',   QUEST)
    
17. COMPLETED = State('Completed', QUEST)
    
18. 
    1 b% y6 }8 L* ~4 e( k4 X  `
19. QUEST.setInitialState(CREATED)
    
20. QUEST.addStartNpc(7056)
    
21. STARTED.addQuestDrop(KELTIR_NPC_ID,FANGS_ITEM_ID,DROP_RATE)

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

Теперь рассмотрим, как это работает.
+ h& Z1 ~3 ]% gИгрок подходит к начальному NCP (в данном случае 7056), нажимает на «Quest». Квест будет создан и состояние квеста перейдет к CREATED и игроку будет показана страничка Start.htm с описанием квеста. Тогда метод onEvent, поле открытия странички Start.htm переведет состояние квеста в STARTED и игроку будет показана страничка Started.htm, где будет опсание того, как найти keltirs и .т.д.

8 k6 X7 k$ s/ D3 [, b
) O/ G+ t& \4 y! WПри состоянии STARTED будет зарегистрирован дроп «fangs» при убийстве keltirs. Игрок может вернуться к стартовому NCP и спросить о квесте – метод onEvent будет вызван снова. Если у игрока не хватает необходимого количества предметов, то метод check() не переведет квест в следующее состояние и Started.htm будет показана снова. Но если игрок собрал необходимее количество предметов (в данном случае 4 клыка), то метод check() вызовет метод completed() который переведет квест в новое состояние COMPLETED, заберет все клыки, даст карту мира, т.к. это награда за квест, покажет Completed.htm и завершит квест.
( _( ~$ K3 s8 F: u, n) K
  z* z6 f9 y9 o  s/ @
3 _+ ]* y$ H- U  [* X. ~- d8 Y) w  e' zТеперь давайте сделаем наш квест более похожим на то, что он должен из себя представлять.
Прежде всего у нас есть 3 метода для объявления их в Яве – onTalk, onKill и onEvent. Если методы onTalk и onKill не объявлены, то за них все будет делать метод onEvent, т.е. определять квестовых монстров и вызывать диалоги NCP. Есть примечание, методы onTalk и onKill будут вызывать только диалоги с NCP в зависимости от текущего состояния квеста. Метод onKill будет вызываться только тогда, когда мы убиваем квестового монстра.
7 @/ Z; |) g6 K+ u
( H, ?7 S; @4 u8 y2 Y5 \1 F% w: o
. O7 j% [% q, n; G% B) L; E/ UДавайте рассмотрим как вызывается метод onKill при убийстве keltir в состоянии квеста STARTED:
7 t; H$ T% }( K* n: y$ w

1. STARTED.addKillId(KELTIR_NPC_ID)

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

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

1. class Quest (JQuest):
   9 s1 p6 s. n9 f  }/ F
2.   ...
   ( C9 d3 Y! U+ }4 c4 W
3.   def onKill (self,npcId,st):
   2 W! U$ S) X; w$ V
4. if npcId == KELTIR_NPC_ID:
   
5.    n = getCount(st)
   
6.    if   n == 0:
   ; z# ?0 F2 k% S; u
7.        return "Chat0.htm"
   $ `; w& l; \6 r" o; T4 u' ~! g% e
8.    elif n == 1:
   , _/ v: F4 j& B* V+ R
9.        return "Chat1.htm"
   8 r) f8 L8 B! u0 k2 H
10.    elif n >= 4:
    
11.        return "Chat4.htm"
    * @8 {' p1 h5 ?* e7 }- D0 R" h  B
12.    return "Collected "+str(n)+" of 4 fangs"
    
13. return

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

Метод onKill (а так же метод onTalk) имеет следующие параметры:
' C4 d* B9 b0 `3 M) v3 \- a

1 u  K% N+ [3 _6 Y1 Y• self – квест
• npcId – ID NCP, которого мы должны убивать (если это метод onTalk, то ID того NCP, с которым мы должны поговорить).
9 ~6 h0 x! v" {6 O" h• st – текущее состояние игрока.


В этом методе мы проверяем и отмечаем, является ли убитый NCP keltir’ом. В основном эта проверка не нужна, т.к. у нас только KELTIR_NPC_ID.
7 R% b/ k7 e" U  N9 i% G
/ n1 n- n; k8 M5 ]; ^0 H  z
$ y; {; W# c( k) l/ u$ a& d6 iЗатем проверяем количество предметов (в данном случае количество клыков), и если их вообще нет, то возвращаем строку "Chat0.htm", если только один предмет, то возвращаем строку "Chat1.htm", если же предметов 4 или больше, то "Chat4.htm". Если строка возвращена из методов onEvent, onKill или onTalk, то сервер покажет соответствующие htm. В Chat0.htm может иметь следующий текст: «Вы не имеете ни одного клыка, возвращайтесь позже, когда соберете 4 штуки и бла, бла, бла…», в Chat1.htm может быть следующий текст: «У Вас всего 1 клык, по этому соберите еще…». В Chat4.htm – «Вы собрали необходимое количество предметов, возвращайтесь к вашему тренеру, что бы завершить квест…»

7 F2 Z: `% i) T) A
Примечание: если в строка return начинается с "<html>", то будет показана страничка html с текстом, который стоит далее. Так вместо:
return "Chat4.htm"


. u% v* J! F# `, D5 _6 Oможно поставить:
6 g% i% Q- m- O2 }

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

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

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

  Z& _; r; w' a; m7 ]
6 z5 m0 a: R1 `$ WНаш код для onKill имеет один недостаток. Он будет постоянно показывать Chat0.htm, Chat1.htm и Chat4.htm, нам же необходимо, что бы Chat0.htm и Chat1.htm показывались только один раз. Как нам это сделать? С помощью переменных.
- b; e* U( f* N* [

В каждом квесте строки могут храниться с помощью переменных. Эти переменные сохраняются в Вашей БД. В каждом методе мы можем назначить, прочитать и удалить переменные. Давайте изменим метод onKill, так что бы каждый диалог вызывался только один раз.
6 g- q. x4 r: M  f& e4 ]3 ^

1. def onKill (self,npcId,st):
   3 L* g) v2 i0 v9 W
2. if npcId == KELTIR_NPC_ID:
   3 Y4 {$ }4 O2 J. l" _% ?) e
3. n = getCount(st)
   
4. if n == 0:
   ; w; S" N& \- A' A7 X! _/ Y8 h
5. if st.get('chat0') == None :
   9 x# ?2 ^7 l+ r# m( X) Q
6. st.set("chat0", "true")
   
7. return "Chat0.htm"
   8 @  B. m- D* c6 }6 c4 e
8. elif n == 1:
   
9. if st.get('chat1') == None :
   
10. st.set("chat1", "true")
    - i; q0 K) f5 H8 h+ Q. s
11. return "Chat1.htm"
    7 F0 d5 T$ E, ]( k1 I) D$ A% p
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.
: F6 n% D7 i' i  l

6 b/ X" L( I* b3 @3 s6 q; v: aВот конечный рабочий вариант квеста:

1. import sys
   4 P' ^5 P7 Y7 B
2. from net.sf.l2j.gameserver.model.quest import State
   
3. from net.sf.l2j.gameserver.model.quest import QuestState
   9 S8 I" B; i' d& G3 O. @8 X. w
4. from net.sf.l2j.gameserver.model.quest.jython import QuestJython as JQuest
   
5. 
   ( Z; _, ~" L- Z" r
6. KELTIR_NPC_ID = 12082
   0 u' c1 D) H: n4 X: y6 D# I( z
7. FANGS_ITEM_ID = 1859
   
8. DROP_RATE    = 500000
   ' g& O. c9 C7 w( ]  |. x& y
9. 
   # y& I) [5 |3 D6 g
10. WORLD_MAP_ITEM_ID = 1665
    
11. 
    $ [- D9 @! |2 f( g, G# |
12. def getCount(st) :
    
13. return st.getQuestItemsCount(FANGS_ITEM_ID)
    % b+ v- R5 S% F- [: \
14. 
    - v  G3 b- r( v2 c2 F  g" u9 ]) Y
15. def completed(st) :
    
16. st.setState(COMPLETED)
    
17. st.clearQuestDrops()
    
18. st.takeItems(FANGS_ITEM_ID,-1)
    4 C( O) L" r- ^( [8 H0 o2 O* U
19. st.giveItems(WORLD_MAP_ITEM_ID,1)
    & Z4 w: r6 e/ }/ G
20. st.exitQuest(False)
    
21. return
    9 J8 G# {% P% ?, t, {
22. 
    $ G" o6 _7 K8 M! L7 b6 t7 {# V
23. def check(st) :
    , c/ n, C: G8 G9 o  X/ P
24. if getCount(st) >= 4 :
    
25. completed(st)
    1 r" I9 a! v, W( W
26. return
    
27. 
    
28. class Quest (JQuest):
    6 r7 L% N; l2 s
29. 
    
30. def __init__(self,id,name,descr): JQuest.__init__(self,id,name,descr)
    
31. 
    
32. def onEvent (self,event,st):
    # x, j: Z: [( d& S+ z, `8 R$ o
33. id = st.getState()
    5 A. {* S& e3 G! W# z. O
34. if id == CREATED : st.setState(STARTED)
      M7 G3 c0 O7 i  E# {- S
35. elif id == COMPLETED: pass
    
36. elif id == STARTED : check(st)
    ( I% P, L/ X. M1 Z3 }* l
37. return
    
38. 
    ( ?3 w) h& {% j
39. def onKill (self,npcId,st):
    . y2 W) }5 p& m& V4 T$ P
40. if npcId == KELTIR_NPC_ID:
    ( M# o6 i: m$ c3 G, g
41. n = getCount(st)
    ( D& h. A8 @- S) G% J* F
42. if n == 0:
    0 Y( C6 ^  Z6 s+ v" `( n* F
43. if st.get('chat0') == None :
    
44. st.set("chat0", "true")
    
45. return "Chat0.htm"
    : V( D8 E" w7 e/ K5 @
46. elif n == 1:
    " }5 o* i* o0 }2 |  N1 w
47. if st.get('chat1') == None :
    
48. st.set("chat1", "true")
    
49. return "Chat1.htm"
    2 R) k0 C& n& Y2 B/ z; ~
50. elif n >= 4:
    0 z& h7 z' T. t. x# G
51. return "Chat4.htm"
    : V% W4 o, r3 r: y% J3 d; t3 ]
52. return "Collect "+str(n)+" of 4 fangs"
    ' X6 I2 j  i0 y( q  |: h
53. return
    / D5 |: A5 J: Q6 O
54. 
    & ^$ _6 G; J1 d$ n, p* B
55. QUEST    = Quest(201, "Tutorial", "Tutorial quest")
    
56. CREATED = State('Start',    QUEST)
    
57. STARTED = State('Started', QUEST)
    
58. COMPLETED = State('Completed', QUEST)
    , d- _# C+ N! B* }2 P; q4 N
59. 
    
60. QUEST.setInitialState(CREATED)
    
61. QUEST.addStartNpc(7056)
    
62. QUEST.addStartNpc(7012)
    
63. QUEST.addStartNpc(7009)
    
64. QUEST.addStartNpc(7011)
    
65. 
    ) d' v2 `+ b" H$ N
66. STARTED.addQuestDrop(KELTIR_NPC_ID,FANGS_ITEM_ID,DROP_RATE)
    
67. STARTED.addKillId(KELTIR_NPC_ID)
    + H, R; X& J& i( ]. Q4 }. K
68. STARTED.addTalkId(7056)
    
69. STARTED.addTalkI d(7012)
    # S1 @9 ]/ O' K: |9 t$ f  X. K: i
70. STARTED.addTalkId(7009)
    
71. STARTED.addTalkId(7011)

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

( b) s1 }. c! A* ~) T- L