FabricSharedInventory

🎒 Shared Inventory — Общий инвентарь, эндер-сундук и опыт между серверами

Делитесь инвентарём, эндер-сундуком и опытом между несколькими серверами Fabric в реальном времени.

💾 Работает на PostgreSQL — данные навсегда записываются на диск. Даже если сервер упадёт, ваши предметы в безопасности.

✨ Возможности

• 🔄 Синхронизация в реальном времени — изменения обнаруживаются за 1 тик (50 мс) и мгновенно сохраняются
• 🌐 Между серверами — работает на серверах, запущенных на совершенно разных ПК
• 💾 Постоянное хранение — PostgreSQL сразу пишет на диск. Никакой потери данных при отключении питания
• 📴 Офлайн-синхронизация — игроки автоматически получают последние данные при входе на сервер, который был офлайн
• 🛡️ Защита при запуске — сервер отказывается запускаться, если база данных недоступна, с подробным логом ошибки
• ⚙️ Отдельные переключатели — инвентарь / эндер-сундук / опыт можно включать и отключать по отдельности для каждого сервера

---

📋 Требования

• Minecraft 1.20.1
• Fabric Loader 0.15.0+
• Fabric API
• PostgreSQL (бесплатный, размещается самостоятельно — руководство по установке ниже)

---

🚀 Установка

📦 Шаг 1 — Установка PostgreSQL (нажмите, чтобы развернуть)

PostgreSQL — это бесплатная база данных с открытым исходным кодом, которая работает как фоновая служба и надёжно сохраняет данные на диск. ### Windows 1. Скачайте установщик с https://www.postgresql.org/download/windows/ → Нажмите «Download the installer» → Выберите последнюю версию Windows x86-64 2. Запустите установщик - Оставьте все настройки по умолчанию - Задайте пароль — он понадобится позже - Оставьте порт 5432 - После установки PostgreSQL запускается автоматически как служба Windows ✅ - pgAdmin 4 (графический инструмент) также устанавливается автоматически 3. Откройте pgAdmin 4 из меню «Пуск» 4. В левой боковой панели нажмите значок терминала (PSQL Tool) 5. Введите пароль для входа → появится приглашение postgres=# 6. Выполните следующую команду: sql CREATE DATABASE sharedinventory; → Если вы видите CREATE DATABASE, всё готово! ✅ ### Linux (Ubuntu/Debian) bash 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';"

---

🗂️ Шаг 2 — Установка мода (нажмите, чтобы развернуть)

1. Скачайте shared-inventory-2.0.0.jar 2. Поместите его в папку mods/ вашего сервера 3. Убедитесь, что Fabric API тоже лежит в папке mods/ 4. Драйвер PostgreSQL JDBC встроен в мод — дополнительные файлы не нужны ✅

---

⚙️ Шаг 3 — Настройка (нажмите, чтобы развернуть)

Запустите сервер один раз — файл конфигурации создастся автоматически по пути: config/shared-inventory.json Отредактируйте его, указав данные подключения к PostgreSQL: json { "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 } } Перезапустите сервер. Если в логе появилось это, всё работает: [SharedInventory] PostgreSQL connection successful! [SharedInventory] Initialization complete! Ready to sync.

---

🖥️ Настройка для нескольких ПК — разные компьютеры (нажмите, чтобы развернуть)

Если ваши серверы работают на разных ПК, все они должны указывать на один и тот же экземпляр PostgreSQL. На ПК, где работает PostgreSQL: 1. Отредактируйте postgresql.conf: listen_addresses = '*' Расположение: C:\Program Files\PostgreSQL\18\data\postgresql.conf 2. Отредактируйте pg_hba.conf и добавьте в конец: host all all 0.0.0.0/0 md5 3. Перезапустите PostgreSQL и откройте порт 5432 в брандмауэре - Брандмауэр Windows → разрешите входящие подключения на порт 5432 В конфиге каждого сервера Minecraft: Minecraftserver/config/shared-inventory.json Укажите в host IP-адрес ПК, на котором работает PostgreSQL: json "host": "PostgreSQL IP"

---

📊 Справочник по конфигу (нажмите, чтобы развернуть)

| Ключ | По умолчанию | Описание | |-----|---------|-------------| | database.host | localhost | Адрес сервера PostgreSQL | | database.port | 5432 | Порт PostgreSQL | | database.name | sharedinventory | Имя базы данных | | database.user | postgres | Имя пользователя | | database.password | password | Пароль | | sync.inventory | true | Синхронизировать основной инвентарь | | sync.ender_chest | true | Синхронизировать эндер-сундук | | sync.experience | true | Синхронизировать опыт (уровень и полоса опыта) | | behavior.save_interval_ticks | 200 | Интервал периодического сохранения (20 тиков = 1 сек) | Изменения обнаруживаются каждый тик. save_interval_ticks управляет только принудительным периодическим сохранением для игроков без недавних изменений.

---

❗ Решение проблем (нажмите, чтобы развернуть)

Сервер не запускается — «Cannot connect to PostgreSQL» - Проверьте, что PostgreSQL запущен - Windows: services.msc → postgresql-x64-18 должен показывать «Running» - Linux: sudo systemctl status postgresql - Проверьте пароль в config/shared-inventory.json - Убедитесь, что база данных sharedinventory создана Password authentication failed - Поле password в конфиге не совпадает с вашим паролем PostgreSQL - Откройте config/shared-inventory.json и исправьте поле password

--- ## 📄 Лицензия — MIT --- --- --- --- --- - Minecraft 1.20.1 - Fabric Loader 0.15.0+ - Fabric API ---

📦 Шаг 1 — Установка PostgreSQL (нажмите, чтобы развернуть)

### Windows https://www.postgresql.org/download/windows/ → «Download the installer» → Выберите последнюю версию Windows x86-64 sql 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;"

sudo -u postgres psql -c "ALTER USER postgres PASSWORD 'yourpassword';"