Посібник з інсталяції
Вступ
Про нас
L2J Server — це офіційний проєкт із відкритим вихідним кодом, розроблений на Java, який прагне надати ігровий сервер для Lineage II.
Ми існуємо вже давно, і наша місія — надати досвід, максимально близький до офіційної гри.
Наше бачення полягає в тому, щоб мати сервер, який може запускати будь-яку версію гри на основі конфігурацій і використовувати хмарну архітектуру мікросервісів.
Про продукт
L2J Server поділяється на два компоненти: L2j Game Server та L2j Login Server. У той же час L2j Game Server поділяє ться на Core та Datapack. Core — це Java-код, який визначає ігрову механіку, збереження та механізми зв'язку, а Datapack складається з усіх файлів, пов'язаних з ігровим процесом, таких як діалоги, сценарії квестів, ШІ тощо.
Встановлення сервера вимагає попереднього встановлення додаткового програмного забезпечення (Java, база даних, Git тощо), потім отримання вихідного коду, його компіляції, встановлення бази даних, розгортання скомпільованих файлів сервера, мінімального налаштування та, нарешті, запуску сервера та тестування.
Необхідне програмне забезпечення
- Оновлена ОС
- Java
- MariaDB (або MySQL)
- Git
Оновлення ОС
- Windows
- Centos Stream 10
- Debian 13
- Ubuntu 22
- macOS Sequoia 15
wuauclt /detectnow /updatenow
sudo -i
dnf update
sudo -i
apt update
sudo -i
apt update
brew update && brew upgrade
Отримання та встановлення Java
L2J побудований з використанням Java, тому для збирання сервера вам також знадобиться Java JDK.
- Windows
- Centos Stream 10
- Debian 13
- Ubuntu 22
- macOS Sequoia 15
winget install EclipseAdoptium.Temurin.25.JDK
Якщо ви вже використовували winget, ви можете оновити версію Java за допомогою:
winget upgrade EclipseAdoptium.Temurin.25.JDK
Перевірте версію Java:
java --version
cat <<EOF > /etc/yum.repos.d/adoptium.repo
[Adoptium]
name=Adoptium
baseurl=https://packages.adoptium.net/artifactory/rpm/${DISTRIBUTION_NAME:-$(. /etc/os-release; echo $ID)}/\$releasever/\$basearch
enabled=1
gpgcheck=1
gpgkey=https://packages.adoptium.net/artifactory/api/gpg/key/public
EOF
sudo -i
dnf install -y temurin-25-jdk
Перевірте версію Java:
java --version
apt install -y wget apt-transport-https gpg
wget -qO - https://packages.adoptium.net/artifactory/api/gpg/key/public | gpg --dearmor | tee /etc/apt/trusted.gpg.d/adoptium.gpg > /dev/null
echo "deb https://packages.adoptium.net/artifactory/deb $(awk -F= '/^VERSION_CODENAME/{print$2}' /etc/os-release) main" | tee /etc/apt/sources.list.d/adoptium.list
apt update
apt install -y temurin-25-jdk
Перевірте версію Java:
java --version
apt install -y wget apt-transport-https gpg
wget -qO - https://packages.adoptium.net/artifactory/api/gpg/key/public | gpg --dearmor | tee /etc/apt/trusted.gpg.d/adoptium.gpg > /dev/null
echo "deb https://packages.adoptium.net/artifactory/deb $(awk -F= '/^VERSION_CODENAME/{print$2}' /etc/os-release) main" | tee /etc/apt/sources.list.d/adoptium.list
apt install -y temurin-25-jdk
Перевірте версію Java:
java --version
brew install --cask temurin@25
Перевірте версію Java:
java --version
Ми рекомендуємо оновити змінну оточення JAVA_HOME.
Наскільки це можливо, L2J буде сумісним з останньою версією Java LTS (Long-Term-Support), ви можете перевірити дорожню карту Java SE тут.
Отримання та встановлення Git
L2J використовує Git як систему контролю версій на BitBucket, використовуйте його для отримання останніх версій.
- Windows
- Centos Stream 10
- Debian 13
- Ubuntu 22
- macOS Sequoia 15
winget install -e --id Git.Git
dnf install -y git
apt install -y git
apt install -y git
brew install git
Проверьте версию Git:
git --version
Отримання та встановлення сервера бази даних
Завантажте та встановіть сервер бази даних і створіть спеціального користувача.
- Windows
- Centos Stream 10
- Debian 13
- Ubuntu 22
- macOS Sequoia 15
winget install -e --id MariaDB.Server
dnf install -y mariadb-server
systemctl start mariadb
mysql_secure_installation
apt install -y mariadb-server
mysql_secure_installation
apt install -y mariadb-server
mysql_secure_installation
brew install mariadb
brew services start mariadb
mariadb-secure-installation
Виконайте наступні SQL-інструкції, щоб створити спеціального користувача бази даних L2J:
mariadb -u root -p
CREATE OR REPLACE USER 'l2j'@'%' IDENTIFIED BY 'l2jserver2019';
GRANT ALL PRIVILEGES ON *.* TO 'l2j'@'%' IDENTIFIED BY 'l2jserver2019';
FLUSH PRIVILEGES;
Ми рекомендуємо змінити пароль бази даних за замовчуванням.
Отримання вихідного коду
Наші офіційні репозиторії перераховані нижче.
- Windows
- Linux/macOS
mkdir C:\opt\l2j\git
cd C:\opt\l2j\git
mkdir -p /opt/l2j/git
cd /opt/l2j/git
git clone -b master https://bitbucket.org/l2jserver/l2j-server-login.git
git clone -b develop https://bitbucket.org/l2jserver/l2j-server-game.git
git clone -b develop https://bitbucket.org/l2jserver/l2j-server-datapack.git
Збирання сервера
Ми використовуємо Maven для збирання файлів сервера. Виконайте наступні команди:
cd /opt/l2j/git/l2j-server-login && ./mvnw install
cd /opt/l2j/git/l2j-server-game && ./mvnw install
cd /opt/l2j/git/l2j-server-datapack && ./mvnw install
Розгортання сервера
Розгортання Login Server
mkdir -p /opt/l2j/server/login
unzip /opt/l2j/git/l2j-server-login/target/l2j-server-login-*.zip -d /opt/l2j/server/login
Розгортання Game Server
mkdir -p /opt/l2j/server/game
unzip /opt/l2j/git/l2j-server-game/target/l2j-server-game-*.zip -d /opt/l2j/server/game
unzip /opt/l2j/git/l2j-server-datapack/target/l2j-server-datapack-*.zip -d /opt/l2j/server/game
Встановлення бази даних
Завантажте L2J CLI та виконайте встановлення:
./l2jcli.sh
db install -sql /opt/l2j/server/login/sql -u l2j -p l2jserver2019 -m FULL -t LOGIN -c -mods
db install -sql /opt/l2j/server/game/sql -u l2j -p l2jserver2019 -m FULL -t GAME -c -mods
Запуск серверів
cd /opt/l2j/server/login && ./startLoginServer.sh
cd /opt/l2j/server/game && ./startGameServer.sh
Підключення до сервера
Відредагуйте файл hosts або використовуйте спеціальний .bat файл з параметром IP=127.0.0.1.