Structure Spawn Point

Structure Spawn Point

Получите то идеальное начало, которое вы всегда искали. Начните где угодно: хижина ведьмы, деревня, океанский монумент — что душе угодно. Идеальная структура оценивается несколькими способами, но главное — проверяется биом, в котором находится структура, а также процент окружающей территории, приходящийся на предпочитаемые вами биомы. Этот мод также поддерживает кастомный спавн мобов внутри вашей стартовой структуры, подробнее ниже.

Как это работает

При запуске сервера мод ищет заданную структуру. Поиск начинается с 0,0 и расходится наружу от этой точки. Каждый кандидат оценивается по вашим предпочтениям биомов и требованиям к рельефу. Когда идеальное место найдено, точка спавна мира устанавливается там, а все уже ожидающие игроки телепортируются. Игроки, зашедшие позже, телепортируются при входе. Если ваши требования просты, поиск пройдёт быстро и может даже завершиться до окончания экрана загрузки. Если требования очень строгие, поиск может занять несколько минут. Ожидайте заметных лаг-спайков во время поиска, но не волнуйтесь: как только поиск завершён — всё, больше никакого влияния на производительность.

С чего начать

1. Установите мод в свой модпак на Fabric 1.21.1 вместе с Fabric API.
2. Запустите игру один раз — мод создаст конфиг по умолчанию в config/structure-spawn-point.json.
3. Укажите в target_structure структуру, в которой должны появляться игроки.
4. Запустите сервер или зайдите в мир. Поиск выполняется автоматически в каждом новом мире и читает конфиг при запуске сервера или по команде сброса — перезапускать всю игру для обновления конфига не нужно.

Хотите разное начало в разных мирах?

Для конфигураций под конкретный мир создайте файл config/structure-spawn-point/<имя-мира>.json. Конфиги для конкретного мира имеют приоритет над глобальным.

Как найти ID структуры

Используйте команду /locate structure в игре, чтобы узнать ID структур (например, minecraft:village). Именно это значение указывается в target_structure. Мод поддерживает как конкретные ID структур, так и теги структур — просто введите любой из форматов, и мод автоматически попробует оба. Префикс #, используемый в командах, не обязателен, но и его наличие ничего не ломает.

"target_structure": "minecraft:village"

Примеры допустимых значений:

• nova_structures:stray_fort — конкретная структура, добавленная модом
• minecraft:village_plains — конкретный вариант ванильной деревни (только равнины)
• minecraft:village — любой вариант деревни, определяется через тег структуры

Настройки поиска структур

Эти параметры управляют тем, как мод ищет и оценивает структуры-кандидаты. preferred_biomes (по умолчанию: forest, plains, meadow) Биомы, в которых структура ideally должна находиться. Используйте namespace:biome_id для конкретного биома или namespace:biome_tag для категории. Префикс # необязателен. Оставьте список пустым, чтобы принимать любой биом.

"preferred_biomes": ["minecraft:is_forest", "minecraft:plains", "minecraft:meadow"]

avoided_biomes (по умолчанию: badlands, beach, jungle, mountain, ocean, swamp) Биомы, которых следует избегать. Формат такой же, как у preferred_biomes.

"avoided_biomes": ["minecraft:is_ocean", "minecraft:is_badlands"]

min_preferred_area_percentage (по умолчанию: 60, диапазон: 0–100) Минимальная оценка качества для территории вокруг структуры (384×384 блока). Оценка основана на том, какая часть окружающей территории приходится на предпочитаемые или нейтральные биомы, при этом предпочитаемые биомы считаются вдвойне, а избегаемые сильно штрафуются. Установите 0, чтобы пропустить проверку территории и учитывать только биом, в котором находится сама структура. terrain_flatness_check_radius (по умолчанию: 48, диапазон: 0–128) Радиус в блоках для проверки ровности рельефа вокруг структуры. Мод измеряет разницу высот между самым высоким и самым низким поверхностным блоком на этой территории и отклоняет кандидатов, превышающих max_terrain_height_difference. Установите 0, чтобы отключить проверку рельефа. max_terrain_height_difference (по умолчанию: 16, диапазон: 0–100) Максимально допустимая разница высот в блоках в пределах радиуса проверки рельефа. 16 допускает пологие холмы; меньшие значения требуют более ровной земли. max_search_attempts (по умолчанию: 10, диапазон: 1–50) Сколько структур оценить, прежде чем сдаться и использовать лучшую из найденных. Каждая попытка занимает примерно 1–4 секунды в зависимости от типа структуры. Поиск идёт по спирали наружу от центра мира, так что увеличение этого значения охватывает большую территорию. Если поиск постоянно исчерпывает все попытки, увеличьте это значение или ослабьте ограничения по биомам/рельефу — команда статуса покажет, какие проверки чаще всего не проходят. Если идеальный кандидат не найден, структура, к которой мод откатится, будет максимально близка к идеалу по оценке биома самой структуры, процента окружающих биомов и проверок ровности.

Телепортация игроков и сообщения

Эти настройки управляют тем, как и когда телепортируются игроки, и какие сообщения они видят. teleport_creative_and_spectator (по умолчанию: true) Определяет, телепортируются ли игроки в режимах креатива или наблюдателя. Игрокам, которых не телепортируют, в чат отправится сообщение с командой телепортации, чтобы они при желании могли позже легко телепортироваться к структуре. teleport_delay_ticks (по умолчанию: 100) Сколько ждать перед телепортацией игрока после его входа или после того, как структура найдена, в тиках (20 тиков = 1 секунда). Во время задержки показывается предупреждение. Установите 0 для мгновенной телепортации без предупреждения. spawn_proximity_radius (по умолчанию: 128) Игроки, уже находящиеся в пределах этого количества блоков от структуры, пропускают телепортацию и вместо этого получают приветственное сообщение. Это покрывает частый случай, когда игрок естественным образом появляется на спавне мира после того, как структура уже найдена. kill_nearby_hostiles_radius (по умолчанию: 64)

Радиус в блоках вокруг структуры, в котором очищаются враждебные мобы, когда прибывает первый игрок. Мобы очищаются только один раз. Установите 0, чтобы отключить. send_popup_messages (по умолчанию: true) Включает или отключает все всплывающие сообщения. Отдельные сообщения также можно отключить, оставив их пустыми. send_chat_messages (по умолчанию: true) Включает или отключает все сообщения в чате. Отдельные сообщения также можно отключить, оставив их пустыми. structure_found_message (по умолчанию: "Structure found") Сообщение, показываемое игроку перед телепортацией. welcome_message (по умолчанию: "Welcome home.") Сообщение, показываемое после успешной телепортации. search_in_progress_title (по умолчанию: "Searching...") Сообщение, периодически показываемое игрокам, которые заходят, пока поиск ещё идёт. search_in_progress_subtitle (по умолчанию: "The server may be slow. Please wait.") Сообщение, показываемое вместе с search_in_progress_title. failure_message (по умолчанию: "No structure found.") Сообщение, показываемое игрокам, если поиск завершился, не найдя ни одного подходящего варианта. teleport_warning_message_override (по умолчанию: "") Переопределяет автоматическое сообщение обратного отсчёта "Teleporting in X seconds...". Полезно для перевода сообщения или изменения его формулировки. Оставьте пустым, чтобы использовать стандартный отсчёт. Если оставить любое поле сообщения пустым, это конкретное сообщение будет полностью отключено.

Пользовательские спавны мобов

Новая функция, добавленная в версии 1.2. Добавьте NBT-данные любому маркеру-сущности в вашей структуре спавна, чтобы заспавнить указанное количество сущностей этого типа. Мобы помечаются как постоянные при спавне, то есть они не исчезнут, даже если все игроки покинут область. Когда структура точки спавна будет найдена, в этой конкретной структуре заспавнятся нужные мобы. Пользовательские мобы не будут заспавнены ни в каких других структурах. Но если точка спавна структуры будет сброшена, мобы заспавнятся в новой структуре спавна. Эти мобы невосприимчивы к очистке враждебных мобов, которая происходит, когда первый игрок телепортируется к структуре спавна. Чтобы использовать эту функцию, вам нужен NBT-файл структуры, содержащий какие-либо сущности; размещение стоек для брони в вашей структуре в качестве маркеров-сущностей подойдёт идеально. Учтите, что маркер удаляется, когда он был прочитан модом. Когда сущности существуют, используйте NBT-редактор вроде NBTExplorer, чтобы открыть NBT-файл, найти маркер-сущность и добавить пользовательские NBT-данные точно в таком формате. Также рекомендуется установить существующий булев параметр Invisible в 1, чтобы маркеры не были видны в структуре, если этот мод в итоге их не удалит.

"custom_data":
{
    "StructureSpawnPoint":
    {
        "CustomSpawns":
        [
            {
                "EntityType": "minecraft:zombie",
                "Amount": 10
            },
            {
                "EntityType": "minecraft:skeleton",
                "Amount": 3
            }
        ]
    }
}

При добавлении этих NBTElements в NBT структуры: custom_data и StructureSpawnPoint — это Compounds. CustomSpawns — это List, содержащий Compounds. EntityType — это String, а Amount — это Int. Вот как может выглядеть корректная настройка NBT-тега: Известное ограничение: если точка спавна структуры сброшена на структуру, которая уже посещалась ранее, мобы могут не заспавниться. Если это произошло, вы можете снова сбросить точку спавна структуры и добавить текущую структуру в чёрный список с помощью команды "/structurespawnpoint reset blacklist".

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

Поиск намеренно выполняется в потоке сервера и будет вызывать лаги сервера, пока активен. Это ожидаемое поведение и оно временное. Каждый раз, когда сервер перегружен, поиск приостанавливается — это гарантирует, что сервер никогда не упадёт из-за лагов тиков. Игроки, заходящие во время поиска, информируются через сообщения search_in_progress_title и search_in_progress_subtitle. Сервер снова становится полностью отзывчивым, как только находится подходящее место.

Команды

Все команды требуют уровня оператора 2. /structurespawnpoint status Если поиск идёт, отобразит его статус. Когда поиск завершится, отобразит найденную позицию и ID структуры, а также диагностический отчёт с практическими предложениями, если поиск с трудом нашёл хорошее совпадение. /structurespawnpoint reset Очищает сохранённую точку спавна и запускает новый поиск. Все игроки онлайн получают уведомление и будут телепортированы, когда новое место будет найдено. Конфиг перезагружается при сбросе, так что изменения конфига вступают в силу без полного перезапуска сервера. /structurespawnpoint reset blacklist Добавляет текущую точку спавна в чёрный список, чтобы она гарантированно не была выбрана как точка спавна снова. Также запускает новый поиск.

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

• Моды, переделывающие генерацию мира (протестировано с Terralith) — полностью совместимо
• Моды, изменяющие размещение структур (протестировано с Improved Village Placement) — полностью совместимо
• Другие моды точек спавна — совместимо; Structure Spawn Point обычно переопределяет другие, так как его проверки валидации занимают больше времени, из-за чего он устанавливает спавн мира последним
• Моды повторов (протестировано с Flashback) — полностью совместимо; наблюдатели, заходящие во время повторов, не вызывают телепортацию
• Измерения Nether и End — не поддерживаются; мод ищет только в обычном мире

Примечания

• Мод можно добавлять и удалять в любое время. Он одинаково работает на новых и старых мирах; поиск местоположения структуры запустится при первом запуске сервера после добавления мода. При удалении мода останется лишь некоторое постоянное состояние; новые игроки будут заходить в новой структуре, так как она установлена как спавн мира. Повторное добавление мода позже не запустит поиск автоматически — используйте команду сброса, чтобы искать снова.

• Во время телепортации игроки могут на мгновение проваливаться сквозь мир, пока загружаются чанки места назначения. Это визуальный артефакт: клиент получает телепорт раньше, чем приходят данные чанков, и урона он не наносит.
• Подводные структуры поддерживаются, но игрок может появиться под водой.
• Подземные структуры поддерживаются, но игроков всё равно телепортирует на поверхность. Все проверки биомов также выполняются на уровне поверхности, поэтому определить правильные подземные биомы невозможно.
• Поиск выполняется только один раз. После сохранения точки появления она сохраняется между перезапусками сервера. Используйте /structurespawnpoint reset, чтобы запустить новый поиск.
• Игроки, которые мертвы в момент телепортации, будут телепортированы после возрождения.
• Поддерживаются как одиночная игра, так и выделенный сервер.

GitHub

https://github.com/AndartaMC/structure-spawn-point

Лицензия

MIT — можете свободно включать этот мод в модпаки.