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

Хроники        Interlude
Сборка        L2j
' F* `: C, W" nОбратите внимание: в файле htm стартового NCP обязательно должна быть ссылка на квест:
! |. @7 j" C" h. U

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

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

Для этого квеста больше ничего не надо. Все необходимое для корректной работы квеста уже добавили. Вот полный текст квеста:
% c( ^. G4 [" z6 J5 p' ^6 h

1. if getCount(st) >= 4 :
   
2. completed(st)
   
3.   return
   
4. 
   
5. class Quest (JQuest):
   0 h2 \1 |# ]4 ^7 |# h; w, o
6.   def __init__(self,id,name,descr): JQuest.__init__(self,id,name,descr)
   
7.   def onEvent (self,event,st):
   6 W5 w+ V& Q' c0 `
8. id = st.getState()
   
9. if   id == CREATED  : st.setState(STARTED)
   ( ^& \. `6 h/ x/ s: \. ], u( Z
10. elif id == COMPLETED: pass
    
11. elif id == STARTED  : check(st)
    
12. return
    2 y( c7 B6 l8 a7 L
13. 
    
14. QUEST     = Quest(201,"Tutorial", "Tutorial quest")
    
15. CREATED   = State('Start',     QUEST)
    
16. STARTED   = State('Started',   QUEST)
    5 l4 O0 a& r9 Z) w1 P3 O
17. COMPLETED = State('Completed', QUEST)
    0 L  m+ `5 w: v) h; E3 V8 T
18. 
    / `- t9 f1 j3 X. {0 U+ @
19. QUEST.setInitialState(CREATED)
    9 u9 t; T' Q" s2 s3 v' u+ t
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 и .т.д.
! H1 s" I6 }- T. c

/ z. u( Q, ~' G* WПри состоянии STARTED будет зарегистрирован дроп «fangs» при убийстве keltirs. Игрок может вернуться к стартовому NCP и спросить о квесте – метод onEvent будет вызван снова. Если у игрока не хватает необходимого количества предметов, то метод check() не переведет квест в следующее состояние и Started.htm будет показана снова. Но если игрок собрал необходимее количество предметов (в данном случае 4 клыка), то метод check() вызовет метод completed() который переведет квест в новое состояние COMPLETED, заберет все клыки, даст карту мира, т.к. это награда за квест, покажет Completed.htm и завершит квест.
; M1 r* D1 |9 q# A' `$ ^' n

( x/ u9 H2 K/ m6 F; L$ {Теперь давайте сделаем наш квест более похожим на то, что он должен из себя представлять.
, ~  x. m4 U9 U# K& t. L) FПрежде всего у нас есть 3 метода для объявления их в Яве – onTalk, onKill и onEvent. Если методы onTalk и onKill не объявлены, то за них все будет делать метод onEvent, т.е. определять квестовых монстров и вызывать диалоги NCP. Есть примечание, методы onTalk и onKill будут вызывать только диалоги с NCP в зависимости от текущего состояния квеста. Метод onKill будет вызываться только тогда, когда мы убиваем квестового монстра.
( W# r( Y, \0 S5 I& ?: M
$ w: X+ n  J9 k3 u; Z0 [
Давайте рассмотрим как вызывается метод onKill при убийстве keltir в состоянии квеста STARTED:
1 `1 Y5 o) b" P

1. STARTED.addKillId(KELTIR_NPC_ID)

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

и метод onKill в классе Quest:
; ~/ X: V3 H8 n7 j' A% @' x5 Z

1. class Quest (JQuest):
   ' @0 ]! e4 `1 z! C+ D
2.   ...
   / ~0 E$ ]7 f8 T" I: I9 U6 V
3.   def onKill (self,npcId,st):
   5 V( K# r0 a& ~1 A2 d
4. if npcId == KELTIR_NPC_ID:
   
5.    n = getCount(st)
   0 g; A9 |5 `" L# Y( c
6.    if   n == 0:
   9 a2 J0 @8 z$ M( ~5 g8 a+ @: q4 m* H
7.        return "Chat0.htm"
   / g7 A' S1 i( n. }
8.    elif n == 1:
   ; \# `3 ~) f% W4 f
9.        return "Chat1.htm"
   ) n9 W  B8 X) B
10.    elif n >= 4:
    " [* ]6 E4 i' j1 w0 h( u- W
11.        return "Chat4.htm"
    . N: _- `6 v/ H4 E5 d
12.    return "Collected "+str(n)+" of 4 fangs"
    
13. return

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

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


' p8 y  e/ [* J9 i( o* o7 O: ?• self – квест
• npcId – ID NCP, которого мы должны убивать (если это метод onTalk, то ID того NCP, с которым мы должны поговорить).
7 U; A: R, a" L3 {  }• st – текущее состояние игрока.


, U6 m& y7 @; {В этом методе мы проверяем и отмечаем, является ли убитый NCP keltir’ом. В основном эта проверка не нужна, т.к. у нас только KELTIR_NPC_ID.
) G6 R0 _3 u  n+ [; i
. M+ g; q0 h  Q, s8 v* w
Затем проверяем количество предметов (в данном случае количество клыков), и если их вообще нет, то возвращаем строку "Chat0.htm", если только один предмет, то возвращаем строку "Chat1.htm", если же предметов 4 или больше, то "Chat4.htm". Если строка возвращена из методов onEvent, onKill или onTalk, то сервер покажет соответствующие htm. В Chat0.htm может иметь следующий текст: «Вы не имеете ни одного клыка, возвращайтесь позже, когда соберете 4 штуки и бла, бла, бла…», в Chat1.htm может быть следующий текст: «У Вас всего 1 клык, по этому соберите еще…». В Chat4.htm – «Вы собрали необходимое количество предметов, возвращайтесь к вашему тренеру, что бы завершить квест…»


5 _0 ^7 A# h: s' y. a: A& \Примечание: если в строка return начинается с "<html>", то будет показана страничка html с текстом, который стоит далее. Так вместо:
1 ]8 h# O6 A- M3 d6 f2 kreturn "Chat4.htm"
) I8 y3 t2 r6 W7 ~; h& g5 `# ^
1 S8 W% ~+ M7 b! m5 |1 @+ T4 I
% W, r. V- ~* W1 F! D6 \! W2 iможно поставить:

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

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

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


4 j% m' N4 f: f* }8 \7 T- p! GНаш код для onKill имеет один недостаток. Он будет постоянно показывать Chat0.htm, Chat1.htm и Chat4.htm, нам же необходимо, что бы Chat0.htm и Chat1.htm показывались только один раз. Как нам это сделать? С помощью переменных.
( ?0 e+ m( L' i6 I% i

. r4 A* v" }- K" c2 u9 Z. ZВ каждом квесте строки могут храниться с помощью переменных. Эти переменные сохраняются в Вашей БД. В каждом методе мы можем назначить, прочитать и удалить переменные. Давайте изменим метод onKill, так что бы каждый диалог вызывался только один раз.

1. def onKill (self,npcId,st):
   & P9 Y, ^! G4 l- m
2. if npcId == KELTIR_NPC_ID:
   
3. n = getCount(st)
   
4. if n == 0:
   - b8 f- v7 I6 J+ Y, C0 ?
5. if st.get('chat0') == None :
   & S( n( {6 \0 Z1 @
6. st.set("chat0", "true")
   
7. return "Chat0.htm"
   ) _1 E* t& _; I3 \
8. elif n == 1:
   
9. if st.get('chat1') == None :
   ( m! Y6 _8 B% u9 T" ~
10. st.set("chat1", "true")
    + h# X1 ~# o- h9 C; `
11. return "Chat1.htm"
    2 k" {( |6 ^0 V& U
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.
; X' M) _% A) }0 V4 _
3 k6 h- G( i1 @8 y! y# Z( K$ z5 ^
Вот конечный рабочий вариант квеста:
# ]  i2 a" R' g( v8 Y$ A2 G

1. import sys
   $ @. K3 W* i7 t$ T7 ~
2. from net.sf.l2j.gameserver.model.quest import State
   9 x' e" d' y# \* Y6 g. I
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
   
7. FANGS_ITEM_ID = 1859
   
8. DROP_RATE    = 500000
   : E8 P) q% }4 n+ _5 x2 c8 o$ h
9. 
     D- K5 W% l8 l% M6 G* @# C8 ~
10. WORLD_MAP_ITEM_ID = 1665
    8 `+ e, }, I, ]
11. 
    2 L! r* X8 ?; X' B' x5 M" X
12. def getCount(st) :
    
13. return st.getQuestItemsCount(FANGS_ITEM_ID)
    
14. 
    
15. def completed(st) :
    % m  v1 x; P; R5 I! D
16. st.setState(COMPLETED)
    ( T* {* m5 e) N
17. st.clearQuestDrops()
    
18. st.takeItems(FANGS_ITEM_ID,-1)
    
19. st.giveItems(WORLD_MAP_ITEM_ID,1)
    . u9 A: K' p3 y! ?0 b7 u# _
20. st.exitQuest(False)
      Q+ b+ t* F1 e$ Q
21. return
    
22. 
    . |% O, J* S- G1 N8 g6 @; _
23. def check(st) :
    * |6 k. C+ o; M: R/ v1 ]
24. if getCount(st) >= 4 :
      h! Y, g' ]5 F: Q/ a
25. completed(st)
    
26. return
    
27. 
    & {# z) |$ [4 E/ p
28. class Quest (JQuest):
    
29. 
    9 F& _) R, f2 g$ H) q+ Z# w
30. def __init__(self,id,name,descr): JQuest.__init__(self,id,name,descr)
    , t& E3 f% t, N, f) f7 d4 C$ g
31. 
    
32. def onEvent (self,event,st):
    
33. id = st.getState()
    ) v, V/ r, `* O  B
34. if id == CREATED : st.setState(STARTED)
    + S6 a" W6 w6 _' ~8 B  Y
35. elif id == COMPLETED: pass
    
36. elif id == STARTED : check(st)
    # \; @: h& ]  a5 ]& L) H
37. return
    4 y2 o1 U# y: q; W- M
38. 
    
39. def onKill (self,npcId,st):
    - u( Y7 q3 p1 K2 Q9 b* i5 I
40. if npcId == KELTIR_NPC_ID:
    
41. n = getCount(st)
    ! A' F6 i) I* u3 v3 f4 c" H6 F  z' f
42. if n == 0:
    & O9 a! h6 ~* X: z
43. if st.get('chat0') == None :
    ) @3 \7 Y; z. P
44. st.set("chat0", "true")
    
45. return "Chat0.htm"
    ( Q  E% y. B1 I1 p; ?: C) `
46. elif n == 1:
    , N' G. ^% v9 ~$ R
47. if st.get('chat1') == None :
    
48. st.set("chat1", "true")
    
49. return "Chat1.htm"
    8 ^7 X8 L- h& i: e& Q4 [0 O2 _
50. elif n >= 4:
    
51. return "Chat4.htm"
    
52. return "Collect "+str(n)+" of 4 fangs"
    
53. return
    $ M7 n- X: ^, O' }8 H
54. 
    
55. QUEST    = Quest(201, "Tutorial", "Tutorial quest")
    
56. CREATED = State('Start',    QUEST)
    
57. STARTED = State('Started', QUEST)
    0 C8 Y9 }( \- x: _% g3 _
58. COMPLETED = State('Completed', QUEST)
    
59. 
    3 a+ Z7 l  E, |
60. QUEST.setInitialState(CREATED)
    
61. QUEST.addStartNpc(7056)
    / h: Y" l& e7 v1 N
62. QUEST.addStartNpc(7012)
    9 i7 d5 L0 Y  g* t6 |
63. QUEST.addStartNpc(7009)
    6 L! Z0 z1 f. {( P, o
64. QUEST.addStartNpc(7011)
    1 ~- K5 b& K/ ]9 X( J
65. 
    0 }) F& ]. ?: m( m8 C
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)
    % ]+ S2 Z, |. N- h1 l9 ?' A
70. STARTED.addTalkId(7009)
    
71. STARTED.addTalkId(7011)

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

' w: v6 l( ?9 a4 K" ]