Pocket Islands

Pocket Islands

Мод для Minecraft на Fabric, Forge и NeoForge, который даёт каждому игроку собственный постоянный остров в карманном измерении.

Поддерживаемые версии:

Возможности

• Карманные острова: каждый игрок получает собственное изолированное измерение-остров
• Постоянство: острова переживают сброс основного мира
• Доступ через портал: постройте рамку портала, активируйте изумрудом
• Система приглашений: приглашайте друзей в гости на свой остров
• Пустая генерация: чистые пустые миры с островом для старта

Требования

• Minecraft 1.20.1, 1.20.4 или 1.21.11
• Fabric: Fabric Loader (0.15.0+ для 1.20.x, 0.18.4+ для 1.21.x) и Fabric API
• Forge (1.20.1): Forge 47 или новее. Больше ничего: Infiniverse встроен в jar
• NeoForge (1.21.11): NeoForge 21.11.45 или новее. Больше ничего: Infiniverse встроен в jar
• Мод должен быть установлен и на клиенте, и на сервере

Сервер

1. Установите Fabric Loader, Forge или NeoForge на свой сервер
2. Скачайте JAR Pocket Islands для вашей версии MC и загрузчика

3. Положите в папку mods/ сервера

   • На Fabric убедитесь, что Fabric API тоже установлен туда
4. Запустите сервер

Клиент

1. Установите Fabric Loader, Forge или NeoForge
2. Скачайте JAR Pocket Islands для вашей версии MC и загрузчика

3. Положите в свою папку mods/

   • На Fabric убедитесь, что Fabric API тоже установлен туда
4. Запустите Minecraft

Важно: мод должен быть установлен и на клиенте, и на сервере. Подробности в FAQ.

Различия между загрузчиками

Острова работают одинаково на всех загрузчиках, за исключением следующего:

Консоль и командные блоки всегда используют уровни OP для прав /pi.

Перенос целого мира между загрузчиками не поддерживается: смена загрузчика заменяет весь модпак. Отдельные острова переносить можно: скопируйте world/dimensions/personalworlds/ на другой сервер (та же версия Minecraft), и острова откроются без конвертации. Реестр островов, точки возврата и приглашения остаются в собственном мире каждого сервера. Новые чанки островов OVERWORLD/FLAT затем будут генерироваться с сидом другого загрузчика (см. таблицу выше).

Использование

Создание портала

Это можно настроить; в объяснении используется конфигурация по умолчанию.

Постройте рамку из блоков Nether (4 в ширину x 5 в высоту):

N N N N
N     N
N     N
N     N
N N N N

Нажмите правой кнопкой мыши по внутренней части рамки изумрудом, чтобы активировать.

Вход на свой остров

Войдите в активированный портал, чтобы попасть на свой карманный остров. При первом входе ваш остров генерируется из слоёв острова вашего типа портала. На новом острове нет обратного портала.

Возвращение

Самый быстрый способ вернуться — спрыгнуть с острова: ниже Y=0 вас телепортирует обратно туда, откуда вы вошли, до получения урона от пустоты.

Чтобы вернуться через портал, постройте рамку на своём острове и активируйте её так же, как первую (возьмите с собой блоки рамки и предмет активации). Вход в неё вернёт вас на исходное место.

Команды

Команды игрока:

• /pi invites — Просмотреть свои приглашения (отправленные и полученные)
• `/pi invite ` — Пригласить игрока на свой остров
• `/pi invite always` — Пригласить со статусом Always Welcome (если включено)
• `/pi uninvite ` — Отозвать приглашение игрока
• `/pi togglewelcome ` — Переключить Always Welcome для существующего приглашения (если включено)
• /pi portals — Просмотреть все настроенные типы порталов и статус своего острова

Команды администратора (уровень оператора 2+):

• /pi admin list — Список всех островов
• `/pi admin info ` — Просмотреть детали острова
• `/pi admin tp ` — Телепортироваться на остров
• `/pi admin delete [confirm]` — Удалить остров (уровень оператора 4)

Команды отладки (уровень оператора 4):

• /pi debug perf enable — Включить мониторинг производительности
• /pi debug perf disable — Отключить мониторинг производительности
• /pi debug perf status — Показать статус производительности
• /pi debug perf reset — Сбросить счётчики производительности

Примечание: Команды отладки вам вряд ли понадобятся, но могут пригодиться для проверки.

Настройка

Файл конфигурации: config/pocketislands.json

Pocket Islands предлагает широкие возможности настройки, особенно для состава острова. Вы можете задать несколько типов порталов, каждый из которых создаёт острова с разными материалами и свойствами.

Пример конфигурации

{
    "portalTypes": [
        {
            "frameBlock": "minecraft:nether_bricks",
            "activationItem": "minecraft:emerald",
            "islandLayers": [
                "minecraft:grass_block",
                "minecraft:dirt",
                "minecraft:stone"
            ],
            "portalColor": "red"
        }
    ],
    "consumeActivationItem": false,
    "maxInvitationsPerPlayer": 20,
    "enableAlwaysWelcome": false,
    "unloadEmptyDimensionDelayTicks": 600,
    "cleanupIntervalTicks": 600,
    "sanitizeChunksOnLoad": false,
    "sanitizeRemoveOrphanBlocks": false,
    "enableTeleportParticles": true,
    "enableTeleportSounds": true,
    "enablePortalActivationEffects": true,
    "enableInvitationNotifications": true,
    "dimensionGameRules": {
        "doMobSpawning": false
    }
}

Параметры конфигурации

Типы порталов (настройка острова)

Задайте несколько типов порталов, чтобы создавать острова с разными материалами:

• frameBlock — Блок, используемый для рамок портала (например, "minecraft:nether_bricks")
• activationItem — Предмет, используемый для активации порталов (например, "minecraft:emerald")

• islandLayers — Настройте стартовую платформу своего острова (до 5 слоёв, сверху вниз)

  • Пример: ["minecraft:grass_block", "minecraft:dirt", "minecraft:stone"]
  • Создавайте тематические острова: grass/dirt/stone, netherrack/soul_sand/basalt, end_stone и т. д.
  • Каждый тип портала создаёт уникальный состав острова
  • Каждый слой толщиной в 1 блок; для 2 слоёв блока земли повторите материал в массиве

• portalColor — Цвет эффекта портала (по умолчанию: "red")

  • Доступные цвета: "white", "light_gray", "gray", "black", "brown", "red", "orange", "yellow", "lime", "green", "cyan", "light_blue", "blue", "purple", "magenta", "pink"
  • Помогает визуально различать разные типы порталов

Приглашения

• maxInvitationsPerPlayer — Максимум приглашений на игрока (-1 — без ограничений)
• enableAlwaysWelcome — Включить функцию Always Welcome (по умолчанию: false, требуется перезапуск)

Функция Always Welcome

По умолчанию посетители могут попасть на ваш остров, только когда вы в сети и находитесь на своём острове. Функция Always Welcome позволяет владельцам островов выдавать конкретным гостям постоянный доступ в обход этих ограничений.

Включение функции

Установите enableAlwaysWelcome в true в конфиге и перезапустите сервер:

{
    "enableAlwaysWelcome": true
}

Примечание: Для применения этой настройки требуется перезапуск сервера. Когда функция отключена, все команды Always Welcome скрыты, а существующие флаги игнорируются.

Использование Always Welcome

После включения у владельцев островов есть два способа выдать статус Always Welcome:

Вариант 1: Пригласить с Always Welcome

/pi invite Steve always

Это сразу создаёт новое приглашение с включённым Always Welcome.

Вариант 2: Переключить существующее приглашение

/pi togglewelcome Steve

Это переключает статус Always Welcome у существующего приглашения. Запустите ещё раз, чтобы отключить.

Просмотр статуса Always Welcome

Используйте /pi invites, чтобы увидеть отправленные приглашения. Когда функция включена, у каждого приглашения отображается кликабельный индикатор-звёздочка:

Отправленные (игроки, которые могут вас посетить):
  - Steve [★] [Отозвать]    ← Зелёная звезда: Always Welcome ВКЛ
  - Alex  [☆] [Отозвать]    ← Серая звезда: Always Welcome ВЫКЛ

Нажмите на звезду, чтобы переключить статус прямо из чата.

Поведение контроля доступа

Примечания:

• Админы (OP уровень 2+) всегда обходят все ограничения на посещение
• Владелец острова всегда может попасть на свой собственный остров
• Гостям с Always Welcome всё ещё нужно активное приглашение (отзыв приглашения убирает доступ)

Производительность

• unloadEmptyDimensionDelayTicks — Задержка перед выгрузкой пустых измерений (по умолчанию: 600 = 30 секунд)
• cleanupIntervalTicks — Как часто проверять пустые измерения (по умолчанию: 600 = 30 секунд)

Очистка чанков

• sanitizeChunksOnLoad — Удалять осиротевшие блочные сущности и неизвестные предметы в контейнерах при загрузке чанка (по умолчанию: false; включается вручную)
• sanitizeRemoveOrphanBlocks — Также удалять блоки, оставшиеся без действительной опоры (огни, факелы, Redstone, слои снега), во время очистки (по умолчанию: false; используется только когда включён sanitizeChunksOnLoad)

Визуальные эффекты

• enableTeleportParticles — Показывать эффекты частиц во время телепортации
• enableTeleportSounds — Проигрывать звуковые эффекты во время телепортации
• enablePortalActivationEffects — Показывать эффекты при активации порталов
• enableInvitationNotifications — Проигрывать звуки для уведомлений о приглашениях

Дополнительные параметры

• consumeActivationItem — Расходуется ли активирующий предмет при активации портала (по умолчанию: false)

Игровые правила измерений

Карманные измерения по умолчанию наследуют все игровые правила из оверворлда. Вы можете переопределить конкретные правила с помощью конфигурации dimensionGameRules:

{
    "dimensionGameRules": {
        "keepInventory": true,
        "randomTickSpeed": 3,
        "doMobSpawning": false
    }
}

Эта конфигурация:

• Принудительно устанавливает keepInventory в true (игроки сохраняют предметы при смерти)
• Принудительно устанавливает randomTickSpeed в 3 (множитель роста культур и растений)
• Принудительно устанавливает doMobSpawning в false (мобы не могут спавниться естественным образом)
• Все остальные правила наследуются из оверворлда

Названия игровых правил для разных версий:

В Minecraft 1.21.x многие игровые правила были переименованы. Используйте подходящие названия для вашей версии сервера:

Поведение по умолчанию:

• 1.20.x: {"doMobSpawning": false} — создаёт пустотные острова без мобов
• 1.21.x: {"spawn_mobs": false} — то же поведение с переименованным правилом

ПРИМЕЧАНИЕ: Подразумевается, что спавн мобов в карманном измерении отключён. Включать его не имеет смысла, так как это мир типа VOID, но если хотите — можете. Просто установите doMobSpawning / spawn_mobs в true в конфигурации.

Это неподдерживаемая функция, и она не будет приниматься как баг.

Чтобы унаследовать все правила из обычного мира без изменений, используйте пустую карту:

{
    "dimensionGameRules": {}
}

Создание нескольких типов порталов

Вы можете задать несколько типов порталов, чтобы создавать острова с разными тематиками. Игроки могут выбирать тип острова, используя разные материалы для портала:

{
    "portalTypes": [
        {
            "frameBlock": "minecraft:nether_bricks",
            "activationItem": "minecraft:emerald",
            "islandLayers": [
                "minecraft:grass_block",
                "minecraft:dirt",
                "minecraft:stone"
            ],
            "portalColor": "red"
        },
        {
            "frameBlock": "minecraft:blackstone",
            "activationItem": "minecraft:nether_star",
            "islandLayers": [
                "minecraft:netherrack",
                "minecraft:soul_sand",
                "minecraft:basalt"
            ],
            "portalColor": "red"
        },
        {
            "frameBlock": "minecraft:end_stone_bricks",
            "activationItem": "minecraft:ender_pearl",
            "islandLayers": [
                "minecraft:end_stone"
            ],
            "portalColor": "cyan"
        }
    ]
}

Примечание: Первый использованный игроком тип портала навсегда определяет состав его острова.

Перезагрузка конфигурации

Используйте /pi admin reload, чтобы перезагрузить конфигурацию без перезапуска сервера. Изменения типов порталов влияют только на новые создаваемые острова.

Переводы

Pocket Islands использует стандартную систему языковых файлов Fabric для всех сообщений, отображаемых пользователю. Это позволяет администраторам серверов и создателям модпаков настраивать сообщения или добавлять переводы на разные языки.

Расположение языковых файлов

Языковые файлы находятся по пути:

src/main/resources/assets/personalworlds/lang/

По умолчанию мод включает английский (US) перевод:

lang/en_us.json

Добавление своих языков

Чтобы добавить поддержку другого языка (например, немецкого, нидерландского, испанского):

1. Создайте новый языковой файл с соответствующим кодом локали:

   • de_de.json для немецкого
   • nl_nl.json для нидерландского
   • es_es.json для испанского
   • Смотрите Minecraft Wiki - Language для всех кодов локалей

2. Скопируйте содержимое en_us.json как шаблон

3. Переведите значения сообщений (ключи оставьте без изменений):

{
    "pocketislands.message.invite_sent": "Eingeladen %s zu deiner Dimension",
    "pocketislands.message.invite_received": "%s hat dich zu ihrer Dimension eingeladen",
    // ...
}

4. Поместите файл в assets/personalworlds/lang/ в вашем ресурспаке или JAR-файле мода

Настройка сообщений

Чтобы настроить сообщения, оставив английский язык:

1. Создайте ресурспак или отредактируйте assets/personalworlds/lang/en_us.json напрямую
2. Измените значения переводов (правая часть каждой строки)
3. Оставьте ключи переводов (левая часть) без изменений
4. Используйте %s для строковых параметров, %d для чисел

Пример:

{
    "pocketislands.message.invite_sent": "You invited %s to your island!",
    "pocketislands.message.invite_received": "%s wants you to visit their island!"
}

### Доступные ключи перевода

Все ключи перевода задокументированы в `lang/en_us.json`. Категории ключей включают:

- **`pocketislands.message.*`** — Сообщения для игроков (приглашения, изгнания, телепортации)
- **`pocketislands.command.*`** — Обратная связь команд и информация
- **`pocketislands.command.error.*`** — Сообщения об ошибках
- **`pocketislands.invitations.*`** — Текст интерфейса списка приглашений
- **`pocketislands.command.perf.*`** — Сообщения мониторинга производительности
- **`pocketislands.command.list.*`** — Вывод команды списка для админов
- **`pocketislands.command.info.*`** — Вывод команды информации для админов
- **`pocketislands.command.delete.*`** — Предупреждения команды удаления для админов
- **`pocketislands.command.portals.*`** — Список типов порталов и статус острова

## Технические детали

### Хранение измерений

Каждый карманный остров хранится по пути:

world/dimensions/personalworlds/pw_/

Где `<uuid>` — UUID игрока без дефисов.

### Восстановление метаданных

Каждая папка измерения содержит файл `.metadata`, который позволяет восстановить данные при повреждении основного реестра. Этот файл содержит:

- UUID владельца
- Имя владельца
- ID измерения
- Временную метку создания
- Точку появления
- Тип генератора

### Обработанные крайние случаи

- **Игрок отключается, находясь в карманном острове**: Позиция сохраняется, измерение восстанавливается при повторном подключении, даже если оно было выгружено
- **Измерение выгружено, пока игрок оффлайн**: Игрок восстанавливается на своём острове с откатом к точке появления у кровати или точке появления мира, если восстановление не удалось
- **Сервер падает**: Обработчик восстановления проверяет права и эвакуирует при необходимости
- **Два игрока входят в портал одновременно**: Защита от одновременных порталов предотвращает состояния гонки
- **Позиция возврата заблокирована**: Поиск безопасной точки появления находит ближайшую безопасную позицию
- **Приглашение отозвано, пока игрок оффлайн**: Игрок эвакуируется при следующем входе с цепочкой отката (данные возврата → кровать → точка появления)
- **Игрок падает с острова**: Автоматически телепортируется обратно до получения урона от пустоты
- **Неизвестные блоки или предметы в контейнерах**: При включённом `sanitizeChunksOnLoad` чанки очищаются при загрузке — осиротевшие блочные сущности (поддерживающий блок теперь воздух) удаляются, неизвестные предметы в контейнерах очищаются. Либо запустите `/pi admin sanitize` по требованию.

## Производительность

Мод рассчитан на эффективную работу с 15+ одновременными островами:

- Острова автоматически выгружаются, когда пусты (после задержки в 30 секунд)
- Экономичная по памяти генерация чанков для пустых миров
- Мониторинг производительности доступен через отладочные команды

## Благодарности

> Прежде всего я хочу поблагодарить своего друга Bktwone за вдохновение для этого мода, а также за предоставление платформы для его тестирования.

- Построен на [Fantasy](https://github.com/NucleoidMC/fantasy) для создания измерений во время выполнения
- Fabric API для хуков модов