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

Хроники        Interlude
/ ~4 Y1 t5 X8 W7 u) {Сборка        L2j
3 |4 w; U) h( V, oОбратите внимание: в файле htm стартового NCP обязательно должна быть ссылка на квест:

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

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

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

1. if getCount(st) >= 4 :
   
2. completed(st)
   
3.   return
   
4. 
   2 `! I+ N" }5 U! M/ ?9 T9 D
5. class Quest (JQuest):
   
6.   def __init__(self,id,name,descr): JQuest.__init__(self,id,name,descr)
   1 B8 }$ v, E3 U1 j% A5 v
7.   def onEvent (self,event,st):
   
8. id = st.getState()
   
9. if   id == CREATED  : st.setState(STARTED)
   . y  ]/ r% C/ K! A: C
10. elif id == COMPLETED: pass
    
11. elif id == STARTED  : check(st)
    . n) B/ T2 t7 ]0 G( B. n1 n% |
12. return
    3 X3 j, a% Q- `* j* U  O, J/ K
13. 
    ! f# q! P2 W7 C( [% N# b
14. QUEST     = Quest(201,"Tutorial", "Tutorial quest")
    
15. CREATED   = State('Start',     QUEST)
    
16. STARTED   = State('Started',   QUEST)
    
17. COMPLETED = State('Completed', QUEST)
    
18. 
    ( U5 @3 [1 C) }7 S$ O
19. QUEST.setInitialState(CREATED)
    
20. QUEST.addStartNpc(7056)
    ' b$ g' h& U9 m1 I
21. STARTED.addQuestDrop(KELTIR_NPC_ID,FANGS_ITEM_ID,DROP_RATE)

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

Теперь рассмотрим, как это работает.
5 y  q' B, T' y" m$ v0 lИгрок подходит к начальному NCP (в данном случае 7056), нажимает на «Quest». Квест будет создан и состояние квеста перейдет к CREATED и игроку будет показана страничка Start.htm с описанием квеста. Тогда метод onEvent, поле открытия странички Start.htm переведет состояние квеста в STARTED и игроку будет показана страничка Started.htm, где будет опсание того, как найти keltirs и .т.д.


При состоянии STARTED будет зарегистрирован дроп «fangs» при убийстве keltirs. Игрок может вернуться к стартовому NCP и спросить о квесте – метод onEvent будет вызван снова. Если у игрока не хватает необходимого количества предметов, то метод check() не переведет квест в следующее состояние и Started.htm будет показана снова. Но если игрок собрал необходимее количество предметов (в данном случае 4 клыка), то метод check() вызовет метод completed() который переведет квест в новое состояние COMPLETED, заберет все клыки, даст карту мира, т.к. это награда за квест, покажет Completed.htm и завершит квест.


Теперь давайте сделаем наш квест более похожим на то, что он должен из себя представлять.
% N( g9 }0 l: B. B3 J. \Прежде всего у нас есть 3 метода для объявления их в Яве – onTalk, onKill и onEvent. Если методы onTalk и onKill не объявлены, то за них все будет делать метод onEvent, т.е. определять квестовых монстров и вызывать диалоги NCP. Есть примечание, методы onTalk и onKill будут вызывать только диалоги с NCP в зависимости от текущего состояния квеста. Метод onKill будет вызываться только тогда, когда мы убиваем квестового монстра.
7 ~5 \5 J  i, p3 q& x* N
2 l1 d( Q/ l) Q% F; R
. D0 x1 n( i7 JДавайте рассмотрим как вызывается метод onKill при убийстве keltir в состоянии квеста STARTED:

1. STARTED.addKillId(KELTIR_NPC_ID)

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

и метод onKill в классе Quest:
. a7 d, d5 E" C& y: ^, v& N

1. class Quest (JQuest):
   
2.   ...
   6 c6 }7 M" m- B9 w, E& S. Y
3.   def onKill (self,npcId,st):
   
4. if npcId == KELTIR_NPC_ID:
   
5.    n = getCount(st)
   3 L5 W5 l# `- F" J' ]. [/ S! H: e
6.    if   n == 0:
   ; ?, h8 f7 z& r, ^5 o6 Y; c
7.        return "Chat0.htm"
   
8.    elif n == 1:
     g% i7 D& @% l# l. m5 B
9.        return "Chat1.htm"
   7 @* \+ M5 P; [% E% D- R
10.    elif n >= 4:
    : J" f2 P# s4 K
11.        return "Chat4.htm"
    
12.    return "Collected "+str(n)+" of 4 fangs"
    - M  O, B4 O2 s  U1 S1 x' F' @
13. return

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

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


# f% L5 q  S# f4 k# b# _• self – квест
1 t. ^# d% o, Y3 A* m• npcId – ID NCP, которого мы должны убивать (если это метод onTalk, то ID того NCP, с которым мы должны поговорить).
) Q" z3 ~; F$ V• st – текущее состояние игрока.
' f# d1 k6 c  `8 }

В этом методе мы проверяем и отмечаем, является ли убитый NCP keltir’ом. В основном эта проверка не нужна, т.к. у нас только KELTIR_NPC_ID.
0 ]9 Y2 ]% Q, p- c9 g

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

6 J" l# L  ~; z3 ~
Примечание: если в строка return начинается с "<html>", то будет показана страничка html с текстом, который стоит далее. Так вместо:
  ~1 k9 q0 E; Q5 l* Lreturn "Chat4.htm"

- N' K8 X" y7 H& J  Z0 i, `
; D5 t% p5 w% u; b7 dможно поставить:
: s. z! _7 C# u/ i9 a5 H2 z9 F1 m& }

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

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

Так же если строка заканчивается без .htm или в начале нет <html>, то текст будет выведен, как системное сообщение в окне чата. В нашем случае мы сделаем так, что бы при каждом убийстве keltik выводилось системное сообщение: «Собрано N из 4-х клыков».
3 A! U/ H: N) b4 C* i
. b; P) G% P3 h6 l" [
Наш код для onKill имеет один недостаток. Он будет постоянно показывать Chat0.htm, Chat1.htm и Chat4.htm, нам же необходимо, что бы Chat0.htm и Chat1.htm показывались только один раз. Как нам это сделать? С помощью переменных.

) b2 c+ Z) h3 {4 @7 i1 i! r  p5 F
В каждом квесте строки могут храниться с помощью переменных. Эти переменные сохраняются в Вашей БД. В каждом методе мы можем назначить, прочитать и удалить переменные. Давайте изменим метод onKill, так что бы каждый диалог вызывался только один раз.

1. def onKill (self,npcId,st):
   
2. if npcId == KELTIR_NPC_ID:
   
3. n = getCount(st)
   8 x, I# Y3 V3 l4 @
4. if n == 0:
   ! ?7 a: h0 N& i  L" x
5. if st.get('chat0') == None :
   
6. st.set("chat0", "true")
   ' |4 P7 o( O2 v. ?5 J. y  Q
7. return "Chat0.htm"
   
8. elif n == 1:
   1 ]  l/ k# V+ a$ w8 b
9. if st.get('chat1') == None :
   7 w" N9 H# D- m$ I$ N) B5 h) [# j
10. st.set("chat1", "true")
    
11. return "Chat1.htm"
    . g; R5 C5 S; z) Q5 z
12. elif n >= 4:
    ) y5 d# b6 G& X) H6 E6 j7 B
13. return "Chat4.htm"
    6 p0 l4 {+ T' b, h: w$ t
14. return "Collected "+str(n)+" of 4 fangs"
    4 I0 O) A/ n6 x, I
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.
5 l& n: b3 b. ]: }- r
& v  G6 ]1 w/ o$ n) _3 s
Вот конечный рабочий вариант квеста:
0 F1 [9 O+ ~) t( |1 T/ r$ b

1. import sys
   6 I* F! k( B+ [- R  C
2. from net.sf.l2j.gameserver.model.quest import State
   ' S# |2 y3 y( ]9 }. G
3. from net.sf.l2j.gameserver.model.quest import QuestState
   
4. from net.sf.l2j.gameserver.model.quest.jython import QuestJython as JQuest
   ) J2 W+ _7 n3 v' \6 c* a! [) Y
5. 
   
6. KELTIR_NPC_ID = 12082
   ) t- x4 b4 E6 o8 }8 T  @0 a% y
7. FANGS_ITEM_ID = 1859
     [7 R2 W+ q3 O+ L
8. DROP_RATE    = 500000
   7 |$ d/ H- `8 P( \3 {3 e, u
9. 
   
10. WORLD_MAP_ITEM_ID = 1665
    - j0 }' C/ t* u# x
11. 
    ( l: o5 c( F8 Q* ~; d
12. def getCount(st) :
    - H+ u' i3 |: X1 s4 m
13. return st.getQuestItemsCount(FANGS_ITEM_ID)
    
14. 
    
15. def completed(st) :
    0 w: H! {! B5 _3 E6 O  e% w2 T/ i
16. st.setState(COMPLETED)
    
17. st.clearQuestDrops()
    
18. st.takeItems(FANGS_ITEM_ID,-1)
    8 O( r: a; {+ d; T
19. st.giveItems(WORLD_MAP_ITEM_ID,1)
    9 o) i6 c& c1 S! l( ?1 \& X0 b
20. st.exitQuest(False)
    
21. return
    5 P  S7 C+ {# w( K# y3 ~
22. 
    1 q$ b& k: t7 X: x5 D
23. def check(st) :
    ) z6 S- p( \2 o# Z+ ^3 M: L, S
24. if getCount(st) >= 4 :
    
25. completed(st)
      C- _) \, G1 p
26. return
    
27. 
    ( @; ?& J1 a" }
28. class Quest (JQuest):
    
29. 
    
30. def __init__(self,id,name,descr): JQuest.__init__(self,id,name,descr)
    
31. 
    
32. def onEvent (self,event,st):
    - t; n: X4 K+ S, N* B  A
33. id = st.getState()
    
34. if id == CREATED : st.setState(STARTED)
    7 P+ i* y8 {  N5 h0 G/ f4 `
35. elif id == COMPLETED: pass
    4 K: G0 l+ {5 v8 q5 J
36. elif id == STARTED : check(st)
    
37. return
    / F( u1 i) Y* w& [
38. 
    ( A  P; V4 ~6 @5 `+ [- a5 z9 j- x
39. def onKill (self,npcId,st):
    
40. if npcId == KELTIR_NPC_ID:
    
41. n = getCount(st)
    3 i# W' g- W! V8 T1 v: [& a$ Y4 O5 m
42. if n == 0:
    
43. if st.get('chat0') == None :
    0 y6 \4 B% \, W
44. st.set("chat0", "true")
    $ G! c. t1 \- H! _
45. return "Chat0.htm"
    3 i8 I- K; |3 P/ o
46. elif n == 1:
    ) ~2 h( e& S5 O' a! @/ n: W
47. if st.get('chat1') == None :
    " p  _, J  @# C' l- ]8 `; v4 \
48. st.set("chat1", "true")
    
49. return "Chat1.htm"
    * E6 _7 L: ^; l( ]
50. elif n >= 4:
    
51. return "Chat4.htm"
    
52. return "Collect "+str(n)+" of 4 fangs"
    5 w* l" h  M9 A' `$ ]
53. return
    
54. 
    6 J0 f) f4 E5 N% @0 X
55. QUEST    = Quest(201, "Tutorial", "Tutorial quest")
    4 W& n: o! |" R: r6 b# ^
56. CREATED = State('Start',    QUEST)
    
57. STARTED = State('Started', QUEST)
    9 Z) v! K3 I; E5 Q2 w) T. Z5 M
58. COMPLETED = State('Completed', QUEST)
    7 L! K# j( Q* G0 A( `% s6 ^7 q: d
59. 
    
60. QUEST.setInitialState(CREATED)
    % {) c5 t( G7 e" b& V& }
61. QUEST.addStartNpc(7056)
    
62. QUEST.addStartNpc(7012)
    
63. QUEST.addStartNpc(7009)
    
64. QUEST.addStartNpc(7011)
    
65. 
    
66. STARTED.addQuestDrop(KELTIR_NPC_ID,FANGS_ITEM_ID,DROP_RATE)
    
67. STARTED.addKillId(KELTIR_NPC_ID)
    % W! q" v" C0 S$ h1 _% I
68. STARTED.addTalkId(7056)
    
69. STARTED.addTalkI d(7012)
    
70. STARTED.addTalkId(7009)
    
71. STARTED.addTalkId(7011)

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

$ {8 q! e6 Y, p/ a