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

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

. j' e; P4 X; h3 FРазбор файла QuestManager.java
% k9 B; U4 u5 s9 ]
Этот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
2 ~( l$ ]6 b* S& k9 _* KОсновные элементы

• Лицензия
  
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    ! i: T( N* i1 Q+ }: l) c
• Импорты
  $ T4 X3 i2 i" s& d: J9 l0 M

QuestManager.java — управление квестами и скриптами.
/ @  M9 p2 s, j) Q9 I2 _' o9 DПуть: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\

0 k; ~7 k0 h6 ^" j  a: ?8 K
5 s' c- R& F* m; L# MДавай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
$ J- `" P+ W5 b1. Лицензионное соглашение
: t2 V/ w6 Q; U  Y5 s, Y

1. /*
   
2. * Этот файл является частью проекта L2J Mobius.
   ; B. x' W. z' L( g9 S8 ^' t' Q) k3 r
3. *
   ) L0 g, [9 v8 ^$ G( B% N- {
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   ' f3 O" P4 s* {. n  }3 o3 J
5. * её в соответствии с условиями GNU General Public License, опубликованной
   $ H) b6 Q$ U) g1 s
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   
7. *
   
8. * Эта программа распространяется в надежде, что она будет полезной,
   
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   * l% g. A# ~% u1 X# I, Z& H
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    0 c) w0 ^) k! M% _) _2 `: c
11. * См. GNU General Public License для получения более подробной информации.
    ; B4 K. |# V+ A* E5 S6 {6 g
12. *
    & O  E3 e, Z  c0 V" ~5 _$ O5 M
13. * Вы должны были получить копию GNU General Public License
    
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    , f7 s3 h( s# a5 r
15. */

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

Это стандартный блок лицензии, который описывает, что этот код является открытым исходным кодом, распространяемым по лицензии GPLv3.

) n! H/ I+ W5 f: ^2 a: x
+ t9 p- N: @/ _9 w2. Импортируемые библиотеки
* M# G1 R3 m0 j) Q* B0 y# V" d2 f2 P
2 S2 j4 L. i' u4 E* H  N7 Y

1. package org.l2jmobius.gameserver.instancemanager;
   
2. 
   3 ?* q8 ?( \6 j  r) Q$ }
3. import java.util.Map;
   
4. import java.util.concurrent.ConcurrentHashMap;
   
5. import java.util.logging.Level;
   1 e/ \& M; f5 ^0 l" B3 y1 S
6. import java.util.logging.Logger;
   
7. 
   
8. import org.l2jmobius.Config;
   4 |! r: V  G. U# |- o6 i9 W
9. import org.l2jmobius.commons.util.CommonUtil;
   * _3 `: S* ?& O: K6 W+ b
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 — менеджер для работы с игровыми скриптами.
% X0 I: x) R: H+ v5 l/ p9 h
: F1 O$ I1 B2 |( m& _' H# P* m3. Описание класса QuestManager
8 h- N3 I8 `* w7 t: c* S

1. /**
   9 z6 G% E. o* ^& H# K
2. * Менеджер квестов и скриптов.
   5 _9 W8 J3 a8 \4 Y0 h
3. * Автор: Zoey76
   ) U6 z9 Z" H8 v% N: n  K
4. */
   7 K0 E, e* z: }
5. public class QuestManager
   
6. {
   
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   
8.    
   
9.     /** Карта, содержащая все квесты. */
   
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    
11.     /** Карта, содержащая все скрипты. */
    
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    
13.    
    
14.     protected QuestManager()
    
15.     {
    ! P* }* P0 Q* e/ l
16.     }
    0 _" b: Z$ Z6 L
17. }

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

4. Методы
Метод reload(String questFolder)
' P; V9 }: J; w4 j

1. public boolean reload(String questFolder)
   
2. {
   8 l5 Y& _' o: E, s
3.     final Quest q = getQuest(questFolder);
   
4.     if (q == null)
   + m2 J: S; v. |% {
5.     {
   & E5 p. H2 {. d$ z6 L
6.         return false;
   0 M- b) \* _# \3 k
7.     }
   ) i9 b# @. Q! m/ w
8.     return q.reload();
   
9. }

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

/ B" ?7 c7 V. G! l* ~" `6 ~
# U9 F0 G  d) N$ [Метод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
# N, \3 q  i) e1 ^. YМетод reload(int questId)
! O# H' T$ t5 C8 K+ w
8 }  }7 ]" T9 e7 ~, |

1. /**
   
2. * Перезагружает квест по ID.
   
3. * @param questId ID квеста для перезагрузки
   
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   ( U% m1 e& U% e2 y+ U7 Z- e9 M, P0 |
5. */
   ! i" P2 c& g2 O; Z! M
6. public boolean reload(int questId)
   
7. {
   
8.     final Quest q = getQuest(questId);
   4 f$ b. V7 @" l1 D7 V
9.     if (q == null)
   # Y. `1 a) C. c- `  h+ n
10.     {
    
11.         return false;
    
12.     }
    
13.     return q.reload();
    
14. }

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

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

Метод reloadAllScripts()
3 c; o: q1 `( s

1. /**
   
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   6 _8 V+ n; N% ^) S+ V/ r. K; l; A% J
3. */
   
4. public void reloadAllScripts()
   
5. {
     d1 a8 W, D" r( I* j/ w  p% K" ]
6.     unloadAllScripts();
   
7.    
   
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   + W$ t& v3 w9 o0 D0 E1 a3 W
9.     try
   
10.     {
    ! N7 b6 ~) a, }& T  J2 B/ m# R
11.         ScriptEngineManager.getInstance().executeScriptList();
    
12.     }
    ( Y) `# h. ~- n  q: h0 B: o. n  d
13.     catch (Exception e)
    # x  Q  ~2 d* [0 e
14.     {
    # F  i# H% }4 G  v
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    / \- m, q: n5 G. m* m8 E  `
16.     }
    
17.    
    
18.     getInstance().report();
    
19. }

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

Метод unloadAllScripts()

1. /**
   
2. * Выгружает все квесты и скрипты.
   5 ]7 k# @: h5 g8 {, r% T
3. */
   
4. public void unloadAllScripts()
   
5. {
   
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   
7.    
   9 k$ a9 T# \+ A% m0 X
8.     // Выгрузка квестов.
   ; B! [' t; j& D6 e; c
9.     for (Quest quest : _quests.values())
   
10.     {
    # D. u9 c- e' d/ e
11.         if (quest != null)
    5 D  S6 F) }  h4 K( b- Y& X7 x, i' J
12.         {
    ( U. e+ A7 a7 Z/ c# o6 l
13.             quest.unload(false);
    ' u2 J, ?" ~* |- H; S
14.         }
    
15.     }
    
16.     _quests.clear();
    9 W6 Z( Q$ X- \: ?. P0 {6 ^/ p4 {
17.     // Выгрузка скриптов.
    
18.     for (Quest script : _scripts.values())
    & U9 Q" f2 w( `* ]$ J0 L2 p
19.     {
    
20.         if (script != null)
    : d* f: k/ J; E; Z5 F
21.         {
    
22.             script.unload(false);
    / ?. d' ^. h* o. j* A6 S/ n& [
23.         }
    
24.     }
    ) x* f. \6 b1 W7 U& c
25.     _scripts.clear();
    
26. }

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

• Этот метод проходит по всем квестам и скриптам и вызывает метод unload() для каждого, а затем очищает коллекции _quests и _scripts.
  ( n) G* A1 m6 i% i% [

9 D( j0 o1 h" s9 S) [: t# aМетод report()
- J7 X1 [" w. f' B, S" C* r# m! H# T

1. /**
   % V- ^8 x3 y; p7 h
2. * Логирует количество загруженных квестов и скриптов.
   
3. */
   
4. public void report()
   
5. {
   
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   , `7 ]( ]7 r3 r  L: s9 I5 l" J
8. }

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

• Этот метод просто выводит в лог информацию о количестве загруженных квестов и скриптов.
  1 m- c4 N0 l6 a, }! B

* @& }: w- C9 D. p5 S) PМетод getQuest(String name)
/ R! }  o/ k& P' B# n- o& H

1. /**
   4 J+ w# L5 K6 A4 i, @( y) r
2. * Получает квест по имени.
   
3. * @param name имя квеста
   , a$ j8 x& Y+ c6 R" U. E
4. * @return квест
   
5. */
   7 O. h( q, j  k. _  U+ s0 c" ~8 S
6. public Quest getQuest(String name)
   + D- O# e/ E$ b# ~
7. {
   
8.     if (_quests.containsKey(name))
   / _1 O/ q" _: t  [9 U
9.     {
   
10.         return _quests.get(name);
    
11.     }
    # u5 q/ m/ Z/ C9 y$ o1 A
12.     return _scripts.get(name);
    # v& M; ^7 k0 `$ \  A. f
13. }

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

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

2 s3 I8 g3 P$ vМетод getQuest(int questId)
0 d% F( G) n! Q9 o" i  G

1. /**
     h/ @# c' n; a% Y; [2 p% |
2. * Получает квест по ID.
   
3. * @param questId ID квеста
     U+ Z- e2 k  r, |! t
4. * @return квест, если найден, {@code null} в противном случае
   2 Z" u( V3 o* n' L& [/ F
5. */
   
6. public Quest getQuest(int questId)
   
7. {
   
8.     for (Quest q : _quests.values())
   
9.     {
   & O9 @  A5 \- c+ \% v( N0 o) ~
10.         if (q.getId() == questId)
    
11.         {
    
12.             return q;
    $ s; T  x2 P- m5 y& v
13.         }
    
14.     }
    
15.     return null;
    ; b/ K) e6 k# G; `% b5 P5 I/ J% v/ T
16. }

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

• Этот метод ищет квест по его уникальному идентификатору.
  2 n, h0 ~- \0 Y* p; f7 w

Метод addQuest(Quest quest)

1. /**
   9 M/ T6 Q& W* P. i& C1 I8 @* @3 i* W
2. * Добавляет новый квест.
   ; X$ a8 j6 f- r2 s- P3 e% @
3. * @param quest квест для добавления
   5 X8 ~9 s' \8 E3 w  @6 _. y
4. */
   
5. public void addQuest(Quest quest)
   
6. {
   $ L* H# a4 a6 h( l1 o( o4 Y( ?
7.     if (quest == null)
   
8.     {
   
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   9 g- V* A' k5 B8 {, \! G) I4 l
10.     }
    $ U) n1 j; Y+ U1 J7 M9 v
11.    
    ( F+ g$ B8 @* F" B! X
12.     final Quest old = _quests.put(quest.getName(), quest);
    
13.     if (old != null)
    / L# Z* |+ ^, e* K2 e3 `: O/ }1 W
14.     {
    7 p; D! x# ^2 V* ^
15.         old.unload();
    ' `7 t: t( B/ ]8 H6 X8 T
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    
17.     }
    ( {8 _! N. C/ w- l% q+ O+ C! m
18.    
    
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    
20.     {
    
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    % q/ T1 O2 [9 p4 `+ q8 _  y0 V
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    ; m" ^; F: u" |( Z1 k2 M
23.     }
    4 j7 e, y8 B9 R5 \+ M4 X5 A) l% ]
24. }
      E: K) H5 H" \8 ?: \
25. ``

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

Логика работыQuestManager управляет процессом загрузки, перезагрузки и выгрузки квестов и скриптов на сервере. Он поддерживает кэширование квестов и скриптов в картах _quests и _scripts, а также обеспечивает возможность их перезагрузки без перезапуска сервера.
ЗаключениеQuestManager.java — это ключевой элемент в управлении системой квестов и скриптов. Основная его функция — это управление квестами и скриптами, их загрузка, перезагрузка, выгрузка и хранение на сервере.
' t3 w& u8 `8 }, m
% @' g# P  R' O  e

" Z* J9 J$ @+ I