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

Хроники        Interlude
Сборка        L2j
0 g; Q# d4 `. LОбратите внимание: в файле htm стартового NCP обязательно должна быть ссылка на квест:
2 `0 U4 ~/ ~8 p& F7 F! F" q0 ~; z# g

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

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

Для этого квеста больше ничего не надо. Все необходимое для корректной работы квеста уже добавили. Вот полный текст квеста:
6 N7 W8 n* m+ u" h! {
: k# j, t0 Q' e5 w; N2 Y. ~0 O

1. if getCount(st) >= 4 :
   
2. completed(st)
   0 x. G* T1 O6 Z) \( I/ c+ e
3.   return
   8 Q5 C1 J1 Z+ ~  O
4. 
   $ E% A. G1 Y! z( w. k+ }
5. class Quest (JQuest):
   
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)
   & P* v3 a  F" S6 u) |4 o: C- p6 l, b
10. elif id == COMPLETED: pass
    
11. elif id == STARTED  : check(st)
    & Z# J  ~; C7 J, |! M* R
12. return
    
13. 
    
14. QUEST     = Quest(201,"Tutorial", "Tutorial quest")
    ' {- |! g$ Q& @# p0 o% O
15. CREATED   = State('Start',     QUEST)
    $ F: o7 `" U8 @* r9 s* M% c, q& f0 S
16. STARTED   = State('Started',   QUEST)
    
17. COMPLETED = State('Completed', QUEST)
    
18. 
    1 `& |+ x, S& s- R
19. QUEST.setInitialState(CREATED)
    8 t" F& B$ j4 ?: T
20. QUEST.addStartNpc(7056)
    
21. STARTED.addQuestDrop(KELTIR_NPC_ID,FANGS_ITEM_ID,DROP_RATE)

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

Теперь рассмотрим, как это работает.
4 \6 q3 Y) e/ N* [Игрок подходит к начальному NCP (в данном случае 7056), нажимает на «Quest». Квест будет создан и состояние квеста перейдет к CREATED и игроку будет показана страничка Start.htm с описанием квеста. Тогда метод onEvent, поле открытия странички Start.htm переведет состояние квеста в STARTED и игроку будет показана страничка Started.htm, где будет опсание того, как найти keltirs и .т.д.

+ V9 D4 R# o( m5 B' e! j
0 a! c2 c. G# k+ @При состоянии STARTED будет зарегистрирован дроп «fangs» при убийстве keltirs. Игрок может вернуться к стартовому NCP и спросить о квесте – метод onEvent будет вызван снова. Если у игрока не хватает необходимого количества предметов, то метод check() не переведет квест в следующее состояние и Started.htm будет показана снова. Но если игрок собрал необходимее количество предметов (в данном случае 4 клыка), то метод check() вызовет метод completed() который переведет квест в новое состояние COMPLETED, заберет все клыки, даст карту мира, т.к. это награда за квест, покажет Completed.htm и завершит квест.
6 N. Q0 o6 p, `) i. Q  H4 a

Теперь давайте сделаем наш квест более похожим на то, что он должен из себя представлять.
Прежде всего у нас есть 3 метода для объявления их в Яве – onTalk, onKill и onEvent. Если методы onTalk и onKill не объявлены, то за них все будет делать метод onEvent, т.е. определять квестовых монстров и вызывать диалоги NCP. Есть примечание, методы onTalk и onKill будут вызывать только диалоги с NCP в зависимости от текущего состояния квеста. Метод onKill будет вызываться только тогда, когда мы убиваем квестового монстра.
. X; n# W. C! X. S+ Z! z3 B
) x- t" C( Q, U1 E% d
8 B. w! C& ~2 i2 f+ q8 @$ [; HДавайте рассмотрим как вызывается метод onKill при убийстве keltir в состоянии квеста STARTED:
  T% w& e# ?; R0 g7 y

1. STARTED.addKillId(KELTIR_NPC_ID)

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

и метод onKill в классе Quest:
. I$ J6 w9 Y5 R% B

1. class Quest (JQuest):
   
2.   ...
   ! _3 T: \9 y4 U0 q
3.   def onKill (self,npcId,st):
   
4. if npcId == KELTIR_NPC_ID:
   * H. J0 X; f$ r0 ^
5.    n = getCount(st)
   
6.    if   n == 0:
   0 x- ]( ]7 I/ H+ Y1 _6 u9 _0 b8 O
7.        return "Chat0.htm"
   . a' d  P. q: B
8.    elif n == 1:
   
9.        return "Chat1.htm"
   " z9 _' e* a4 F" {9 Y$ a) ]2 R! D
10.    elif n >= 4:
    
11.        return "Chat4.htm"
    
12.    return "Collected "+str(n)+" of 4 fangs"
    5 x  Y- X8 e  y0 k5 k, E8 g) q
13. return

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

Метод onKill (а так же метод onTalk) имеет следующие параметры:
  w- Q: u8 h. |" ^

• self – квест
• npcId – ID NCP, которого мы должны убивать (если это метод onTalk, то ID того NCP, с которым мы должны поговорить).
• st – текущее состояние игрока.


+ B( _( l3 _% u. p* T8 IВ этом методе мы проверяем и отмечаем, является ли убитый NCP keltir’ом. В основном эта проверка не нужна, т.к. у нас только KELTIR_NPC_ID.

" F* d* L& L$ A5 T% b, n$ p
6 t  S. ]. C; }; ]/ g- BЗатем проверяем количество предметов (в данном случае количество клыков), и если их вообще нет, то возвращаем строку "Chat0.htm", если только один предмет, то возвращаем строку "Chat1.htm", если же предметов 4 или больше, то "Chat4.htm". Если строка возвращена из методов onEvent, onKill или onTalk, то сервер покажет соответствующие htm. В Chat0.htm может иметь следующий текст: «Вы не имеете ни одного клыка, возвращайтесь позже, когда соберете 4 штуки и бла, бла, бла…», в Chat1.htm может быть следующий текст: «У Вас всего 1 клык, по этому соберите еще…». В Chat4.htm – «Вы собрали необходимое количество предметов, возвращайтесь к вашему тренеру, что бы завершить квест…»

' L5 z' `4 B* x( @+ R1 R3 j
Примечание: если в строка return начинается с "<html>", то будет показана страничка html с текстом, который стоит далее. Так вместо:
" t6 B$ I# z. b! Yreturn "Chat4.htm"


можно поставить:

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

# L5 e" ~! \5 H8 g
В каждом квесте строки могут храниться с помощью переменных. Эти переменные сохраняются в Вашей БД. В каждом методе мы можем назначить, прочитать и удалить переменные. Давайте изменим метод onKill, так что бы каждый диалог вызывался только один раз.

1. def onKill (self,npcId,st):
   3 y( R7 G* c6 y6 j; x& E
2. if npcId == KELTIR_NPC_ID:
   ) @1 N8 _4 p, E. F, Y0 w! z& x
3. n = getCount(st)
   + P5 ^5 S5 w% w
4. if n == 0:
   
5. if st.get('chat0') == None :
   " O/ K2 {( \' i
6. st.set("chat0", "true")
   , {  q8 _2 l: A8 P) h
7. return "Chat0.htm"
   
8. elif n == 1:
   % o8 L) f3 n6 y# s( j
9. if st.get('chat1') == None :
   
10. st.set("chat1", "true")
    
11. return "Chat1.htm"
    - x0 S: s8 P: p0 `; m2 c9 v3 v/ }+ a
12. elif n >= 4:
    1 x- f# G; r8 v8 ]* Z, R& f
13. return "Chat4.htm"
    6 [8 ~' ]( y1 |9 R" e
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.

+ _" N$ [. X, p
+ p6 e# W1 r9 V  c& @. j/ yВот конечный рабочий вариант квеста:
0 e& T7 r' D1 A+ T5 P- }" F, m

1. import sys
     w' X) Y/ q* S& j1 G8 Q2 {
2. from net.sf.l2j.gameserver.model.quest import State
   2 R) K& g. {6 Z" X# l5 a4 Q4 d
3. from net.sf.l2j.gameserver.model.quest import QuestState
   " n& z3 Y. F. F7 e& `, }; T
4. from net.sf.l2j.gameserver.model.quest.jython import QuestJython as JQuest
   5 D5 k6 K! g. v* ?9 h# S/ H! E
5. 
   
6. KELTIR_NPC_ID = 12082
   
7. FANGS_ITEM_ID = 1859
   
8. DROP_RATE    = 500000
   $ W8 ^: N) t$ z4 F# @
9. 
   " l. x$ R' Z5 y6 Y
10. WORLD_MAP_ITEM_ID = 1665
    1 h  p2 w( U) `" Z8 Z
11. 
    & w5 b" U6 j: A, `% R- v
12. def getCount(st) :
    
13. return st.getQuestItemsCount(FANGS_ITEM_ID)
    5 P. Q/ x/ F- g: M2 a
14. 
    . Y9 Y2 `) b* I
15. def completed(st) :
    / {2 ^  V  {' |; K. u
16. st.setState(COMPLETED)
    3 _' |: J* r& n4 h/ o' o
17. st.clearQuestDrops()
    7 \, m- {; n- x0 p9 C
18. st.takeItems(FANGS_ITEM_ID,-1)
    
19. st.giveItems(WORLD_MAP_ITEM_ID,1)
    
20. st.exitQuest(False)
    ! B& d' c- r: }+ c5 @0 w
21. return
    8 C- P2 k" G7 {- }
22. 
    - ]! S* \  d2 e3 G% j
23. def check(st) :
    1 @3 C+ A5 h6 ~! w0 x/ X4 q3 d& V
24. if getCount(st) >= 4 :
    
25. completed(st)
    8 R1 D% E6 z8 O- B
26. return
    1 Y+ ?! U" y/ y8 f( N* |" k1 V
27. 
    
28. class Quest (JQuest):
    
29. 
    
30. def __init__(self,id,name,descr): JQuest.__init__(self,id,name,descr)
    
31. 
    ; [; k% ?! p3 [
32. def onEvent (self,event,st):
    
33. id = st.getState()
    ; L6 ^" V0 `0 G$ R
34. if id == CREATED : st.setState(STARTED)
    
35. elif id == COMPLETED: pass
    
36. elif id == STARTED : check(st)
    
37. return
    
38. 
    $ m+ {% i$ U9 \2 u5 A: J
39. def onKill (self,npcId,st):
    
40. if npcId == KELTIR_NPC_ID:
    
41. n = getCount(st)
    ; F0 m, w5 `. W) X! i! A/ \( G( v
42. if n == 0:
    
43. if st.get('chat0') == None :
    ) ?" s" ~: F- Z$ C7 D
44. st.set("chat0", "true")
    8 W$ V6 |% _, X" J* c
45. return "Chat0.htm"
    , l% C% Y/ L2 c5 e- L* L4 G
46. elif n == 1:
    . \( Z+ M7 R8 y" R6 |5 @; w
47. if st.get('chat1') == None :
    
48. st.set("chat1", "true")
    / y; M7 F: P+ A! ^# o9 W3 f
49. return "Chat1.htm"
    8 Z4 U- P1 [& k4 c5 r
50. elif n >= 4:
    
51. return "Chat4.htm"
    
52. return "Collect "+str(n)+" of 4 fangs"
    + B; h7 F+ I6 j$ s- @8 P) m: }3 I! Y
53. return
    
54. 
    
55. QUEST    = Quest(201, "Tutorial", "Tutorial quest")
    $ g6 w, H2 F/ b( [6 ?1 f& P
56. CREATED = State('Start',    QUEST)
    ( }2 Z  u2 N: N1 ^
57. STARTED = State('Started', QUEST)
    
58. COMPLETED = State('Completed', QUEST)
    
59. 
    
60. QUEST.setInitialState(CREATED)
    
61. QUEST.addStartNpc(7056)
    
62. QUEST.addStartNpc(7012)
    
63. QUEST.addStartNpc(7009)
    
64. QUEST.addStartNpc(7011)
    
65. 
    8 W4 Z* t8 W+ d5 L) p! I# b5 o
66. STARTED.addQuestDrop(KELTIR_NPC_ID,FANGS_ITEM_ID,DROP_RATE)
    7 t* u. n/ o. b# ]; C
67. STARTED.addKillId(KELTIR_NPC_ID)
    
68. STARTED.addTalkId(7056)
    
69. STARTED.addTalkI d(7012)
    
70. STARTED.addTalkId(7009)
    ' m4 z% l7 a% [2 B( o
71. STARTED.addTalkId(7011)

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