Гайд по основным Java-файлам ядра сервер L2J_Mobius

Гайд по основным Java-файлам ядра сервер L2J_Mobius

" y" C. D- g- X  u4 E0 IРазбор файла QuestManager.java
& i' @$ d; F. Q: J, l* u% f  B/ I' c
+ ?7 e7 j1 T6 j! o; o# O2 [4 T6 cЭтот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
' T; b1 ^6 g6 V  cОсновные элементы

• Лицензия
  5 M* c/ c: ?, {0 s( o2 [
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    ' w! T# B+ H! ?4 n) t. B
• Импорты
  6 ~, S! w5 f) q, W% B) ^

QuestManager.java — управление квестами и скриптами.
Путь: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\

  o& q9 M  X+ T: r( H4 }1 E# a2 W
Давай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
1. Лицензионное соглашение
6 k/ L& ?9 L. s* q

1. /*
   
2. * Этот файл является частью проекта L2J Mobius.
   
3. *
   & k- \+ t0 F7 E" L# V! y
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   
5. * её в соответствии с условиями GNU General Public License, опубликованной
   
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   
7. *
   ; I/ M; u" W# n. d, K! x9 \
8. * Эта программа распространяется в надежде, что она будет полезной,
   - y& x; `7 |, }2 s) d$ V1 A
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    
11. * См. GNU General Public License для получения более подробной информации.
    7 M1 Z5 Z) e' U2 d1 U) g0 p
12. *
    5 T) w' A- F( `! O) v- c
13. * Вы должны были получить копию GNU General Public License
    
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    - F8 U/ ~/ B7 N3 ^; v
15. */

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

Это стандартный блок лицензии, который описывает, что этот код является открытым исходным кодом, распространяемым по лицензии GPLv3.
! `- p3 a' y4 u: F9 R& C( x

2. Импортируемые библиотеки
1 D8 P- A0 c0 A* t- t- S$ J: Y

1. package org.l2jmobius.gameserver.instancemanager;
   
2. 
   $ B# Z" D4 k8 ?' C& K3 O4 E8 m, l( I
3. import java.util.Map;
   , ~* K: {! T/ L+ E: p$ S
4. import java.util.concurrent.ConcurrentHashMap;
   - T: x1 Z+ [; b  N4 e2 o
5. import java.util.logging.Level;
   
6. import java.util.logging.Logger;
   5 T7 g: X7 l7 R# ~# a% R$ H
7. 
   * P. }+ o' a7 \% z
8. import org.l2jmobius.Config;
   ; ]8 m1 o% @1 K% T7 M9 U) @
9. import org.l2jmobius.commons.util.CommonUtil;
   4 I% v, P2 a9 V/ [4 ~0 F' m
10. import org.l2jmobius.gameserver.model.quest.Quest;
    
11. import org.l2jmobius.gameserver.scripting.ScriptEngineManager;

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

java.util.Map — интерфейс для работы с коллекциями, которые сопоставляют ключи со значениями.java.util.concurrent.ConcurrentHashMap — потокобезопасная реализация карты для использования в многопоточных приложениях.java.util.logging.Logger — класс для логирования информации (вывод сообщений в консоль или лог-файлы).org.l2jmobius.Config — класс конфигурации сервера.org.l2jmobius.commons.util.CommonUtil — утилиты, которые могут использоваться в различных частях программы.org.l2jmobius.gameserver.model.quest.Quest — базовый класс квеста, представляющий игровой квест.org.l2jmobius.gameserver.scripting.ScriptEngineManager — менеджер для работы с игровыми скриптами.
* n/ T2 \6 ?7 q1 w" A. e
3. Описание класса QuestManager
8 S" C) m, c+ X6 E- ~0 n5 P# t

1. /**
   9 s3 z& O& |& P3 L" J& v" p
2. * Менеджер квестов и скриптов.
   
3. * Автор: Zoey76
   
4. */
   
5. public class QuestManager
   
6. {
   2 r- C1 ~% m% e. l0 W3 F
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   
8.    
   8 L+ e# G; Y" W+ e- t' J9 T
9.     /** Карта, содержащая все квесты. */
   
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    
11.     /** Карта, содержащая все скрипты. */
    ) a9 y/ Q  r8 I" ?1 o$ N
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    
13.    
    
14.     protected QuestManager()
    
15.     {
    
16.     }
    " z7 C  k  y8 j+ M9 ], q
17. }

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

4. Методы
Метод reload(String questFolder)
# m8 q/ ^" x* |. s4 `4 j7 u

1. public boolean reload(String questFolder)
   1 F! ^" U6 N' r9 j+ m! C5 X
2. {
   
3.     final Quest q = getQuest(questFolder);
   
4.     if (q == null)
   
5.     {
   
6.         return false;
   
7.     }
   
8.     return q.reload();
   3 @: \( n: ?& b% G4 t
9. }

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

Метод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
  t- }4 d2 I+ p- sМетод reload(int questId)
6 l+ Z( [3 V+ b9 o' j2 Q) m

1. /**
   
2. * Перезагружает квест по ID.
   ; a% b# ~5 L: a
3. * @param questId ID квеста для перезагрузки
   ; `2 U! |. X6 }7 J% {; s& {
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   
5. */
   
6. public boolean reload(int questId)
   & w0 p- |1 _' ]7 z, P& r( x
7. {
   
8.     final Quest q = getQuest(questId);
   
9.     if (q == null)
   , O, @, \1 a: {- k
10.     {
    
11.         return false;
    ! w/ n# H# y( n) t+ j" @8 l4 H! ?
12.     }
    ! ]6 @' p% x2 X( B
13.     return q.reload();
    
14. }

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

• Аналогично предыдущему методу, но перезагружает квест по его ID.
  

# b& q" E% Y: N2 ?, NМетод reloadAllScripts()

1. /**
   
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   8 p) o6 r4 F6 q5 S. Q
3. */
   
4. public void reloadAllScripts()
   . a# y4 N8 A3 h1 T
5. {
   
6.     unloadAllScripts();
   & I7 s) L3 G9 g/ l1 Y7 _
7.    
   6 m0 d- ^+ C6 F5 i5 A6 j' Y4 K
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   
9.     try
   . J* T! b+ i% ^; }
10.     {
    5 X, R+ ], E; o
11.         ScriptEngineManager.getInstance().executeScriptList();
    + h0 ]. C$ c' ?( [- D* F4 j# b7 h
12.     }
    
13.     catch (Exception e)
    ( I3 n9 |* R' H' l6 [& f( V
14.     {
    
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    8 O& K  K/ m- ?/ j0 j- P( Y
16.     }
    
17.    
    , p( A1 X- ^; C- k9 H0 [# \
18.     getInstance().report();
    
19. }

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

Метод unloadAllScripts()
' f* P, A; L' V' \+ f

1. /**
   
2. * Выгружает все квесты и скрипты.
   $ |/ i/ y* p% ?
3. */
   
4. public void unloadAllScripts()
   + u  w% c& |3 G5 H7 o$ c
5. {
   
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   8 M% w( ]" D1 D: K  |( k3 w) T3 ^
7.    
   
8.     // Выгрузка квестов.
   
9.     for (Quest quest : _quests.values())
   . W; |9 ^" a; i
10.     {
    
11.         if (quest != null)
    
12.         {
    " k$ @1 \- w, O1 J9 B( n, B2 I
13.             quest.unload(false);
    
14.         }
    
15.     }
    
16.     _quests.clear();
    0 Y, H& d( }! Z5 x& _# E: y
17.     // Выгрузка скриптов.
    
18.     for (Quest script : _scripts.values())
    
19.     {
    8 S1 T5 ~' F/ _& x/ H1 f9 B
20.         if (script != null)
    - J6 A* G4 w  n4 S9 A# Z
21.         {
    
22.             script.unload(false);
    
23.         }
    * |- y/ p- Z  ]4 |- p: _/ \
24.     }
    
25.     _scripts.clear();
    " x8 n$ M" Y1 M: m  C' s0 R
26. }

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

• Этот метод проходит по всем квестам и скриптам и вызывает метод unload() для каждого, а затем очищает коллекции _quests и _scripts.
  

, Q, B, g( w* w1 O& V* w! K* L) e4 oМетод report()

) M; b! J8 [/ Q. k1 R

1. /**
   
2. * Логирует количество загруженных квестов и скриптов.
   
3. */
   
4. public void report()
   
5. {
   ' Y& G8 m) I) y) I
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   & l3 P& v& T6 X: e8 M; m  D
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   ! s, A3 F+ U% [. r
8. }

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

• Этот метод просто выводит в лог информацию о количестве загруженных квестов и скриптов.
  

8 ]1 A( m4 g2 ]# h+ R$ w: EМетод getQuest(String name)
" ^6 H" I6 @" [& `9 p. l
. ^) r# S6 E  Y6 k8 ^0 M# ]' y

1. /**
   ( A# M  e1 d$ x% A  i" N
2. * Получает квест по имени.
   ( v. K, O2 z) b6 c; `
3. * @param name имя квеста
   
4. * @return квест
   3 \$ o4 s2 r+ Q
5. */
   1 S* v' i. X: B/ D5 H
6. public Quest getQuest(String name)
   
7. {
   + w& ]( ~, _" @9 u
8.     if (_quests.containsKey(name))
   * ~2 W! ]# B! X: l  E* d
9.     {
   . c# ~: j1 c1 r) a8 I
10.         return _quests.get(name);
    
11.     }
    1 e- b3 R. w3 ~" Q  m
12.     return _scripts.get(name);
    
13. }

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

• Этот метод возвращает квест по его имени, если он зарегистрирован в системе.
  

) s% a4 p5 M2 \7 w! D5 _" yМетод getQuest(int questId)
9 e7 i$ P1 V. t4 e
8 s1 `$ z' d6 @: J2 e! X

1. /**
   * m+ T# d: S1 Q5 P) }
2. * Получает квест по ID.
   
3. * @param questId ID квеста
   
4. * @return квест, если найден, {@code null} в противном случае
   8 Z8 l$ S; ~/ B3 }8 m# f
5. */
   2 H4 D. A- k4 Q4 P
6. public Quest getQuest(int questId)
   7 r2 C  e0 `0 y( `( j
7. {
   
8.     for (Quest q : _quests.values())
   / A. k, m& [4 _" P4 |
9.     {
   
10.         if (q.getId() == questId)
    1 _8 Z( r! ?  \3 T6 Y  z; z0 G6 k9 m* R
11.         {
    
12.             return q;
    & {$ ?6 A- m1 \8 m
13.         }
    
14.     }
    
15.     return null;
    - k8 u, K' R$ m$ _
16. }

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

• Этот метод ищет квест по его уникальному идентификатору.
  

1 R" k% h* S  p! \Метод addQuest(Quest quest)

1. /**
   2 [: I& K4 ?* p  S  a
2. * Добавляет новый квест.
   
3. * @param quest квест для добавления
   
4. */
   ( F# p" c8 Y; |/ z' r
5. public void addQuest(Quest quest)
   7 e, o; A3 y- q, d" L7 c, ~) R) a
6. {
   + l7 V* y$ m; _) e  c
7.     if (quest == null)
   0 U- A7 P6 ^6 Z: ^0 T7 ?4 A& F
8.     {
   + E; c( n6 i+ ?2 }8 g
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   / d( b- B5 J( t  z' a$ V' f4 y$ N
10.     }
    
11.    
    , i; O; ~. @5 U& [$ ^6 a( `. ~& y( r
12.     final Quest old = _quests.put(quest.getName(), quest);
    
13.     if (old != null)
    
14.     {
    
15.         old.unload();
    ; U2 A% b& b* z- F% D3 `" e! U
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    6 v  E. O* {+ X. q
17.     }
    
18.    
    
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    . r) _3 G+ ^) i% N* H* Z% M$ |
20.     {
    , B2 ]4 u% O# i/ S! i
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    $ k' w+ W$ R2 t9 ?6 w8 G
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    
23.     }
    
24. }
    8 @9 u5 Y- Y5 o, M8 H9 M
25. ``

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

Логика работыQuestManager управляет процессом загрузки, перезагрузки и выгрузки квестов и скриптов на сервере. Он поддерживает кэширование квестов и скриптов в картах _quests и _scripts, а также обеспечивает возможность их перезагрузки без перезапуска сервера.
! u% ^# v4 F% S) e$ k- yЗаключениеQuestManager.java — это ключевой элемент в управлении системой квестов и скриптов. Основная его функция — это управление квестами и скриптами, их загрузка, перезагрузка, выгрузка и хранение на сервере.

/ ^3 Z0 e+ Z1 A* \: t$ l

& N" S/ h) r4 l2 [0 j