PostgreSQL is a free, open-source database that runs as a background service and saves data safely to disk.

Windows

1. Download the installer from https://www.postgresql.org/download/windows/ → Click "Download the installer" → Select the latest Windows x86-64

2. Run the installer

   • Keep all defaults
   • Set a password — you will need this later
   • Leave the port as 5432
   • After installation, PostgreSQL starts automatically as a Windows service ✅
   • pgAdmin 4 (a GUI tool) is also installed automatically

3. Open pgAdmin 4 from the Start Menu

4. In the left sidebar, click the terminal icon (PSQL Tool)

5. Enter your password to log in → you will see the postgres=# prompt

6. Run the following command:

   CREATE DATABASE sharedinventory;
   

   → If you see CREATE DATABASE, you are done! ✅

Linux (Ubuntu/Debian)

sudo apt update
sudo apt install postgresql postgresql-contrib
sudo systemctl enable postgresql
sudo systemctl start postgresql
sudo -u postgres psql -c "CREATE DATABASE sharedinventory;"
sudo -u postgres psql -c "ALTER USER postgres PASSWORD 'yourpassword';"

1. Download shared-inventory-2.0.0.jar
2. Place it in your server's mods/ folder
3. Make sure Fabric API is also in your mods/ folder
4. The PostgreSQL JDBC driver is bundled inside the mod — no extra files needed ✅

Start the server once — the config file will be auto-generated at:

config/shared-inventory.json

Edit it with your PostgreSQL connection info:

{
  "database": {
    "host": "localhost",
    "port": 5432,
    "name": "sharedinventory",
    "user": "postgres",
    "password": "YOUR_PASSWORD_HERE"
  },
  "sync": {
    "inventory": true,
    "ender_chest": true,
    "experience": true
  },
  "behavior": {
    "save_interval_ticks": 200
  }
}

Restart the server. If you see this in the log, everything is working:

[SharedInventory] PostgreSQL connection successful!
[SharedInventory] Initialization complete! Ready to sync.

If your servers run on different PCs, all of them must point to the same single PostgreSQL instance.

On the PC running PostgreSQL:

1. Edit postgresql.conf:

   listen_addresses = '*'
   

   Location: C:\Program Files\PostgreSQL\18\data\postgresql.conf

2. Edit pg_hba.conf and add at the bottom:

   host    all    all    0.0.0.0/0    md5
   

3. Restart PostgreSQL and open port 5432 in your firewall

   • Windows Firewall → allow inbound on port 5432

On each Minecraft server's config:

Minecraftserver/config/shared-inventory.json

Set host to the IP address of the PC running PostgreSQL:

"host": "PostgreSQL IP"

Changes are detected every tick. save_interval_ticks only controls the forced periodic save for players with no recent changes.

Server won't start — "Cannot connect to PostgreSQL"

• Check that PostgreSQL is running
  • Windows: services.msc → postgresql-x64-18 should show "Running"
  • Linux: sudo systemctl status postgresql
• Check the password in config/shared-inventory.json
• Make sure the database sharedinventory has been created

Password authentication failed

• The password field in your config does not match your PostgreSQL password
• Open config/shared-inventory.json and correct the password field

PostgreSQL は無料のオープンソースDBです。バックグラウンドサービスとして動作し、データをディスクに安全に保管します。

Windows の場合

1. インストーラーをダウンロード https://www.postgresql.org/download/windows/ → 「Download the installer」 → 最新版の Windows x86-64 を選択

2. インストーラーを実行

   • 全ての項目はデフォルトのままでOK
   • パスワードは必ず設定する（後でコンフィグに入力します）
   • ポートは 5432 のまま
   • インストール完了後、PostgreSQL はWindowsサービスとして自動起動します ✅
   • pgAdmin 4（GUI管理ツール）も同時に自動インストールされます

3. スタートメニューから pgAdmin 4 を起動

4. 左側のサイドバーにあるターミナルアイコン（PSQL Tool）をクリック

5. パスワードを入力してログイン → postgres=# が表示される

6. 以下を入力して Enter を押す

   CREATE DATABASE sharedinventory;
   

   → CREATE DATABASE と表示されれば成功 ✅

Linux（Ubuntu/Debian）の場合

# インストール
sudo apt update
sudo apt install postgresql postgresql-contrib

# 自動起動の設定
sudo systemctl enable postgresql
sudo systemctl start postgresql

# データベースの作成
sudo -u postgres psql -c "CREATE DATABASE sharedinventory;"

# パスワードの設定（yourpassword を変更してください）
sudo -u postgres psql -c "ALTER USER postgres PASSWORD 'yourpassword';"

1. shared-inventory-2.0.0.jar をダウンロード
2. サーバーの mods/ フォルダに入れる
3. Fabric API も mods/ フォルダに入っていることを確認
4. PostgreSQL の JDBC ドライバは Mod内にバンドル済み のため、追加ファイルは不要 ✅

サーバーを一度起動すると、以下のパスにコンフィグファイルが自動生成されます：

config/shared-inventory.json

テキストエディタで開き、PostgreSQLの接続情報を入力します：

{
  "database": {
    "host": "localhost",
    "port": 5432,
    "name": "sharedinventory",
    "user": "postgres",
    "password": "STEP1で設定したパスワード"
  },
  "sync": {
    "inventory": true,
    "ender_chest": true,
    "experience": true
  },
  "behavior": {
    "save_interval_ticks": 200
  }
}

保存してサーバーを再起動します。ログに以下が表示されれば成功です：

[SharedInventory] PostgreSQL への接続成功!
[SharedInventory] 初期化完了! 同期の準備ができました。

異なるPCでサーバーを動かす場合、すべてのサーバーが同じ1台のPostgreSQLを参照するよう設定します。

PostgreSQL がインストールされているPC側の設定：

1. postgresql.conf を編集：

   listen_addresses = '*'
   

   ファイルの場所（Windows）: C:\Program Files\PostgreSQL\18\data\postgresql.conf ファイルの場所（Linux）: /etc/postgresql/*/main/postgresql.conf

2. pg_hba.conf の末尾に以下を追加：

   host    all    all    0.0.0.0/0    md5
   

3. PostgreSQL を再起動し、ファイアウォールでポート 5432 を開放

   • Windows: Windowsファイアウォール → ポート5432を受信許可

各Minecraftサーバーのコンフィグ：

Minecraftserver/config/shared-inventory.json

host を PostgreSQL が動いているPCのIPアドレスに変更：

"host": "PostgreSQL IP"

変化の検出は毎tick行われます。save_interval_ticks は変化がなかった場合の強制保存間隔です。

「PostgreSQL に接続できません」と出てサーバーが起動しない

• PostgreSQL が起動しているか確認
  • Windows: services.msc → postgresql-x64-18 が「実行中」か確認
  • Linux: sudo systemctl status postgresql
• config/shared-inventory.json のパスワードを確認
• データベース sharedinventory が作成されているか確認

「パスワード認証に失敗しました」というエラーが出る

• config/shared-inventory.json の password が間違っています
• PostgreSQL のインストール時に設定したパスワードを正確に入力してください