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

Хроники        Interlude
Сборка        L2j
Обратите внимание: в файле htm стартового NCP обязательно должна быть ссылка на квест:
3 v) X3 `# l3 B

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

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

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

$ G5 Y7 ^* [9 v# `5 i2 D+ P

1. if getCount(st) >= 4 :
   
2. completed(st)
   % G; X; `( a  c" W
3.   return
   4 ~  o4 G/ k) N% o% ]1 ~0 C
4. 
   6 T8 Y7 l5 @3 o2 A5 F' a3 c
5. class Quest (JQuest):
   4 Q9 E( Y# ^2 |! I
6.   def __init__(self,id,name,descr): JQuest.__init__(self,id,name,descr)
   : ^: `6 F& K* o' H  M
7.   def onEvent (self,event,st):
   , r* I/ q6 U  @$ ~+ Z( j; Y
8. id = st.getState()
   0 ]; x3 `1 j0 L" e, I$ e  L7 M$ w
9. if   id == CREATED  : st.setState(STARTED)
   4 ^6 E# ?* c$ d7 U. h3 }7 H
10. elif id == COMPLETED: pass
    
11. elif id == STARTED  : check(st)
    ; y/ {) {+ D- n+ H8 k( E% W8 j9 G1 N
12. return
    1 \# ]6 U6 m/ u% q5 `
13. 
    2 `" ?, H  [- Z- p
14. QUEST     = Quest(201,"Tutorial", "Tutorial quest")
    
15. CREATED   = State('Start',     QUEST)
    # V2 P2 ?, V! W- V4 c
16. STARTED   = State('Started',   QUEST)
    + ?, {$ O. t% B; G% y4 I
17. COMPLETED = State('Completed', QUEST)
    3 X. v; I1 O( I& \
18. 
    , l3 U; O3 a3 o! ^4 _; K6 P# {
19. QUEST.setInitialState(CREATED)
    
20. QUEST.addStartNpc(7056)
    5 R  Y9 ]! O/ e  J' X: Q) B4 Q7 h$ S
21. STARTED.addQuestDrop(KELTIR_NPC_ID,FANGS_ITEM_ID,DROP_RATE)

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

Теперь рассмотрим, как это работает.
& Z' C" b9 [* d: f& X* x2 nИгрок подходит к начальному NCP (в данном случае 7056), нажимает на «Quest». Квест будет создан и состояние квеста перейдет к CREATED и игроку будет показана страничка Start.htm с описанием квеста. Тогда метод onEvent, поле открытия странички Start.htm переведет состояние квеста в STARTED и игроку будет показана страничка Started.htm, где будет опсание того, как найти keltirs и .т.д.

9 v6 @5 J* I3 x" C( v  d6 o/ w) ~
При состоянии STARTED будет зарегистрирован дроп «fangs» при убийстве keltirs. Игрок может вернуться к стартовому NCP и спросить о квесте – метод onEvent будет вызван снова. Если у игрока не хватает необходимого количества предметов, то метод check() не переведет квест в следующее состояние и Started.htm будет показана снова. Но если игрок собрал необходимее количество предметов (в данном случае 4 клыка), то метод check() вызовет метод completed() который переведет квест в новое состояние COMPLETED, заберет все клыки, даст карту мира, т.к. это награда за квест, покажет Completed.htm и завершит квест.
  l) o' B: u! {4 m2 L5 y# m
9 ~3 f, ?4 u! C7 d2 @8 \
5 g: y$ j3 W( C2 ]+ KТеперь давайте сделаем наш квест более похожим на то, что он должен из себя представлять.
Прежде всего у нас есть 3 метода для объявления их в Яве – onTalk, onKill и onEvent. Если методы onTalk и onKill не объявлены, то за них все будет делать метод onEvent, т.е. определять квестовых монстров и вызывать диалоги NCP. Есть примечание, методы onTalk и onKill будут вызывать только диалоги с NCP в зависимости от текущего состояния квеста. Метод onKill будет вызываться только тогда, когда мы убиваем квестового монстра.

5 Q, G& f, K) i8 n7 _/ p/ D" ^/ I
Давайте рассмотрим как вызывается метод onKill при убийстве keltir в состоянии квеста STARTED:

1. STARTED.addKillId(KELTIR_NPC_ID)

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

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

: W5 R( s. [7 O. z1 o- k" X

1. class Quest (JQuest):
   
2.   ...
   
3.   def onKill (self,npcId,st):
   7 [3 X- u- S2 O- {8 X
4. if npcId == KELTIR_NPC_ID:
   
5.    n = getCount(st)
   
6.    if   n == 0:
   
7.        return "Chat0.htm"
   
8.    elif n == 1:
   * Y9 f4 \& b* K
9.        return "Chat1.htm"
   % |* W& `" W8 k7 F& h  e& b) f
10.    elif n >= 4:
    
11.        return "Chat4.htm"
    , J, K5 y" x; W& A& B/ g' L
12.    return "Collected "+str(n)+" of 4 fangs"
    
13. return

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

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

8 i' u( q9 Y# N( F
• self – квест
• npcId – ID NCP, которого мы должны убивать (если это метод onTalk, то ID того NCP, с которым мы должны поговорить).
• st – текущее состояние игрока.

0 F( v9 f8 P3 s1 I# ^3 J
0 }1 I) F3 |1 yВ этом методе мы проверяем и отмечаем, является ли убитый NCP keltir’ом. В основном эта проверка не нужна, т.к. у нас только KELTIR_NPC_ID.


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


) u/ Y+ V# k9 G" r  R, kПримечание: если в строка return начинается с "<html>", то будет показана страничка html с текстом, который стоит далее. Так вместо:
return "Chat4.htm"


6 u" ^3 R( j3 V8 Y$ Iможно поставить:

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

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

Так же если строка заканчивается без .htm или в начале нет <html>, то текст будет выведен, как системное сообщение в окне чата. В нашем случае мы сделаем так, что бы при каждом убийстве keltik выводилось системное сообщение: «Собрано N из 4-х клыков».
7 |& t) [2 i; {0 M. a% F9 |8 E
- h# h; i8 ?8 |
Наш код для onKill имеет один недостаток. Он будет постоянно показывать Chat0.htm, Chat1.htm и Chat4.htm, нам же необходимо, что бы Chat0.htm и Chat1.htm показывались только один раз. Как нам это сделать? С помощью переменных.
( c0 a) Y6 f% o! e
/ Y( V$ \) r8 |& p$ |% M
, P' R# a, C; V7 GВ каждом квесте строки могут храниться с помощью переменных. Эти переменные сохраняются в Вашей БД. В каждом методе мы можем назначить, прочитать и удалить переменные. Давайте изменим метод onKill, так что бы каждый диалог вызывался только один раз.
0 D: G- q6 V8 G8 ?% K" S1 n$ b

1. def onKill (self,npcId,st):
   
2. if npcId == KELTIR_NPC_ID:
   1 H3 a0 a# x) Z# `6 ]- Y) v: f  H
3. n = getCount(st)
   
4. if n == 0:
   2 M+ v# x" q: l$ w% n8 I( o3 F% C
5. if st.get('chat0') == None :
   0 b. f. v8 H2 @6 M
6. st.set("chat0", "true")
   - N# I6 W! J4 \7 u# _
7. return "Chat0.htm"
   
8. elif n == 1:
   
9. if st.get('chat1') == None :
   7 m, H2 Y* g" u6 h/ d3 U- u
10. st.set("chat1", "true")
    
11. return "Chat1.htm"
    6 y7 d; ~: a5 y0 ~: N; x
12. elif n >= 4:
    
13. return "Chat4.htm"
    
14. return "Collected "+str(n)+" of 4 fangs"
    2 A2 W" M& d' N" N- J* ^; N
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.
$ y. x2 [% a% p4 V/ i# \

Вот конечный рабочий вариант квеста:

1. import sys
   
2. from net.sf.l2j.gameserver.model.quest import State
   " F: `6 y! L5 J5 c& Y# x
3. from net.sf.l2j.gameserver.model.quest import QuestState
   - q+ w' `1 p5 S
4. from net.sf.l2j.gameserver.model.quest.jython import QuestJython as JQuest
   / a  G* R% Z$ A8 W3 @0 t/ ^
5. 
     T# N) _5 p: r% H- `1 S7 F2 u+ W$ E
6. KELTIR_NPC_ID = 12082
   * R6 h; P: i: o" k
7. FANGS_ITEM_ID = 1859
   
8. DROP_RATE    = 500000
   
9. 
   : g4 p  Z4 Y0 G# s1 {5 z4 F
10. WORLD_MAP_ITEM_ID = 1665
    4 @/ G# ], b/ j' Y  ]# ?
11. 
    ' S! Y0 D; K) c6 |6 Q& @+ }1 a
12. def getCount(st) :
    
13. return st.getQuestItemsCount(FANGS_ITEM_ID)
    % Z7 D. x' P6 d& M" C/ c2 H
14. 
    
15. def completed(st) :
    
16. st.setState(COMPLETED)
    
17. st.clearQuestDrops()
    
18. st.takeItems(FANGS_ITEM_ID,-1)
    
19. st.giveItems(WORLD_MAP_ITEM_ID,1)
    
20. st.exitQuest(False)
    # _6 ?, S7 N% o  q
21. return
      f; h" w: S4 N5 Y2 A! |/ r
22. 
    * I3 w/ v$ V. ]" V
23. def check(st) :
    0 s  Q  d3 y- ~( E& V# |3 E
24. if getCount(st) >= 4 :
    . x0 ~9 C$ r. o; B3 E7 D7 x
25. completed(st)
    , Q- @( b) m) D& L: c2 U" m7 a
26. return
    1 ~( r6 w3 r0 ~1 V) _0 a) A- T
27. 
      C2 `$ L1 L4 d1 D2 P6 k
28. class Quest (JQuest):
    - {0 O, V) u! g+ C' Z: a6 S; b* }
29. 
    
30. def __init__(self,id,name,descr): JQuest.__init__(self,id,name,descr)
    
31. 
    ( j' Z. ?# g, v: C
32. def onEvent (self,event,st):
    * h# w: i6 V3 I0 C4 g; Z) C8 O
33. id = st.getState()
    % p! f/ Z6 j9 y. ~
34. if id == CREATED : st.setState(STARTED)
    
35. elif id == COMPLETED: pass
    ) a& u% d1 {  f  L+ C, A
36. elif id == STARTED : check(st)
    ' v+ G( ^+ Z& u! g" j
37. return
    
38. 
    & f6 S. I3 c& ~$ t" N! Z
39. def onKill (self,npcId,st):
    & F4 M3 h( O1 c( c
40. if npcId == KELTIR_NPC_ID:
    - R8 `. B* U/ G8 A8 F7 b/ N
41. n = getCount(st)
    ; d* H( n6 z+ W3 ~6 J/ C
42. if n == 0:
      M: ^2 Z8 \$ ?$ @9 Q3 V4 {
43. if st.get('chat0') == None :
    $ G9 E( p# g- y) _7 U; c- d/ Q
44. st.set("chat0", "true")
    
45. return "Chat0.htm"
    
46. elif n == 1:
    7 i0 x: {. r$ ?) X) H3 ~; Y5 m$ k
47. if st.get('chat1') == None :
    
48. st.set("chat1", "true")
    - w9 B' S2 ?7 k( H" }; P
49. return "Chat1.htm"
    / K2 i' o2 o7 k: h* _
50. elif n >= 4:
    
51. return "Chat4.htm"
    
52. return "Collect "+str(n)+" of 4 fangs"
      ]* V$ y! q. k! ^
53. return
    - A1 S9 S' G! d
54. 
    
55. QUEST    = Quest(201, "Tutorial", "Tutorial quest")
    7 A2 [( k4 x- x) W2 }% E) F
56. CREATED = State('Start',    QUEST)
    % g; U( t) j* S. i
57. STARTED = State('Started', QUEST)
    9 Z  k; l4 Z: |, k. k
58. COMPLETED = State('Completed', QUEST)
    
59. 
    
60. QUEST.setInitialState(CREATED)
    
61. QUEST.addStartNpc(7056)
    ! M- k  l  v5 i5 b9 S
62. QUEST.addStartNpc(7012)
    
63. QUEST.addStartNpc(7009)
    
64. QUEST.addStartNpc(7011)
    : s& U. q, W# S+ X
65. 
    
66. STARTED.addQuestDrop(KELTIR_NPC_ID,FANGS_ITEM_ID,DROP_RATE)
    
67. STARTED.addKillId(KELTIR_NPC_ID)
    
68. STARTED.addTalkId(7056)
    6 T. p: X1 j6 k: P1 W4 W
69. STARTED.addTalkI d(7012)
    8 m5 r* F+ K3 r% _$ P; L3 L
70. STARTED.addTalkId(7009)
    
71. STARTED.addTalkId(7011)

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

* ?: n% u/ O! r  j! V5 j& @
/ a" o8 ^# j& Q! H9 Z' ~, H1 b