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

Хроники        Interlude
! [; D! \8 {8 `+ D$ mСборка        L2j
2 k( t, m2 d% `9 {& YОбратите внимание: в файле htm стартового NCP обязательно должна быть ссылка на квест:
( Y! I2 M! l& o

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

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

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

& A) ~2 O9 u+ u/ M1 V1 w  A" _% U

1. if getCount(st) >= 4 :
   ) l. ^" C" v3 R) e
2. completed(st)
   
3.   return
   ( g- E6 U! z0 E3 D& q" I
4. 
   4 J' ^* z" Q+ V5 i: ?8 [5 f
5. class Quest (JQuest):
   * H/ A7 D+ Y) I/ N# ?9 D
6.   def __init__(self,id,name,descr): JQuest.__init__(self,id,name,descr)
   
7.   def onEvent (self,event,st):
   
8. id = st.getState()
   2 b- o& p* U7 X/ H$ v" U& {
9. if   id == CREATED  : st.setState(STARTED)
   # C  c1 e" Q* h. s2 s$ d
10. elif id == COMPLETED: pass
    9 Q: {/ T/ n% ]# l6 C9 G' [: f  N
11. elif id == STARTED  : check(st)
    $ h8 F3 Z( ]/ p9 D
12. return
    , j' q( ]: e  y! X
13. 
    ( z3 N; w, b6 C9 g' O/ U3 P3 r
14. QUEST     = Quest(201,"Tutorial", "Tutorial quest")
    $ ^! G/ e. F; W3 e# L4 F$ H
15. CREATED   = State('Start',     QUEST)
    
16. STARTED   = State('Started',   QUEST)
    
17. COMPLETED = State('Completed', QUEST)
    . a" S' f* g% k5 w( Y( ~. h
18. 
    % B" G0 W( _) F0 b" S# j
19. QUEST.setInitialState(CREATED)
    ; ]/ I; Z4 P) a5 I
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 и .т.д.
# \& E( B* P; d# a

7 f1 I8 x" v; T# E! `  G- c& BПри состоянии STARTED будет зарегистрирован дроп «fangs» при убийстве keltirs. Игрок может вернуться к стартовому NCP и спросить о квесте – метод onEvent будет вызван снова. Если у игрока не хватает необходимого количества предметов, то метод check() не переведет квест в следующее состояние и Started.htm будет показана снова. Но если игрок собрал необходимее количество предметов (в данном случае 4 клыка), то метод check() вызовет метод completed() который переведет квест в новое состояние COMPLETED, заберет все клыки, даст карту мира, т.к. это награда за квест, покажет Completed.htm и завершит квест.


Теперь давайте сделаем наш квест более похожим на то, что он должен из себя представлять.
Прежде всего у нас есть 3 метода для объявления их в Яве – onTalk, onKill и onEvent. Если методы onTalk и onKill не объявлены, то за них все будет делать метод onEvent, т.е. определять квестовых монстров и вызывать диалоги NCP. Есть примечание, методы onTalk и onKill будут вызывать только диалоги с NCP в зависимости от текущего состояния квеста. Метод onKill будет вызываться только тогда, когда мы убиваем квестового монстра.
) [( A/ f/ r9 e9 N8 _
- p2 ~  ~' x0 |
6 w# t7 ~  k# P" C2 V  o) OДавайте рассмотрим как вызывается метод onKill при убийстве keltir в состоянии квеста STARTED:
4 N, X  i6 B9 e: o

1. STARTED.addKillId(KELTIR_NPC_ID)

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

и метод onKill в классе Quest:
. {/ h7 R2 ?  k1 |, |

1. class Quest (JQuest):
   
2.   ...
   - P4 K% W( I2 y# U. j6 Z
3.   def onKill (self,npcId,st):
   
4. if npcId == KELTIR_NPC_ID:
   
5.    n = getCount(st)
   
6.    if   n == 0:
   
7.        return "Chat0.htm"
   
8.    elif n == 1:
   2 q1 [9 O0 d& b5 e2 ]
9.        return "Chat1.htm"
   
10.    elif n >= 4:
    4 N8 _8 K3 z& j/ q0 n+ @' X6 \, h
11.        return "Chat4.htm"
    
12.    return "Collected "+str(n)+" of 4 fangs"
    
13. return

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

Метод onKill (а так же метод onTalk) имеет следующие параметры:
5 L$ N2 [" W" R( S5 _

• self – квест
8 q! [7 c; E0 E) i9 a2 }' P0 o• npcId – ID NCP, которого мы должны убивать (если это метод onTalk, то ID того NCP, с которым мы должны поговорить).
/ B: t; P, {  y4 v- e0 Y• st – текущее состояние игрока.


- `' g; z* L# H; ?0 xВ этом методе мы проверяем и отмечаем, является ли убитый NCP keltir’ом. В основном эта проверка не нужна, т.к. у нас только KELTIR_NPC_ID.
. j* p. o& i6 |/ C2 m8 @
% [* n. H1 R+ n& O4 Z+ d
Затем проверяем количество предметов (в данном случае количество клыков), и если их вообще нет, то возвращаем строку "Chat0.htm", если только один предмет, то возвращаем строку "Chat1.htm", если же предметов 4 или больше, то "Chat4.htm". Если строка возвращена из методов onEvent, onKill или onTalk, то сервер покажет соответствующие htm. В Chat0.htm может иметь следующий текст: «Вы не имеете ни одного клыка, возвращайтесь позже, когда соберете 4 штуки и бла, бла, бла…», в Chat1.htm может быть следующий текст: «У Вас всего 1 клык, по этому соберите еще…». В Chat4.htm – «Вы собрали необходимое количество предметов, возвращайтесь к вашему тренеру, что бы завершить квест…»

1 [6 G2 |. c9 A& \2 i
Примечание: если в строка return начинается с "<html>", то будет показана страничка html с текстом, который стоит далее. Так вместо:
  U+ a& I+ u" ?+ yreturn "Chat4.htm"
: k, D: K! ]( e$ P

можно поставить:
/ }9 B3 i8 c4 v/ x4 T

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

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

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


! `7 h  V% E% RНаш код для onKill имеет один недостаток. Он будет постоянно показывать Chat0.htm, Chat1.htm и Chat4.htm, нам же необходимо, что бы Chat0.htm и Chat1.htm показывались только один раз. Как нам это сделать? С помощью переменных.
" y1 t7 j/ z* ]  w. b' o& `
8 m  Z  M1 X  X  j
8 L6 `9 P8 ]' F; j- UВ каждом квесте строки могут храниться с помощью переменных. Эти переменные сохраняются в Вашей БД. В каждом методе мы можем назначить, прочитать и удалить переменные. Давайте изменим метод onKill, так что бы каждый диалог вызывался только один раз.

1. def onKill (self,npcId,st):
   
2. if npcId == KELTIR_NPC_ID:
   1 N8 W1 E& I5 m6 i0 B7 j8 U
3. n = getCount(st)
   " n0 S1 r* b) {2 K/ W
4. if n == 0:
   5 D! v4 g1 G2 J  @1 Z
5. if st.get('chat0') == None :
   6 Y+ e7 u: D' c6 B/ a3 N
6. st.set("chat0", "true")
   
7. return "Chat0.htm"
   
8. elif n == 1:
   
9. if st.get('chat1') == None :
   
10. st.set("chat1", "true")
    # [( n8 I5 s# ^7 L* x
11. return "Chat1.htm"
    3 ^. E; i; J$ G- W) k+ X8 |6 X
12. elif n >= 4:
    4 f( l+ w4 ]- J3 g4 R9 y
13. return "Chat4.htm"
    5 I* Y- {: ^7 J% M2 [
14. return "Collected "+str(n)+" of 4 fangs"
    6 p* L$ P/ b% 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.

( Z9 w' X6 V, E
( H; C" ^# q( l% F- x9 A5 {/ DВот конечный рабочий вариант квеста:
( u, t: W' T/ ]1 [! S6 x2 b/ U) Q

1. import sys
   1 @! S3 F$ l# L$ V3 `" h
2. from net.sf.l2j.gameserver.model.quest import State
   
3. from net.sf.l2j.gameserver.model.quest import QuestState
   ) O  D$ k( [( I3 Q  i
4. from net.sf.l2j.gameserver.model.quest.jython import QuestJython as JQuest
   
5. 
   " `& y# A. k0 j, }9 m, L1 ]# _2 G8 v
6. KELTIR_NPC_ID = 12082
   + f3 y$ p/ Y3 B3 \* Q6 x! P$ j
7. FANGS_ITEM_ID = 1859
   
8. DROP_RATE    = 500000
   
9. 
   / n9 A! ^+ j- `& t
10. WORLD_MAP_ITEM_ID = 1665
    8 }" [: Z7 l( C& t& |# _
11. 
      R; [% s6 M% O, @) S6 I/ `0 r
12. def getCount(st) :
    , V' V# X0 y6 X: D0 w
13. return st.getQuestItemsCount(FANGS_ITEM_ID)
    & I9 s& @9 C* m
14. 
    
15. def completed(st) :
    ' v! W- v/ s8 g! p* \; L
16. st.setState(COMPLETED)
    ) o3 F8 o, Y/ V% s
17. st.clearQuestDrops()
    ( B$ F4 F1 ^2 b  Y# u
18. st.takeItems(FANGS_ITEM_ID,-1)
    
19. st.giveItems(WORLD_MAP_ITEM_ID,1)
    
20. st.exitQuest(False)
    & N0 u3 b& \  V
21. return
    ) ~4 q; l1 D! S) ]
22. 
    9 h2 k6 d: c3 V" M
23. def check(st) :
    8 c; w( f' w: C- v$ h9 P: v
24. if getCount(st) >= 4 :
    
25. completed(st)
    6 N7 @, n# f% Z8 G$ F1 C' }5 S
26. return
    
27. 
    
28. class Quest (JQuest):
    8 W9 B7 ]8 N$ T/ k
29. 
    , ]' ^" a& Y8 }
30. def __init__(self,id,name,descr): JQuest.__init__(self,id,name,descr)
    : ?6 n4 g) Y; L
31. 
    
32. def onEvent (self,event,st):
    
33. id = st.getState()
    8 L. ]* p, ?9 K$ j. Z& t& Y6 G  g
34. if id == CREATED : st.setState(STARTED)
    
35. elif id == COMPLETED: pass
    
36. elif id == STARTED : check(st)
    . S7 w$ r0 v( x
37. return
    
38. 
    
39. def onKill (self,npcId,st):
    
40. if npcId == KELTIR_NPC_ID:
    
41. n = getCount(st)
    $ Q* @" G& q% B$ b$ h' z
42. if n == 0:
    
43. if st.get('chat0') == None :
    6 b% T( @" w) X/ ^
44. st.set("chat0", "true")
    1 J, y: d; Y9 c4 s( _
45. return "Chat0.htm"
    
46. elif n == 1:
    ) S  N, X5 {" K7 h! S' d
47. if st.get('chat1') == None :
    * ]4 y1 I7 C3 e6 n/ W$ c
48. st.set("chat1", "true")
    $ H- |& g- {0 Q1 u/ Q4 S1 u# \/ Q
49. return "Chat1.htm"
    : Y: J7 c4 P: n# a+ h; H" u* g" p
50. elif n >= 4:
    
51. return "Chat4.htm"
    
52. return "Collect "+str(n)+" of 4 fangs"
    
53. return
    & s; }+ t+ l  Q: L; ^, U
54. 
    
55. QUEST    = Quest(201, "Tutorial", "Tutorial quest")
    & j- J7 H7 i/ \5 D& D  H* x# Y  H
56. CREATED = State('Start',    QUEST)
    2 Z4 v; `2 V2 q# H
57. STARTED = State('Started', QUEST)
    3 M: T& D- T2 }- i* g
58. COMPLETED = State('Completed', QUEST)
    - j9 p( q( O) v, h  ~
59. 
    ; ^9 s6 Z" B1 c& ~$ P, N8 E% h1 I; T
60. QUEST.setInitialState(CREATED)
    
61. QUEST.addStartNpc(7056)
    
62. QUEST.addStartNpc(7012)
    
63. QUEST.addStartNpc(7009)
    # N9 M6 I7 u5 }7 ^7 r* L8 s1 e% v
64. QUEST.addStartNpc(7011)
    & f& Y& `+ k: \* G
65. 
    
66. STARTED.addQuestDrop(KELTIR_NPC_ID,FANGS_ITEM_ID,DROP_RATE)
    " ?8 i/ f# ]6 v7 r2 O0 o  z. T2 B# {
67. STARTED.addKillId(KELTIR_NPC_ID)
    
68. STARTED.addTalkId(7056)
    + J3 v$ |/ c; D) q: b3 u+ K
69. STARTED.addTalkI d(7012)
    6 t- t2 B2 ~7 [9 V1 ?! G
70. STARTED.addTalkId(7009)
    
71. STARTED.addTalkId(7011)

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

  j0 k- o9 f/ d  f6 b: F