Java для серверостроителей (L2J) или Учебник Java простыми словами

Java для серверостроителей (L2J) или Учебник Java простыми словами

Подразделы/темы:

• 🔑 Ключевые слова Java (с переводом и объяснением)
• 📦 Структура проекта L2J (пакеты, классы, файлы)
• ⚙️ Работа с конфигами (Config.java, ini-файлы)
• 🧩 Объекты и методы на примерах из L2J
• 🔄 Циклы и условия в квестах
• 🛠 Исключения (try/catch) и обработка ошибок
• ✍️ Примеры кода с переводом (AstraConfig, AbstractAI и т.д.)
  
  

$ Q( t7 f, n! e% y
📌 Ключевые слова Java (с переводом и объяснением)

% E: {5 e8 i( p- Q
& L5 f4 Z0 |/ g. c' @0 |

; S8 [% t7 ?! V% _% J) `' a
  y9 R/ P+ w& o8 v& V9 }





+ d' J) a" [3 i7 l# z  h
4 f; J" V4 |$ R. W


. \4 J9 D$ |& T1 _
' J5 d2 `" `. g- m  K
: D: n" `" O+ [  _7 u( Z/ }3 b


( P- T2 x$ O: H, b" K) q
  Y6 r5 v( e9 j
& K9 `! h* D; U3 M



5 n" N+ e! V7 {' V9 R. }1 `
4 U0 _$ `$ |  X4 B0 }3 f
0 G* U3 \9 w! R; y

Ключевое слово	Перевод	Объяснение
class	класс	Основной строительный блок программы. Описывает объект и его поведение.
interface	интерфейс	Набор правил (методов), которые класс обязан реализовать.
extends	наследует	Класс получает свойства и методы от родительского класса.
implements	реализует	Класс берёт на себя обязательство реализовать интерфейс.
public	публичный	Доступно всем классам и пакетам.
private	приватный	Доступно только внутри текущего класса.
protected	защищённый	Доступно в классе и у его наследников.
static	статический	Общее свойство/метод для всех объектов класса.
final	финальный	Нельзя изменять (константа, метод нельзя переопределить, класс нельзя наследовать).
void	пусто	Метод ничего не возвращает.
return	вернуть	Возврат значения из метода.
if	если	Условие.
else	иначе	Ветка, если условие не выполнено.
switch	выбор	Проверка на несколько вариантов (как меню выбора).
case	вариант	Один из вариантов для switch.
for	цикл	Повторение действий с счётчиком.
while	пока	Цикл, выполняется пока условие истинно.
do	сделать	Цикл, выполняется хотя бы один раз, потом проверка условия.
try	попробовать	Блок кода, где может произойти ошибка.
catch	поймать	Обработка ошибки из блока try.
finally	наконец	Выполняется всегда, даже если ошибка произошла.
throw	бросить	Создать и выбросить ошибку.
throws	может бросить	Объявление, что метод может выбросить ошибку.
import	импорт	Подключение внешнего пакета/класса.
package	пакет	Группа классов (как папка в проекте).
this	этот	Ссылка на текущий объект класса.
super	родитель	Ссылка на родительский класс.
null	ничего	Отсутствие значения (пустая ссылка).
true/false	истина/ложь	Булевые значения (логика).
int	целое число	Тип данных для целых чисел (1, 2, 3...).
double	вещественное число	Тип данных для дробных чисел (1.5, 2.75...).
boolean	логический	Тип данных: true/false.
char	символ	Одиночная буква или знак.
String	строка	Набор символов (текст).
enum	перечисление	Набор фиксированных констант.

📌 Примеры кода Java с переводом на русский

Пример 1. Объявление класса и переменной

1. 
   
2. public class Player {
   
3. private int health = 100;
   
4. }
   1 i' n9 E" a: y( ]# K: v( }

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

🔎 Разбор:
  r7 a% p5 m' x: B% G: `
public class Player — создаём класс с именем Player, доступный везде.
5 V: ]; i& |7 W0 L; S4 a: F
8 W. ?' E% Q& w7 Dprivate int health = 100; — внутри класса есть переменная (поле) health типа число (int), приватная, начальное значение = 100.

Пример 2. Метод без возвращаемого значения

1. 
   ( R% f5 w' ]; p, d. t3 D
2. public void sayHello() {
   ) k" f  J, [4 O
3. System.out.println("Hello, adventurer!");
   ' `6 I3 v3 |! }$ G: i" F
4. }
   ) T6 k# H2 V: Y* `8 B

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

' w1 n* v8 D" k4 v" D🔎 Разбор:
) a! s4 B% |% ^% C2 f7 F- T
- g4 u' T. N( Upublic — доступен везде.

* u1 y8 k; k& f7 w# A7 e/ Yvoid — метод ничего не возвращает.
  q! h' i/ L: Z
# E- q3 F3 K: E% A* f( _sayHello() — имя метода.

9 }( r, ^8 v9 R2 d: OSystem.out.println — вывести текст в консоль.
1 s. L9 a0 z/ V  E
, K4 r2 }( |" |9 H* N$ {, OПример 3. Метод с возвращаемым значением

1. 
   
2. public int getHealth() {
   
3. return health;
   $ m2 j( [; _7 N+ e# m
4. }
   4 Y5 f5 I; ^' U. C! r6 d

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

# ~$ H3 j, [" S4 ?! G# g% G) u+ B$ t
🔎 Разбор:

- G. A; p7 E- K, k& Hint — метод возвращает число.

$ M/ I3 g0 v% S( T" creturn health; — вернуть значение переменной health.

9 n5 x- q/ |8 xПример 4. Условие if/else
$ E6 b: Y# P% c" M

1. 
   
2. if (health <= 0) {
   ) H0 f8 |- H: s0 `5 E# @, U
3. System.out.println("Player is dead");
   
4. } else {
   
5. System.out.println("Player is alive");
   
6. }
   

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

0 g- ?; j* y+ x) T: H2 }8 R+ _; b; z
🔎 Разбор:
: e& Z  k) |$ f8 M, l# n# r$ o
, ~0 J. V/ n8 D; Lif (health <= 0) — если здоровье меньше или равно 0.
1 |% F: q" i9 b1 B3 m4 }8 X- B
8 Q6 P0 k4 K' `( a0 Z4 P& oelse — иначе (во всех других случаях).

1 l7 H! Q5 O* {) Z# u5 |Пример 5. Цикл for

1. 
   
2. for (int i = 0; i < 5; i++) {
   
3. System.out.println("Attack " + i);
   
4. }
   " y5 e) a& i* R- \1 U, o! J

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

🔎 Разбор:
* b. ^$ y! E3 W8 k4 e
int i = 0 — начинаем счётчик с 0.
6 u( Y* F! G4 D1 ~- _
$ A& p) x% J8 _' e. ti < 5 — повторяем, пока i меньше 5.
" s& X0 _# [* @4 U" A  W! L
4 ~2 S3 p3 y3 s7 ~6 n' L/ G3 Ji++ — каждый раз увеличиваем i на 1.
/ m3 J  h5 U. X
9 l4 O- X% x! gВыведет: Attack 0, Attack 1, …, Attack 4.
# n$ O! S+ ?, P7 J
Пример 6. try/catch — обработка ошибок
6 a5 {' s* e( y2 F* V) z

1. 
   
2. try {
   
3. int x = 10 / 0;
   5 w. R4 s. g: q# m5 r
4. } catch (Exception e) {
   
5. System.out.println("Ошибка: " + e.getMessage());
   
6. }
   2 ~' v5 g1 i6 M. P; l* ?

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

2 r+ i, a0 p$ Y, j🔎 Разбор:

try — пробуем выполнить код.

+ d# ?$ z( W2 g' _# {& ]10 / 0 — деление на 0 вызовет ошибку.

# ]7 r, I# _8 @/ rcatch (Exception e) — поймали ошибку.

7 t7 k3 {# u7 H" d$ ?System.out.println("Ошибка: " + e.getMessage()); — выводим сообщение.

9 s/ @6 z* e8 ~4 oПример 7. Конструктор
8 x; @; O. \* P" K% N

1. 
   $ r% v" o: }( d1 K5 |7 Y
2. public class Player {
   
3. private String name;
   6 T; {5 Y  O& d( ~" I) o1 L1 X' ?
4. 
   + F) N+ k* _) c  I/ t$ @0 f
5. public Player(String name) {
   
6.     this.name = name;
   - `. I" G1 E$ l2 v7 ?
7. }
   
8. 
   ' k  g* ?& m/ @% }, i( u
9. 
   
10. }
    

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

🔎 Разбор:

public Player(String name) — конструктор (метод, который вызывается при создании объекта).

this.name = name; — присваиваем значение переданное при создании объекта.
6 I- W1 ^4 x, I1 O9 |; Q
4 |5 g, ~0 r/ _; j; oПример использования:
2 F( t/ e: a8 \6 n: X

1. 
   
2. Player p = new Player("Elmorion");
   - N& s- B" Y$ p+ f/ s! ?, x9 N- C

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

3 w7 O7 S1 u8 Z! D  J4 W7 o" H! o🔥 Это база, на которой держится 90% кода в L2J и ASTRA.

📌 Пример из L2J (Config.java) с разбором

3 z" ?. j: E/ S( k# X0 v4 G! f

1. 
   # F; y0 e- u* r
2. public static final String CUSTOM_ASTRA_CONFIG_FILE = "./config/Custom/Astra.ini";
   $ ?3 @! ^! b7 ]( _* L

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

6 E$ m6 @7 o0 E5 ?/ }; ]) e: V
🔎 Разбор:
3 d7 V, t% R' u# b+ Q/ w) ]- a" v4 V
public — переменная доступна везде.

8 y, h3 G1 A1 ustatic — принадлежит классу, а не объекту.

final — значение изменить нельзя (константа).

$ U* q0 Y/ V) F6 fString — тип данных «строка».
, w4 Q6 w5 E/ g/ H2 k" X1 B
5 U, d* ^6 h+ L7 ACUSTOM_ASTRA_CONFIG_FILE — имя переменной (принято писать константы ЗАГЛАВНЫМИ буквами).

- }8 ^' p  ^/ o* r, O"./config/Custom/Astra.ini" — путь к файлу (строка в кавычках).

& f9 J3 \% f7 P9 `+ W

1. 
   1 L5 H+ [5 Y3 V! i
2. public static void load()
   9 U2 E  z/ ]. T+ d8 H; `+ @4 k
3. {
   
4. File ini = new File(CUSTOM_ASTRA_CONFIG_FILE);
   # v$ P1 X, R+ }, w* x- J1 B
5. if (!ini.exists())
   $ A6 Y% p  H5 x  E. a- }' \
6. {
   , j0 k0 A* f4 a, |0 P* K3 e" \
7. System.out.println("[ASTRA] Astra.ini not found at: " + ini.getPath());
   
8. return;
   2 Z0 J) ^2 {& Z  q
9. }
     z5 O, U& b& ]8 ?
10. 
    
11. parseIni(ini);
    
12. 
    
13. 
    / ~/ \0 [$ r9 Q5 ?( a
14. }
    : j  N/ ]+ }4 m+ x7 d- N0 `( J1 ~" }

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

* b  @; s) y$ Q0 L0 @🔎 Разбор:

9 M7 ?) Y0 y) O2 d) J2 |5 T9 }. U8 J# Epublic static void load() — метод доступен везде, общий для класса, ничего не возвращает.
6 O5 j- i5 ]+ \# w0 Z, _5 P: l+ k
2 g6 p: o, e% o. }9 W' kFile ini = new File(...) — создаём объект File, указываем путь до файла.

, I% h3 W6 N3 G& T; q3 @if (!ini.exists()) — проверка: если файл не существует.

3 @* t! b: F4 ~, a% Q& ^System.out.println(...) — выводим сообщение в консоль.

- K. V. L$ R. Ureturn; — завершаем метод.
7 W9 Z' H" J. i! G' H, P
6 G7 y6 p7 M  b* ]: [) WparseIni(ini); — вызываем метод, который разберёт содержимое ini-файла.
7 Q9 W9 w- s5 h% [) j
. E/ {) s2 ?8 c5 \% @7 H, O💡 Что это значит для сервера?

- n7 y3 p, N& d7 [5 L- ?/ I# zЭтот код отвечает за то, чтобы сервер при старте загрузил твой файл настроек Astra.ini.
Если файла нет — он пишет в консоль сообщение и использует стандартные значения (дефолты).

🔥 Такой же принцип работает для всех ini-файлов в L2J (Rates.ini, Server.ini, NPC.ini). Отличие только в названии переменной и в пути к файлу.