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

Хроники        Interlude
Сборка        L2j
Обратите внимание: в файле htm стартового NCP обязательно должна быть ссылка на квест:

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

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

Для этого квеста больше ничего не надо. Все необходимое для корректной работы квеста уже добавили. Вот полный текст квеста:
. h5 @; b1 e' z6 S  V3 D9 W

1. if getCount(st) >= 4 :
   " _- g: A- ?  u$ K# k
2. completed(st)
   
3.   return
   
4. 
   
5. class Quest (JQuest):
   + T- X4 v. Z: f3 {
6.   def __init__(self,id,name,descr): JQuest.__init__(self,id,name,descr)
   
7.   def onEvent (self,event,st):
   
8. id = st.getState()
   
9. if   id == CREATED  : st.setState(STARTED)
   
10. elif id == COMPLETED: pass
    
11. elif id == STARTED  : check(st)
    ; B9 z) M/ K8 i! `! q
12. return
    
13. 
    
14. QUEST     = Quest(201,"Tutorial", "Tutorial quest")
    
15. CREATED   = State('Start',     QUEST)
    
16. STARTED   = State('Started',   QUEST)
    - A+ u9 |! X- }$ p9 @8 |9 |
17. COMPLETED = State('Completed', QUEST)
    
18. 
    " u) G; [7 t6 h% I
19. QUEST.setInitialState(CREATED)
    
20. QUEST.addStartNpc(7056)
    
21. STARTED.addQuestDrop(KELTIR_NPC_ID,FANGS_ITEM_ID,DROP_RATE)

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

Теперь рассмотрим, как это работает.
$ k4 S) N! K6 d8 w( V7 y3 QИгрок подходит к начальному NCP (в данном случае 7056), нажимает на «Quest». Квест будет создан и состояние квеста перейдет к CREATED и игроку будет показана страничка Start.htm с описанием квеста. Тогда метод onEvent, поле открытия странички Start.htm переведет состояние квеста в STARTED и игроку будет показана страничка Started.htm, где будет опсание того, как найти keltirs и .т.д.
0 J1 K9 h! r5 F+ `- w
- r5 u' j5 _( K6 G& g8 X3 I3 Q
При состоянии STARTED будет зарегистрирован дроп «fangs» при убийстве keltirs. Игрок может вернуться к стартовому NCP и спросить о квесте – метод onEvent будет вызван снова. Если у игрока не хватает необходимого количества предметов, то метод check() не переведет квест в следующее состояние и Started.htm будет показана снова. Но если игрок собрал необходимее количество предметов (в данном случае 4 клыка), то метод check() вызовет метод completed() который переведет квест в новое состояние COMPLETED, заберет все клыки, даст карту мира, т.к. это награда за квест, покажет Completed.htm и завершит квест.

2 {- e7 P9 o! M/ p5 T
Теперь давайте сделаем наш квест более похожим на то, что он должен из себя представлять.
: w5 }& X8 v! y5 j+ n$ FПрежде всего у нас есть 3 метода для объявления их в Яве – onTalk, onKill и onEvent. Если методы onTalk и onKill не объявлены, то за них все будет делать метод onEvent, т.е. определять квестовых монстров и вызывать диалоги NCP. Есть примечание, методы onTalk и onKill будут вызывать только диалоги с NCP в зависимости от текущего состояния квеста. Метод onKill будет вызываться только тогда, когда мы убиваем квестового монстра.


6 i5 Y: D# D2 ~& L1 O# c# M+ |Давайте рассмотрим как вызывается метод onKill при убийстве keltir в состоянии квеста STARTED:
0 ]6 T! N! J/ @/ M+ w

1. STARTED.addKillId(KELTIR_NPC_ID)

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

и метод onKill в классе Quest:
. j3 ~) `# t9 H+ i
, B3 f* q$ ~& p3 C! Y* J9 H0 u

1. class Quest (JQuest):
   + U5 @6 b4 W. u7 z2 o; W
2.   ...
   
3.   def onKill (self,npcId,st):
   0 N8 m$ p" J% u/ Y8 d
4. if npcId == KELTIR_NPC_ID:
   8 v' P1 u3 `% Z( t' N, i% b
5.    n = getCount(st)
   6 ]" D% f# N& r
6.    if   n == 0:
   8 T, s+ O+ L! y/ {/ z8 c
7.        return "Chat0.htm"
     j! ]- I: w' @$ V, z; z8 M% h2 i
8.    elif n == 1:
   $ s* ]+ T7 F; y* R# ^- Y
9.        return "Chat1.htm"
   % N; f  _9 b! \+ Z; r
10.    elif n >= 4:
    
11.        return "Chat4.htm"
    
12.    return "Collected "+str(n)+" of 4 fangs"
    
13. return

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

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

) T0 n1 k: Q6 H1 s
• self – квест
6 x. ^6 p% W4 K$ Q• npcId – ID NCP, которого мы должны убивать (если это метод onTalk, то ID того NCP, с которым мы должны поговорить).
6 e6 v( U& ]" ~3 l5 Q• st – текущее состояние игрока.


В этом методе мы проверяем и отмечаем, является ли убитый NCP keltir’ом. В основном эта проверка не нужна, т.к. у нас только KELTIR_NPC_ID.


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

' F) |) k2 |8 B% e5 Y8 S: O! ?  U
' z4 {2 ~# X' s9 d: l* I0 a5 VПримечание: если в строка return начинается с "<html>", то будет показана страничка html с текстом, который стоит далее. Так вместо:
9 ~! L! v( e0 @return "Chat4.htm"


* ^) d5 A0 U; j. |; Hможно поставить:
* j3 d" t1 T, q2 {. ^

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 показывались только один раз. Как нам это сделать? С помощью переменных.

* q6 K- r2 U$ M
В каждом квесте строки могут храниться с помощью переменных. Эти переменные сохраняются в Вашей БД. В каждом методе мы можем назначить, прочитать и удалить переменные. Давайте изменим метод onKill, так что бы каждый диалог вызывался только один раз.

1. def onKill (self,npcId,st):
   
2. if npcId == KELTIR_NPC_ID:
   
3. n = getCount(st)
   
4. if n == 0:
   ! N: Z! Z0 M9 l0 T) ~, L; p
5. if st.get('chat0') == None :
   
6. st.set("chat0", "true")
   + t; d" ]( M$ S+ G6 I/ }$ V  z
7. return "Chat0.htm"
   
8. elif n == 1:
   - l% t/ {- h5 D2 s, Z! h
9. if st.get('chat1') == None :
   
10. st.set("chat1", "true")
    $ V6 o- b' |* N# Q9 t$ V- U( D
11. return "Chat1.htm"
    
12. elif n >= 4:
    
13. return "Chat4.htm"
    + B7 ?8 ~7 `$ C4 I( s
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.

) I- N" R% N; H+ y) a7 g
Вот конечный рабочий вариант квеста:

1. import sys
   
2. from net.sf.l2j.gameserver.model.quest import State
   
3. from net.sf.l2j.gameserver.model.quest import QuestState
   3 U9 a7 f5 ~) H0 y- X
4. from net.sf.l2j.gameserver.model.quest.jython import QuestJython as JQuest
   
5. 
   % g8 \8 D, J# I
6. KELTIR_NPC_ID = 12082
     B0 k4 w& X$ K8 U. _) ^/ p/ ]
7. FANGS_ITEM_ID = 1859
   
8. DROP_RATE    = 500000
     G# m6 f& `: R) g
9. 
   ! G% A5 d( U. P0 g% O7 D% ~" P
10. WORLD_MAP_ITEM_ID = 1665
    
11. 
    * a; m+ M/ y; ]  K* n% B
12. def getCount(st) :
    
13. return st.getQuestItemsCount(FANGS_ITEM_ID)
    
14. 
    
15. def completed(st) :
    3 I& a  K6 @( u' @( {/ M! H% {: h9 c
16. st.setState(COMPLETED)
    
17. st.clearQuestDrops()
    3 L5 k9 `; c4 q1 Q5 M3 U
18. st.takeItems(FANGS_ITEM_ID,-1)
    
19. st.giveItems(WORLD_MAP_ITEM_ID,1)
    
20. st.exitQuest(False)
    
21. return
    0 j$ I/ {/ C! r, h; |, {
22. 
    $ G5 M1 W1 k& |, w
23. def check(st) :
    
24. if getCount(st) >= 4 :
    
25. completed(st)
    
26. return
    
27. 
    2 y$ b3 W6 ^) y
28. class Quest (JQuest):
    6 n4 E# n) R. j5 n- r
29. 
    / S- ~  [& x. R+ X* X
30. def __init__(self,id,name,descr): JQuest.__init__(self,id,name,descr)
    ( z9 F& h) E9 u9 y& `) ]
31. 
    
32. def onEvent (self,event,st):
    9 M' e% J, W8 x, \/ Q
33. id = st.getState()
    # `, |# B- ?# {; C
34. if id == CREATED : st.setState(STARTED)
    , u2 v4 }0 f/ ~7 y/ s
35. elif id == COMPLETED: pass
    % T2 W( o& E2 R, ^6 C. ?
36. elif id == STARTED : check(st)
    
37. return
    
38. 
    $ F- p' f$ O2 i& T3 n! |: {9 \
39. def onKill (self,npcId,st):
    
40. if npcId == KELTIR_NPC_ID:
    
41. n = getCount(st)
    - y* h0 w" ~3 {( [
42. if n == 0:
      E4 c/ _5 [* m, l
43. if st.get('chat0') == None :
    
44. st.set("chat0", "true")
    * v. g: w) U8 P. I1 r. F3 F! ?9 E
45. return "Chat0.htm"
    7 v7 T3 p' G3 R4 N; d! y
46. elif n == 1:
    
47. if st.get('chat1') == None :
    * ?, {$ F1 y! o
48. st.set("chat1", "true")
    8 S# @. X* v3 }1 d* H, h
49. return "Chat1.htm"
    
50. elif n >= 4:
    
51. return "Chat4.htm"
    
52. return "Collect "+str(n)+" of 4 fangs"
    9 X4 i; c- `1 e% u
53. return
    ! u) `9 i, J$ _- S  l+ d1 b) S; x) O
54. 
    % O0 o0 U9 ?% ~
55. QUEST    = Quest(201, "Tutorial", "Tutorial quest")
    
56. CREATED = State('Start',    QUEST)
    0 F5 w" ?% A! F1 A
57. STARTED = State('Started', QUEST)
    
58. COMPLETED = State('Completed', QUEST)
    
59. 
    
60. QUEST.setInitialState(CREATED)
    / t- q5 b! `  J$ Z/ M) t( l
61. QUEST.addStartNpc(7056)
    # p  ~* X: b( ~( d
62. QUEST.addStartNpc(7012)
    
63. QUEST.addStartNpc(7009)
    
64. QUEST.addStartNpc(7011)
    2 |0 d0 p7 A5 O" Z5 l- y
65. 
    
66. STARTED.addQuestDrop(KELTIR_NPC_ID,FANGS_ITEM_ID,DROP_RATE)
    
67. STARTED.addKillId(KELTIR_NPC_ID)
    
68. STARTED.addTalkId(7056)
    8 q4 I$ _& r% A* H0 m. H6 R
69. STARTED.addTalkI d(7012)
    1 t; w7 P0 K. k" b* n! S
70. STARTED.addTalkId(7009)
    9 I- U( j; Y+ M* e* ]5 u( r
71. STARTED.addTalkId(7011)

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

3 Q  w" l- N- g# B& I- U