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

Хроники        Interlude
; e7 J" `- M2 _2 _8 gСборка        L2j
Обратите внимание: в файле htm стартового NCP обязательно должна быть ссылка на квест:

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

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

Для этого квеста больше ничего не надо. Все необходимое для корректной работы квеста уже добавили. Вот полный текст квеста:
7 {4 p. i- r% U/ k
6 n# d, I: X: o, I* Q8 I* H

1. if getCount(st) >= 4 :
   7 x4 l# X3 q  u7 c* g- [% Q
2. completed(st)
   5 z8 h7 [) `& X# z  y  g4 X
3.   return
   ) M; D& A( s1 y/ M5 z+ c4 q
4. 
   8 Z' \% U& }$ n2 a
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()
   & s' ~) W. ]% o* T" `. n
9. if   id == CREATED  : st.setState(STARTED)
   
10. elif id == COMPLETED: pass
    
11. elif id == STARTED  : check(st)
    7 V8 L8 h* w1 p3 ~: T( H, a3 N
12. return
    
13. 
    5 W6 b1 m' h" q6 `! ]
14. QUEST     = Quest(201,"Tutorial", "Tutorial quest")
    
15. CREATED   = State('Start',     QUEST)
    0 f- ]; C; z) B7 y/ I% \
16. STARTED   = State('Started',   QUEST)
    
17. COMPLETED = State('Completed', QUEST)
    # `( ]  i# P. b) J  @7 K
18. 
    
19. QUEST.setInitialState(CREATED)
    
20. QUEST.addStartNpc(7056)
    % n' O+ n3 Z7 x" P- ~) O' a
21. STARTED.addQuestDrop(KELTIR_NPC_ID,FANGS_ITEM_ID,DROP_RATE)

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

Теперь рассмотрим, как это работает.
4 D' ?7 h' I: x% [! ?0 YИгрок подходит к начальному NCP (в данном случае 7056), нажимает на «Quest». Квест будет создан и состояние квеста перейдет к CREATED и игроку будет показана страничка Start.htm с описанием квеста. Тогда метод onEvent, поле открытия странички Start.htm переведет состояние квеста в STARTED и игроку будет показана страничка Started.htm, где будет опсание того, как найти keltirs и .т.д.
; Q: f* i- I7 K9 c$ ^1 b; ]4 y& u
8 S. ?3 r3 C: N
При состоянии STARTED будет зарегистрирован дроп «fangs» при убийстве keltirs. Игрок может вернуться к стартовому NCP и спросить о квесте – метод onEvent будет вызван снова. Если у игрока не хватает необходимого количества предметов, то метод check() не переведет квест в следующее состояние и Started.htm будет показана снова. Но если игрок собрал необходимее количество предметов (в данном случае 4 клыка), то метод check() вызовет метод completed() который переведет квест в новое состояние COMPLETED, заберет все клыки, даст карту мира, т.к. это награда за квест, покажет Completed.htm и завершит квест.
5 Y* r1 R' _, S# m$ {4 t
4 v0 Z$ d( X) ^  V  b
Теперь давайте сделаем наш квест более похожим на то, что он должен из себя представлять.
; H1 F. \3 n  X6 f0 q/ o, FПрежде всего у нас есть 3 метода для объявления их в Яве – onTalk, onKill и onEvent. Если методы onTalk и onKill не объявлены, то за них все будет делать метод onEvent, т.е. определять квестовых монстров и вызывать диалоги NCP. Есть примечание, методы onTalk и onKill будут вызывать только диалоги с NCP в зависимости от текущего состояния квеста. Метод onKill будет вызываться только тогда, когда мы убиваем квестового монстра.
, a* _' E% B. |

2 ^" f, [9 h9 ^7 NДавайте рассмотрим как вызывается метод onKill при убийстве keltir в состоянии квеста STARTED:

1. STARTED.addKillId(KELTIR_NPC_ID)

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

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

  y) {1 k9 z( q6 P+ W! C- \

1. class Quest (JQuest):
   " o$ a  v- v5 c% l9 s
2.   ...
   
3.   def onKill (self,npcId,st):
   2 C3 A: \  y5 t+ t4 a
4. if npcId == KELTIR_NPC_ID:
   " n( \6 E' n0 B3 N- l- h9 j& W5 k
5.    n = getCount(st)
   
6.    if   n == 0:
   
7.        return "Chat0.htm"
   & f% X7 O2 i- d4 v+ `9 Z/ h
8.    elif n == 1:
   
9.        return "Chat1.htm"
   " p+ l2 @4 ?" J1 S
10.    elif n >= 4:
    
11.        return "Chat4.htm"
    ( l" O# z0 Z+ L# t7 X9 h
12.    return "Collected "+str(n)+" of 4 fangs"
    
13. return

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

Метод onKill (а так же метод onTalk) имеет следующие параметры:
) ^9 K5 O7 C1 [1 `1 _
4 X' ~. m  W! ^1 d" h: B8 ~
7 E3 Y9 S3 }9 {3 [) V• self – квест
/ @/ `5 F: Y; x+ E% K• npcId – ID NCP, которого мы должны убивать (если это метод onTalk, то ID того NCP, с которым мы должны поговорить).
% q5 M& O$ s6 I• st – текущее состояние игрока.

% m6 [( C4 _% p  @0 e# h% d
В этом методе мы проверяем и отмечаем, является ли убитый NCP keltir’ом. В основном эта проверка не нужна, т.к. у нас только KELTIR_NPC_ID.
: e! i9 a" o% u

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

Примечание: если в строка return начинается с "<html>", то будет показана страничка html с текстом, который стоит далее. Так вместо:
return "Chat4.htm"
5 u- e5 H8 Q8 J! ?0 l
. x7 G- }" P2 F! ?4 p' {8 K
+ D% f7 I7 q+ a% q3 {+ e# c, ]можно поставить:
0 B4 g' M/ O5 A

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

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

Так же если строка заканчивается без .htm или в начале нет <html>, то текст будет выведен, как системное сообщение в окне чата. В нашем случае мы сделаем так, что бы при каждом убийстве keltik выводилось системное сообщение: «Собрано N из 4-х клыков».
& l0 Z  a) U0 w9 s- z
; i' A4 c# n7 F, ~' U
Наш код для onKill имеет один недостаток. Он будет постоянно показывать Chat0.htm, Chat1.htm и Chat4.htm, нам же необходимо, что бы Chat0.htm и Chat1.htm показывались только один раз. Как нам это сделать? С помощью переменных.


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

1. def onKill (self,npcId,st):
   
2. if npcId == KELTIR_NPC_ID:
   
3. n = getCount(st)
   7 c3 |. R- B& }, J
4. if n == 0:
   ; x1 _- Q- [4 U& U
5. if st.get('chat0') == None :
   
6. st.set("chat0", "true")
     s1 E- w! e6 I( i% B4 N' a
7. return "Chat0.htm"
   / \4 C8 O: o/ R1 c# t( y  \- v
8. elif n == 1:
   
9. if st.get('chat1') == None :
   % A; c1 ?( z. D5 n; U
10. st.set("chat1", "true")
    
11. return "Chat1.htm"
    ' S$ x  T! q& t* p9 g6 U
12. elif n >= 4:
    
13. return "Chat4.htm"
    
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.
" V3 R( Y; m0 G7 h+ g+ T9 N) U9 ?
( n, w& \2 ^, n1 `" ?
1 a' L0 H: [( iВот конечный рабочий вариант квеста:

1. import sys
   
2. from net.sf.l2j.gameserver.model.quest import State
   
3. from net.sf.l2j.gameserver.model.quest import QuestState
   
4. from net.sf.l2j.gameserver.model.quest.jython import QuestJython as JQuest
   
5. 
   & S0 v8 C& h9 ~* A* S/ |! k0 Q
6. KELTIR_NPC_ID = 12082
   9 e! w$ q  E( Q9 R# {( a  Y
7. FANGS_ITEM_ID = 1859
   
8. DROP_RATE    = 500000
   
9. 
   * u' ^7 T( D0 Z% b5 d
10. WORLD_MAP_ITEM_ID = 1665
    
11. 
    
12. def getCount(st) :
    
13. return st.getQuestItemsCount(FANGS_ITEM_ID)
    0 C! T& a" x3 c$ |
14. 
    - `0 U; t0 m! S" W) W
15. def completed(st) :
    
16. st.setState(COMPLETED)
    . K8 J& W7 o3 O2 Z+ s4 Z
17. st.clearQuestDrops()
    
18. st.takeItems(FANGS_ITEM_ID,-1)
    # x  v- y3 ?! ]
19. st.giveItems(WORLD_MAP_ITEM_ID,1)
    
20. st.exitQuest(False)
    4 m+ c- B. \8 b3 [1 O
21. return
    % g* a- @, S5 V5 o/ ?
22. 
    
23. def check(st) :
    0 G. f9 n* i' K$ h& l' N8 e* e3 X5 N
24. if getCount(st) >= 4 :
    
25. completed(st)
    
26. return
    
27. 
    
28. class Quest (JQuest):
    
29. 
    ( b% Q/ m$ z' h: d' M" M& p& K
30. def __init__(self,id,name,descr): JQuest.__init__(self,id,name,descr)
    
31. 
    
32. def onEvent (self,event,st):
    
33. id = st.getState()
    
34. if id == CREATED : st.setState(STARTED)
    " T5 p/ G7 G6 h+ J
35. elif id == COMPLETED: pass
    
36. elif id == STARTED : check(st)
    
37. return
    & r0 L( ^! X! \9 I
38. 
    / ]1 a1 B) U7 x
39. def onKill (self,npcId,st):
    9 l$ }2 L, _! K5 c' h
40. if npcId == KELTIR_NPC_ID:
    
41. n = getCount(st)
    ) m3 J7 o+ H; F9 u( m
42. if n == 0:
      ]* L2 ]% h( u
43. if st.get('chat0') == None :
    , B& @6 \0 j" o
44. st.set("chat0", "true")
    
45. return "Chat0.htm"
    8 J& u0 M  J8 C
46. elif n == 1:
    
47. if st.get('chat1') == None :
    $ A6 D. ~7 m7 B7 \6 H! z
48. st.set("chat1", "true")
    - y" z% f/ I, L) ^8 `( H
49. return "Chat1.htm"
    
50. elif n >= 4:
    
51. return "Chat4.htm"
    
52. return "Collect "+str(n)+" of 4 fangs"
    3 j' V& w% N- s/ k5 e7 J
53. return
    * K2 i$ @: @% }5 V
54. 
    
55. QUEST    = Quest(201, "Tutorial", "Tutorial quest")
    2 ~* |5 K4 P# k/ A. B  O
56. CREATED = State('Start',    QUEST)
    
57. STARTED = State('Started', QUEST)
    
58. COMPLETED = State('Completed', QUEST)
    
59. 
    
60. QUEST.setInitialState(CREATED)
    0 `, x0 o4 Q1 L$ I& j- E' b
61. QUEST.addStartNpc(7056)
    
62. QUEST.addStartNpc(7012)
    9 f. O6 Z; ?/ f4 L' P& A) X
63. QUEST.addStartNpc(7009)
    
64. QUEST.addStartNpc(7011)
    
65. 
    0 Q! d* B7 d. F
66. STARTED.addQuestDrop(KELTIR_NPC_ID,FANGS_ITEM_ID,DROP_RATE)
    1 V# P1 i9 S' o8 ~3 }4 _) \
67. STARTED.addKillId(KELTIR_NPC_ID)
    ' b5 b; b5 m1 U9 l; j  y" u/ U  ?
68. STARTED.addTalkId(7056)
      H: c: a" j0 h+ ?6 p# N$ S
69. STARTED.addTalkI d(7012)
    ) Z$ j- m! c& L+ z
70. STARTED.addTalkId(7009)
    
71. STARTED.addTalkId(7011)

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

7 I. d( Q8 z& U% {8 f