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

Хроники        Interlude
# ]3 U4 n9 f& ^! e& }Сборка        L2j
. O! X  r4 }8 o" rОбратите внимание: в файле htm стартового NCP обязательно должна быть ссылка на квест:
1 a2 Y; U! w/ V4 @. B: Q

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

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

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

& f( I! X8 u) m/ b3 H

1. if getCount(st) >= 4 :
   
2. completed(st)
   ( E$ d: @" Z; I: g, Q4 t! a7 o! `
3.   return
   ' q5 y3 t5 _% I6 n9 N: a
4. 
   2 a8 l- M8 `' c) j
5. class Quest (JQuest):
   
6.   def __init__(self,id,name,descr): JQuest.__init__(self,id,name,descr)
   
7.   def onEvent (self,event,st):
   0 @& p0 h+ ~8 w1 S/ g
8. id = st.getState()
   
9. if   id == CREATED  : st.setState(STARTED)
   8 f5 l' t, n  ^/ R% ~" T: v. {
10. elif id == COMPLETED: pass
    
11. elif id == STARTED  : check(st)
    4 r$ \  l" Q* @0 X% t
12. return
    
13. 
    9 F7 o7 b  p/ n1 _3 h; P5 P
14. QUEST     = Quest(201,"Tutorial", "Tutorial quest")
    
15. CREATED   = State('Start',     QUEST)
    ( g) X6 A! T" H$ O8 A
16. STARTED   = State('Started',   QUEST)
    + e7 d3 w. Y" i- x1 N; E: t; L5 M$ `
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)

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

Теперь рассмотрим, как это работает.
  B/ {: d& r0 f, w' F9 aИгрок подходит к начальному NCP (в данном случае 7056), нажимает на «Quest». Квест будет создан и состояние квеста перейдет к CREATED и игроку будет показана страничка Start.htm с описанием квеста. Тогда метод onEvent, поле открытия странички Start.htm переведет состояние квеста в STARTED и игроку будет показана страничка Started.htm, где будет опсание того, как найти keltirs и .т.д.

/ g' ]# _; P8 o! _9 L
При состоянии STARTED будет зарегистрирован дроп «fangs» при убийстве keltirs. Игрок может вернуться к стартовому NCP и спросить о квесте – метод onEvent будет вызван снова. Если у игрока не хватает необходимого количества предметов, то метод check() не переведет квест в следующее состояние и Started.htm будет показана снова. Но если игрок собрал необходимее количество предметов (в данном случае 4 клыка), то метод check() вызовет метод completed() который переведет квест в новое состояние COMPLETED, заберет все клыки, даст карту мира, т.к. это награда за квест, покажет Completed.htm и завершит квест.
' C/ D/ @* ]  _

Теперь давайте сделаем наш квест более похожим на то, что он должен из себя представлять.
/ u) _  S, K' x# uПрежде всего у нас есть 3 метода для объявления их в Яве – onTalk, onKill и onEvent. Если методы onTalk и onKill не объявлены, то за них все будет делать метод onEvent, т.е. определять квестовых монстров и вызывать диалоги NCP. Есть примечание, методы onTalk и onKill будут вызывать только диалоги с NCP в зависимости от текущего состояния квеста. Метод onKill будет вызываться только тогда, когда мы убиваем квестового монстра.
2 p" I3 k: i; J5 R
3 S0 U& |. ^' L  P
Давайте рассмотрим как вызывается метод onKill при убийстве keltir в состоянии квеста STARTED:
' b. A3 L8 X, S* l0 d

1. STARTED.addKillId(KELTIR_NPC_ID)

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

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

1. class Quest (JQuest):
   & P- g+ }2 A$ I- i
2.   ...
   
3.   def onKill (self,npcId,st):
   4 `3 q8 `, m5 Z- n; x( J
4. if npcId == KELTIR_NPC_ID:
   3 c" T( |6 [0 W
5.    n = getCount(st)
   
6.    if   n == 0:
   ( t5 l- u) p, u2 A2 f
7.        return "Chat0.htm"
   
8.    elif n == 1:
   
9.        return "Chat1.htm"
   " j7 I1 F, v4 z
10.    elif n >= 4:
    6 I8 j. c+ ^: U1 x6 U
11.        return "Chat4.htm"
    
12.    return "Collected "+str(n)+" of 4 fangs"
    
13. return

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

Метод onKill (а так же метод onTalk) имеет следующие параметры:
  l/ E2 x2 v+ g7 P+ k0 k! Y, u

( f! B1 U1 r9 s) P- _/ M8 c$ C• self – квест
3 t' Q7 ]0 ]8 i• npcId – ID NCP, которого мы должны убивать (если это метод onTalk, то ID того NCP, с которым мы должны поговорить).
• st – текущее состояние игрока.


, j+ H" ?1 w& _4 T$ A0 qВ этом методе мы проверяем и отмечаем, является ли убитый NCP keltir’ом. В основном эта проверка не нужна, т.к. у нас только KELTIR_NPC_ID.
- Q5 e( {8 ]! r! N5 V

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

% b* {& o- @$ k1 a
8 d. k# q, v9 d, IПримечание: если в строка return начинается с "<html>", то будет показана страничка html с текстом, который стоит далее. Так вместо:
. s- {  o- w; R9 ?* ureturn "Chat4.htm"
0 s0 i" a2 `# v9 B9 P
# A* o# |' @5 |% X! d
можно поставить:
0 }; y; u+ D0 q( r$ q

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

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

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


Наш код для onKill имеет один недостаток. Он будет постоянно показывать Chat0.htm, Chat1.htm и Chat4.htm, нам же необходимо, что бы Chat0.htm и Chat1.htm показывались только один раз. Как нам это сделать? С помощью переменных.


+ E. P! t0 m6 M, L# EВ каждом квесте строки могут храниться с помощью переменных. Эти переменные сохраняются в Вашей БД. В каждом методе мы можем назначить, прочитать и удалить переменные. Давайте изменим метод onKill, так что бы каждый диалог вызывался только один раз.

1. def onKill (self,npcId,st):
   
2. if npcId == KELTIR_NPC_ID:
   7 N: ^/ \! D: V/ U0 W
3. n = getCount(st)
   # @7 \3 ?8 @8 g' T- @4 ^; P7 W3 M
4. if n == 0:
   
5. if st.get('chat0') == None :
   & p. J  a2 f& u) I
6. st.set("chat0", "true")
   
7. return "Chat0.htm"
   & v+ L0 b1 J3 v/ S' l
8. elif n == 1:
   & i0 i) K3 u- Y2 ], {7 K' i
9. if st.get('chat1') == None :
   
10. st.set("chat1", "true")
    ; j2 C' j* K3 {. h& s
11. return "Chat1.htm"
    5 H& E: M! `+ d3 C. r' Y, h
12. elif n >= 4:
    
13. return "Chat4.htm"
    5 [. _9 m3 x! X6 n
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.
- o) l% F/ s9 |5 R
+ t! c  k9 G" E
* l% m; x: R9 ZВот конечный рабочий вариант квеста:

1. import sys
   . U; f/ p7 I6 D9 M4 s6 \
2. from net.sf.l2j.gameserver.model.quest import State
   5 y0 B) p0 u6 S. B) u
3. from net.sf.l2j.gameserver.model.quest import QuestState
   
4. from net.sf.l2j.gameserver.model.quest.jython import QuestJython as JQuest
   
5. 
   
6. KELTIR_NPC_ID = 12082
   * a$ _3 |/ @- M6 W" z( g7 Z
7. FANGS_ITEM_ID = 1859
   
8. DROP_RATE    = 500000
   
9. 
   
10. WORLD_MAP_ITEM_ID = 1665
    
11. 
    
12. def getCount(st) :
    * Q) a3 T, ^- h6 R3 e$ U6 ]! o5 C
13. return st.getQuestItemsCount(FANGS_ITEM_ID)
    9 [6 u4 o0 x& F8 c( c; H! {. E
14. 
    2 v% L! K9 m: v
15. def completed(st) :
    ) R0 t) ?9 y  \3 K6 ]
16. st.setState(COMPLETED)
    - [7 B) ]6 S# A" y% x
17. st.clearQuestDrops()
    . u5 I% s4 K8 v: x/ O+ j
18. st.takeItems(FANGS_ITEM_ID,-1)
    
19. st.giveItems(WORLD_MAP_ITEM_ID,1)
    6 c. Y. q' A5 A' A3 L; l3 W& ~
20. st.exitQuest(False)
    
21. return
    
22. 
    
23. def check(st) :
      O! y! ^3 ~) G1 r  i3 z
24. if getCount(st) >= 4 :
    . p% O; B8 o( \& q2 O
25. completed(st)
    
26. return
    1 D# S7 k0 q; i6 `/ c8 t( {$ O3 S5 @
27. 
    9 ?. v9 p: o+ e! y& o9 e
28. class Quest (JQuest):
    
29. 
    9 g4 q% D; C5 u# o$ S
30. def __init__(self,id,name,descr): JQuest.__init__(self,id,name,descr)
    
31. 
    ' K; U/ d5 f- Z9 P$ D5 `
32. def onEvent (self,event,st):
    
33. id = st.getState()
    ( ]( n% U8 _$ W
34. if id == CREATED : st.setState(STARTED)
    6 ?1 U6 V6 g, [
35. elif id == COMPLETED: pass
    
36. elif id == STARTED : check(st)
    ) t* D/ p/ r, \0 s
37. return
    
38. 
    
39. def onKill (self,npcId,st):
    
40. if npcId == KELTIR_NPC_ID:
    
41. n = getCount(st)
    % \7 x- _- p' O5 k; {8 n5 S
42. if n == 0:
    
43. if st.get('chat0') == None :
    
44. st.set("chat0", "true")
    
45. return "Chat0.htm"
    5 T& u0 s8 U1 `( R5 T% v
46. elif n == 1:
    
47. if st.get('chat1') == None :
    " U8 J* }/ B( p( ?9 \# J
48. st.set("chat1", "true")
    ! {' E& H/ _" D5 x, L, g, ^
49. return "Chat1.htm"
    
50. elif n >= 4:
    
51. return "Chat4.htm"
    
52. return "Collect "+str(n)+" of 4 fangs"
    : h6 K. ]- t( Z" T7 a3 G/ _/ y, f
53. return
    8 q: ]% l3 C) a! P/ E+ ~% {
54. 
    ( b; {/ M6 |  N0 {, C- A
55. QUEST    = Quest(201, "Tutorial", "Tutorial quest")
    # L0 k0 g( h5 ?$ S
56. CREATED = State('Start',    QUEST)
    
57. STARTED = State('Started', QUEST)
    + s: @, m3 e, r/ C
58. COMPLETED = State('Completed', QUEST)
    
59. 
    
60. QUEST.setInitialState(CREATED)
    
61. QUEST.addStartNpc(7056)
    0 w1 o& R8 w3 @# y" l! M
62. QUEST.addStartNpc(7012)
    3 X( B3 r  u* y" n
63. QUEST.addStartNpc(7009)
    / R( r5 V# j( @& X7 l
64. QUEST.addStartNpc(7011)
    
65. 
    . |6 s; w3 m) H: [
66. STARTED.addQuestDrop(KELTIR_NPC_ID,FANGS_ITEM_ID,DROP_RATE)
    * B; h( F4 u3 F! l7 D' ^9 R
67. STARTED.addKillId(KELTIR_NPC_ID)
    
68. STARTED.addTalkId(7056)
    % X8 J- i% n7 I* B: q
69. STARTED.addTalkI d(7012)
    
70. STARTED.addTalkId(7009)
    + m4 g1 h" u" g3 |
71. STARTED.addTalkId(7011)

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

: d$ w6 D' J5 N6 x4 I