Limited Spectator

🧭 Limited Spectator

Мультизагрузочный мод для Minecraft, добавляющий ограниченный режим наблюдателя с настраиваемыми ограничениями.

Поддерживаемые загрузчики: NeoForge ✅ • Fabric ✅ • Quilt ✅ (только Production)

📖 Обзор

Limited Spectator позволяет игрокам входить в управляемый режим наблюдателя, который ограничивает их возможности во время полёта и наблюдения за миром. В отличие от ванильного режима наблюдателя, эта версия позволяет нажать F1, чтобы показать HUD, и ограничивает взаимодействия для сохранения игрового баланса на серверах и в кастомных мирах.

Идеально подходит для:

• SMP;

• Строителей, которые хотят визуально наблюдать без полных привилегий наблюдателя.

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

✅ Полностью настраиваемый режим наблюдателя Комплексная система конфигурации на основе TOML, позволяющая владельцам серверов настроить каждый аспект поведения наблюдателя.

✅ Ограниченный режим наблюдателя Игроки могут войти в особое состояние наблюдателя, которое позволяет свободно летать, но запрещает использование инвентаря, PvP и взаимодействие с миром.

✅ Гибкие ограничения дистанции Настройте максимальное расстояние от начальной позиции (по умолчанию 75 блоков) или отключите его полностью. Выберите между телепортацией назад или предупреждением.

✅ Настраиваемые взаимодействия с блоками Точно определите, с какими блоками игроки могут взаимодействовать, используя ID блоков Minecraft. По умолчанию включены двери, люки и калитки.

✅ Гранулярный контроль разрешений Задайте разные уровни разрешений (0-4) для команд /spectator и /survival с опциональным требованием OP.

✅ Выборочная видимость HUD Элементы HUD по умолчанию скрыты, но их можно временно показать нажатием F1 (настраивается).

✅ Контроль путешествий между измерениями Настройте, могут ли игроки переключать измерения (Nether, End и т.д.) в режиме наблюдателя.

✅ Перемещение игрока Автоматический сброс позиции при превышении лимитов дистанции или выполнении команды /survival.

✅ Возможность полёта Игроки в режиме наблюдателя могут летать двойным нажатием пробела.

✅ Ограничения боя и взаимодействий Отдельно переключайте PvP, атаки мобов, выброс/подбор предметов и крафт в инвентаре.

✅ Горячая перезагрузка конфигурации Все настройки можно изменить в config/limitedspectator-common.toml и перезагрузить командой /reload.

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

✅ Мультиязычная поддержка Полная поддержка перевода на 5 европейских языков (английский, итальянский, немецкий, французский, испанский).

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

⚙️ Команды

🌍 Сообщения обратной связи команд полностью локализованы на 5 языках: английский, итальянский, немецкий, французский и испанский.

Примечание: Уровни доступа можно настроить в файле конфигурации. Смотри раздел «Конфигурация» ниже.

⚙️ Конфигурация

Limited Spectator имеет обширную систему конфигурации. При первом запуске файл конфигурации создаётся автоматически по пути:

Расположение: config/limitedspectator-common.toml

Категории конфигурации

🚶 Ограничения передвижения

• max_distance — максимальное расстояние от начальной позиции (по умолчанию: 75.0 блоков, -1 для отключения)
• allow_dimension_travel — разрешить смену измерения в режиме наблюдателя (по умолчанию: false)
• teleport_back_on_exceed — телепортировать обратно при превышении расстояния вместо предупреждения (по умолчанию: true)
• reset_position_on_logout — сбрасывать позицию при выходе из игры для предотвращения злоупотреблений (по умолчанию: true)

🎮 Способности игрока

• enable_invulnerability — сделать игроков неуязвимыми (защищает от мобов и урона от окружения, но не от урона при падении) (по умолчанию: true)
• enable_flight — разрешить полёт в режиме наблюдателя (по умолчанию: true)
• spectator_gamemode — используемый режим игры: "ADVENTURE" или "SPECTATOR" (по умолчанию: "ADVENTURE")

🔧 Ограничения взаимодействия

• allow_pvp — разрешить атаковать других игроков (по умолчанию: false)
• allow_item_drop — разрешить выбрасывать предметы (по умолчанию: false)
• allow_item_pickup — разрешить подбирать предметы (по умолчанию: false)
• allow_inventory_crafting — разрешить крафт в инвентаре (сетка 2x2) (по умолчанию: false)
• interactable_blocks — список ID блоков, с которыми игроки могут взаимодействовать (по умолчанию: все двери, люки, калитки)

Примечание: Атаки мобов всегда отключены, потому что мобы не атакуют игроков со способностью mayfly=true (базовое поведение Minecraft).

🔐 Права на команды

• spectator_command_permission_level — уровень доступа для /spectator (0-4, по умолчанию: 0)
• survival_command_permission_level — уровень доступа для /survival (0-4, по умолчанию: 0)
• require_op_for_spectator — требовать статус оператора для команд наблюдателя (по умолчанию: false)

🖥️ Поведение клиента и HUD

• HUD автоматически скрывается при входе в режим наблюдателя (жёстко задано)
• Клавиша F1 временно переключает видимость HUD

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

• use_action_bar_messages — показывать сообщения в панели действий вместо чата (по умолчанию: true)
• show_distance_warnings — показывать предупреждения при приближении к лимиту расстояния (по умолчанию: true)

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

Сервер с расслабленным режимом наблюдателя:

[movement_restrictions]
  max_distance = -1  # Без ограничения расстояния
  allow_dimension_travel = true

[interactions]
  allow_item_pickup = true  # Разрешить подбирать предметы
  interactable_blocks = ["minecraft:oak_door", "minecraft:lever", "minecraft:stone_button"]

Строгий сервер выживания:

[permissions]
  spectator_command_permission_level = 2  # Требуется ранг модератора
  require_op_for_spectator = true

[movement_restrictions]
  max_distance = 50.0  # Более короткий лимит расстояния
  reset_position_on_logout = true  # Предотвратить злоупотребление выходом из игры

Все изменения конфигурации можно применить без перезапуска сервера с помощью /reload.

🔐 Ограничения по умолчанию в режиме наблюдателя

Примечание: Большинство ограничений ниже настраиваются через config/limitedspectator-common.toml

• ❌ Нельзя ломать или ставить блоки (обеспечивается режимом ADVENTURE — изменить нельзя)

• ❌ Нельзя взаимодействовать с сундуками, кроватями, верстаками и предметами (настраивается через белый список блоков)

• ❌ Нельзя крафтить в инвентаре (сетка 2x2) — ингредиенты возвращаются автоматически (настраивается)

• ❌ Нельзя перемещаться между измерениями (настраивается)

• ❌ Мобы не атакуют (мобы не нацеливаются на игроков со способностью mayfly)

• ❌ Нет PvP (настраивается)

• ❌ Нельзя выбрасывать или подбирать предметы (настраивается отдельно)

• ✅ Двери, люки и калитки остаются интерактивными (полностью настраивается через ID блоков)

• ✅ F1 переключает видимость HUD (настраивается)

• ✅ Ограничение дистанции: 75 блоков (настраивается, можно отключить)

🧩 Совместимость

• ✅ Minecraft 1.21.1+

• ✅ NeoForge 21.1.0+

• ✅ Безопасно для мультиплеера

• ⚠️ Limited Spectator использует стандартные хуки событий NeoForge и должен быть совместим с большинством модов. Однако моды, которые глубоко изменяют обработку игровых режимов игрока или отрисовку HUD, могут помешать его работе.

🌐 Требования к окружению

Limited Spectator — мод с серверным авторитетом. Тег Modrinth "Client and server" указывает, куда мод можно установить, а не куда он обязателен.

Совместимость подключения

• Ванильные клиенты могут зайти на сервер с Limited Spectator. Все ограничения всё равно применяются на стороне сервера — игроки просто не получат эффект скрытия HUD.
• Клиенты с установленным Limited Spectator получают полноценный задуманный опыт (чистый HUD, синхронизированные события).

Детали по загрузчикам

• Сборки для Fabric & Quilt: клиентского кода сейчас нет, так что JAR фактически только для сервера. Установка на клиент безвредна, но сегодня не добавляет никаких дополнительных функций.
• Сборка для NeoForge: единственная клиентская часть — небольшой необязательный обработчик пакетов для синхронизации HUD. Сетевой канал зарегистрирован как необязательный, поэтому рукопожатие работает и с модифицированными, и с ванильными клиентами.

Рекомендуемая настройка

🧰 Установка

📦 Выберите свой загрузчик

Скачайте правильную версию для вашего загрузчика модов:

Шаги установки

1. Установите ваш загрузчик модов (NeoForge 21.1.217+ / Fabric 0.16.5+ / Quilt 0.26.4+)
2. Поместите правильный JAR в папку mods/
3. Запустите Minecraft
4. (только NeoForge) Файл конфигурации автоматически создаётся в config/limitedspectator-common.toml
5. (только NeoForge) Перезагрузите изменения командой /reload

Примечание: Версии для Fabric и Quilt используют жёстко заданные значения по умолчанию. Система конфигурации запланирована в будущем релизе.

🌍 Локализация

Limited Spectator включает полную поддержку перевода для самых распространённых европейских языков:

Поддерживаемые языки:

• 🇬🇧 English (en_us) - Базовый язык
• 🇮🇹 Italian (it_it) - Italiano
• 🇩🇪 German (de_de) - Deutsch
• 🇫🇷 French (fr_fr) - Français
• 🇪🇸 Spanish (es_es) - Español

Переведённые сообщения:

• Обратная связь команд (/spectator и /survival)
• Уведомления о лимите дистанции
• Сообщения об ошибках (перемещение между измерениями, ограничения крафта)
• Весь текст, видимый пользователю

Мод автоматически определяет настройки языка Minecraft и отображает сообщения соответственно.

⚠️ Ограничения режима ADVENTURE в Minecraft

Limited Spectator использует режим ADVENTURE в Minecraft (вместо режима SPECTATOR), чтобы предотвратить noclip, сохраняя возможность полёта. Этот выбор дизайна вносит некоторые неотъемлемые ограничения:

Основные ограничения (по замыслу)

Это НЕ баги — это фундаментальные ограничения режима ADVENTURE в Minecraft, которые невозможно обойти:

1. Ручная активация полёта: Игроки должны дважды нажать пробел, чтобы начать летать. Автоматический полёт требует ванильного режима SPECTATOR (который включает noclip).

2. Только урон от падения: При mayfly=true движок Minecraft полностью предотвращает расчёт урона от падения. Однако enable_invulnerability=true ЗАЩИЩАЕТ от мобов, лавы, огня, кактусов и другого урона от окружения.

3. Разрушение/установка блоков отключены: Режим ADVENTURE блокирует все действия по строительству на уровне GameMode. Это нельзя изменить без глубоких Mixin-вмешательств в ядро движка Minecraft.

Почему существуют эти ограничения

Limited Spectator ставит наблюдение без noclip выше полноты функций. Включение ванильного режима SPECTATOR позволило бы игрокам:

• Проходить сквозь стены и блоки (noclip)
• Получать доступ к областям, которые они не должны видеть
• Обходить серверные защиты

Эти ограничения сохраняют основную цель мода: сбалансированное наблюдение для серверов.

Альтернатива: использование режима SPECTATOR

Если вам нужны полные ванильные возможности наблюдателя (неуязвимость, noclip и т.д.), установите spectator_gamemode = "SPECTATOR" в конфиге. Учтите, что это включает noclip и снижает безопасность для многопользовательских серверов.

🧾 Лицензия

Этот проект распространяется под лицензией MIT. Подробности см. в файле LICENSE. Copyright (c) 2025 karashi

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

📦 Ссылки на проект

❤️ Благодарности

• Автор: Karashi

• Разработка: Полностью кастомная кодовая база для NeoForge 1.21.1

• Дизайн иконки: Минималистичный дизайн, сгенерированный ИИ (OpenAI)

• Особая благодарность: сообществу Minecraft и NeoForge

🚀 Планы на будущее

• 🧱 Опциональная интеграция со сторонними системами прав (LuckPerms, FTB Chunks)

• 🔍 Расширенный API для кастомных событий наблюдателя (SpectatorModeEnterEvent, SpectatorModeExitEvent)

• 💾 Постоянное хранение состояния (сохранение позиций наблюдателя между перезапусками сервера)

• ⏱️ Ограничения времени наблюдения (настраиваемая максимальная длительность в режиме наблюдателя)

• ✨ Частицы или визуальные границы для ограничений дистанции