メインコンテンツへスキップ

インストールガイド

はじめに​

私たちについて​

L2J Serverは、Javaで開発された公式のオープンソースプロジェクトであり、Lineage IIのゲームサーバーの提供を目指しています。

私たちは長年活動を続けており、公式ゲームにできるだけ近い体験を提供することを使命としています。

私たちのビジョンは、クラウドネイティブなマイクロサービスアーキテクチャを採用し、設定次第でゲームのあらゆるバージョンを実行できるサーバーを実現することです。

製品について​

L2J Serverは、L2j Game ServerとL2j Login Serverの2つのコンポーネントに分かれています。同時に、L2j Game ServerはCoreとDatapackに分かれています。Coreはゲームの仕組み、永続性、通信メカニズムを定義するJavaコードであり、Datapackはダイアログ、クエストスクリプト、AIなど、ゲームプレイに関連するすべてのファイルで構成されています。

サーバーのインストールには、まず追加のソフトウェア（Java、データベース、Gitなど）をインストールし、次にソースコードを取得してコンパイルし、データベースをインストールし、コンパイルされたサーバーファイルをデプロイし、最小限の設定を行い、サーバーを起動してテストする必要があります。

必要なソフトウェア​

  • 更新済みのOS
  • Java
  • MariaDB (または MySQL)
  • Git

OSの更新​

wuauclt /detectnow /updatenow

Javaの取得とインストール​

L2JはJavaで構築されています。サーバーをビルドするためには、Java JDKも必要です。

winget install EclipseAdoptium.Temurin.25.JDK

すでに winget を使用している場合は、以下のコマンドでJavaのバージョンを更新できます。

winget upgrade EclipseAdoptium.Temurin.25.JDK

Javaのバージョンを確認する：

java --version
ヒント

環境変数 JAVA_HOME を更新することをお勧めします。

情報

可能な限り、L2JはJavaの最新のLTS（長期サポート）バージョンと互換性を保ちます。Java SEのロードマップはこちらで確認できます。

Gitの取得とインストール​

L2JはBitBucket上のバージョン管理システムとしてGitを使用しています。最新バージョンを取得するために使用してください。

winget install -e --id Git.Git

Gitのバージョンを確認する：

git --version
情報

ソースコードは私たちの公式公開リポジトリから直接取得することをお勧めします。

データベースサーバーの取得とインストール​

データベースサーバーをダウンロードしてインストールし、専用のユーザーを作成します。

winget install -e --id MariaDB.Server

以下のSQLステートメントを実行して、L2J専用のデータベースユーザーを作成します：

mariadb -u root -p
create_user.sql
CREATE OR REPLACE USER 'l2j'@'%' IDENTIFIED BY 'l2jserver2019';
GRANT ALL PRIVILEGES ON *.* TO 'l2j'@'%' IDENTIFIED BY 'l2jserver2019';
FLUSH PRIVILEGES;
exit
警告

デフォルトのデータベースパスワードを変更することをお勧めします。変更した場合は、Game Serverの config フォルダとLogin Serverの config フォルダにある database.properties ファイルを編集する必要があります。

ヒント

データベースを管理するために、HeidiSQL または DBeaver をダウンロードしてインストールすることをお勧めします（オプション）。

情報

L2Jは MySQL 8.0+ と互換性がありますが、MariaDB を推奨します。

Unzipのインストール​

Windowsでは不要です。

ソースコードの取得​

公式リポジトリは以下の通りです。

mkdir C:\opt\l2j\git
cd C:\opt\l2j\git
git clone -b master https://bitbucket.org/l2jserver/l2j-server-login.git
Cloning into 'l2j-server-login'...
remote: Counting objects: 353, done.
remote: Compressing objects: 100% (285/285), done.
remote: Total 353 (delta 194), reused 63 (delta 26)
Receiving objects: 100% (353/353), 110.40 KiB | 324.00 KiB/s, done.
Resolving deltas: 100% (194/194), done.
git clone -b develop https://bitbucket.org/l2jserver/l2j-server-game.git
Cloning into 'l2j-server-game'...
remote: Counting objects: 162315, done.
remote: Compressing objects: 100% (26695/26695), done.
remote: Total 162315 (delta 122790), reused 157270 (delta 117810)
Receiving objects: 100% (162315/162315), 125.97 MiB | 9.93 MiB/s, done.
Resolving deltas: 100% (122790/122790), done.
git clone -b develop https://bitbucket.org/l2jserver/l2j-server-datapack.git
Cloning into 'l2j-server-datapack'...
remote: Counting objects: 278648, done.
remote: Compressing objects: 100% (66228/66228), done.
remote: Total 278648 (delta 215765), reused 269687 (delta 207236)
Receiving objects: 100% (278648/278648), 144.49 MiB | 9.63 MiB/s, done.
Resolving deltas: 100% (215765/215765), done.
Checking out files: 100% (24264/24264), done.
情報

develop ブランチはHigh Fiveの最新バージョンを含み、master ブランチはHigh Fiveの安定バージョンを含みます。 その他のオプションには、Interlude、Epilogue、Freyaなどがあります。

サーバーのビルド​

Mavenを使用してサーバーファイルをビルドします。以下のコマンドを実行してください：

cd C:\opt\l2j\git\l2j-server-login
mvnw install
[INFO] Scanning for projects...
[INFO]
[INFO] -------------------< com.l2jserver:l2j-server-login >-------------------
[INFO] Building L2J Login Server 2.6.1.6
...
cd C:\opt\l2j\git\l2j-server-game
mvnw install
[INFO] Scanning for projects...
[INFO]
[INFO] -------------------< com.l2jserver:l2j-server-game >--------------------
[INFO] Building L2J Game Server 2.6.2.0-SNAPSHOT
...
cd C:\opt\l2j\git\l2j-server-datapack
mvnw install
[INFO] Scanning for projects...
[INFO]
[INFO] -----------------< com.l2jserver:l2j-server-datapack >------------------
[INFO] Building L2J DataPack 2.6.2.0-SNAPSHOT
...

以下の警告を回避するために​

警告

[WARNING] An NVD API Key was not provided - it is highly recommended to use an NVD API key as the update can take a VERY long time without an API Key

NIST からAPIキーをリクエストし、取得したキーを環境変数 NVD_API_KEY に設定する必要があります。

APIキーがある場合、脆弱性データベースファイルの取得に使用されます。

サーバーのデプロイ​

デプロイプロセスは、現時点では作成されたファイルを単純に解凍するだけです。

Login Serverのデプロイ​

mkdir C:\opt\l2j\server\login
cd C:\opt\l2j\server\login
tar -xf C:\opt\l2j\git\l2j-server-login\target\l2j-server-login-*.zip

Game Serverのデプロイ​

mkdir C:\opt\l2j\server\game
cd C:\opt\l2j\server\game
tar -xf C:\opt\l2j\git\l2j-server-game\target\l2j-server-game-*.zip
tar -xf C:\opt\l2j\git\l2j-server-datapack\target\l2j-server-datapack-*.zip
警告

ファイル名は新しいバージョンごとに変わる可能性があるため、注意してください。

データベースのインストール​

L2J CLIの取得​

L2J CLIは、自動化されたデプロイと初期設定を実装するために使用できるツールです。

mkdir C:\opt\l2j\cli
cd C:\opt\l2j\cli
curl -o l2jcli.zip -L https://l2jserver.com/api/download/cli/latest
tar -xf l2jcli.zip

CLIの設定​

config フォルダ内の login-server.properties と game-server.properties を編集し、データベース用に設定したユーザー名とパスワードに合わせて DatabaseUser と DatabasePassword を設定します。

CLIの実行​

l2jcli.bat を実行し、以下のコマンドを入力します：

l2jcli.bat
db install -sql C:\opt\l2j\server\login\sql -u l2j -p l2jserver2019 -m FULL -t LOGIN -c -mods
db install -sql C:\opt\l2j\server\game\sql -u l2j -p l2jserver2019 -m FULL -t GAME -c -mods

パラメータは以下の通りです：

パラメータ説明
-sql pathSQLファイルへのパス
-u userデータベースユーザー
-p passwordデータベースパスワード
-m modeインストールモード FULL または UPDATE
-t typeサーバータイプ LOGIN または GAME
-cカスタムテーブルをインストール
-modsMOD用テーブルをインストール

管理者アカウントの作成​

L2J CLIを使用して、管理者アカウントを作成します。8は最大のアカウントレベル（マスター）です：

account create -u Zoey76 -p -a 8
quit

サーバーポートの開放​

localhost以外からプレイする場合は、サーバーのいくつかのポートを開放する必要があります。

netsh advfirewall firewall add rule name="L2J Login Server" dir=in action=allow protocol=TCP localport=2106
netsh advfirewall firewall add rule name="L2J Game Server" dir=in action=allow protocol=TCP localport=7777
警告

この操作には管理者特権が必要です。コマンドプロンプトを「管理者として実行」してください。

警告

プレイヤーとしてサーバーに接続するために必要なポートはこれらだけです。

Geodata（ジオデータ）​

L2J Serverは、環境情報をサーバーに含めるためにGeodataファイルを使用します。

Game Serverの設定フォルダ内にある geodata.properties を編集して設定できます。

Geodataは data/geodata フォルダに配置する必要があります。GeoDataPath プロパティを編集することで、このパスを変更できます。

High Five用の最新バージョンをこちらからダウンロードできます。

サーバーの起動​

初期設定​

これらのコマンドは、ログ用の必要なフォルダを作成し、スクリプトに実行権限を付与します。

Windowsでは不要です。

サーバーの開始​

サーバーを起動するためには、Game Server用とLogin Server用の2つのスクリプトを実行する必要があります。

C:\opt\l2j\server\login\startLoginServer.bat
C:\opt\l2j\server\game\startGameServer.bat

サーバーへの接続​

サーバーに接続するには、以下の方法があります：

HOSTSファイル​

C:\Windows\System32\drivers\etc\hosts を編集し、次の行を追加します：

127.0.0.1 l2authd.lineage2.com

BATファイル​

以下の内容で .bat ファイルを作成します：

@start l2.bin IP=127.0.0.1

自作EXE​

以下は C++ Win32 EXE の例です：

#define _WIN32_WINNT _WIN32_WINNT_WINXP
#define NOMINMAX
#include <windows.h>
#include <cstdlib>

// L2を.binとして、IPをパラメータとして起動します。
// IPパラメータとしてIPアドレスまたはDNSを使用できます。
// さらにパラメータを追加することも可能です。
// systemフォルダにL2.exeを置くのを避けるために、.binへのパスを変更できます。
// 作成者: Zoey76
int _stdcall wWinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPWSTR lpCmdLine, int nShowCmd) {
    ShellExecute(0, L"open", L"cmd.exe", L"/C start l2.bin IP=127.0.0.1", 0, SW_HIDE);
}
情報

コンパイル済みのバージョンをこちらからダウンロードできます。詳細な情報はこちらです。

危険

L2Jではクライアントの改造は許可されていません。これにはGameGuardやL2.iniの変更も含まれます。