KawaMood's Waystones - путевые камни для телепортации

Если включить, игрокам придётся тратить уровни опыта на перемещение. Стоимость бывает фиксированной или рассчитывается по расстоянию между камнями:

/function pk_waystones:settings/xp_consumption/set {value:<число>, mode:<режим>}

Параметры:

• mode - "fixed", "manhattan" или "euclidean". Два последних - способы считать дистанцию.
  • "manhattan" считает по сетке мира: камень на координатах 0, 64, 0 и камень на 1000, 64, 1000 будут разделены 2000 блоками.
  • "euclidean" - дистанция напрямик, по вектору. В том же примере получится примерно 1414 блоков.
• value зависит от режима.
  • С "fixed" - просто количество уровней за любой телепорт.
  • С "euclidean" или "manhattan" - за сколько блоков пути снимать 1 уровень. Например, камни в 5000 блоках друг от друга при значении 1000 обойдутся в 5 уровней.
  • Значение 0 или меньше отключает настройку.

Пример - телепорт всегда стоит 5 уровней:

/function pk_waystones:settings/xp_consumption/set {mode:"fixed", value:5}

Пример - 1 уровень за 1000 блоков, расчёт по евклидовой дистанции:

/function pk_waystones:settings/xp_consumption/set {mode:"euclidean", value:1000}

Полное отключение:

/function pk_waystones:settings/xp_consumption/set {mode:"euclidean", value:0}

Узнать текущие значения:

/function pk_waystones:settings/xp_consumption/get

Практический совет: фиксированная стоимость в 1-3 уровня - золотая середина для сервера выживания. Телепорты перестают быть бесплатным читом, но и не бесят игроков.

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

/function pk_waystones:settings/blacklist_dimensions/add {dimension:<id_измерения>}
/function pk_waystones:settings/blacklist_dimensions/remove {dimension:<id_измерения>}
/function pk_waystones:settings/blacklist_dimensions/list

Пример - запретить установку камней в Незере:

/function pk_waystones:settings/blacklist_dimensions/add {dimension:"minecraft:the_nether"}

Подсказка: id текущего измерения видно на экране отладки (F3), слева под координатами.

Если включить, над камнями появятся парящие надписи с именами - ориентироваться на базе становится заметно проще.

/function pk_waystones:settings/display_nameplates/true
/function pk_waystones:settings/display_nameplates/false
/function pk_waystones:settings/display_nameplates/get

Если выключить, игроки не смогут телепортироваться, пока рядом с камнем бродят враждебные мобы. Логика та же, что у кроватей. По умолчанию настройка включена, то есть монстры игнорируются.

/function pk_waystones:settings/ignore_monsters/true
/function pk_waystones:settings/ignore_monsters/false
/function pk_waystones:settings/ignore_monsters/get

Для хардкорных серверов выключение этой опции добавляет перца - сбежать с фермы опыта посреди ночи уже не выйдет.

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

/function pk_waystones:settings/legacy_textures/true
/function pk_waystones:settings/legacy_textures/false
/function pk_waystones:settings/legacy_textures/get

Меняет режим видимости, который получает камень при установке. Изначально это "discoverable". Доступные значения: "discoverable", "private", "public":

/function pk_waystones:settings/default_visibility/set {visibility:<режим>}

Пример - все новые камни приватные по умолчанию:

/function pk_waystones:settings/default_visibility/set {visibility:"private"}

Узнать текущее значение:

/pk_waystones:settings/default_visibility/get

Аналогично - меняет стандартное состояние защиты. Изначально выключена.

Включить защиту по умолчанию:

/function pk_waystones:settings/default_protection/set {protection:"enabled"}

Выключить обратно:

/function pk_waystones:settings/default_protection/set {protection:"disabled"}

Узнать текущее состояние:

/pk_waystones:settings/default_protection/get

Можно ограничить, сколько камней максимум принадлежит одному игроку. Лимит индивидуальный: поставите 5 - каждый игрок сможет иметь по 5 камней.

/function pk_waystones:settings/limit_per_player/set {count:<число>}

Пример - максимум 5 камней на игрока:

/function pk_waystones:settings/limit_per_player/set {count:5}

Значение -1 или меньше снимает лимит:

/function pk_waystones:settings/limit_per_player/set {count:-1}

Узнать текущий лимит:

/function pk_waystones:settings/limit_per_player/get

Отдельно есть глобальный лимит на весь сервер - та же логика, но считаются все камни суммарно:

/function pk_waystones:settings/limit_per_server/set {count:<число>}
/function pk_waystones:settings/limit_per_server/set -1
/function pk_waystones:settings/limit_per_server/get

Оба лимита комбинируются: например, 3 камня на игрока и 100 на весь сервер. Для слабого железа и многолюдных серверов это ещё и защита от лишних энтити в прогруженных чанках.

Если включить, координаты камней в меню не увидит никто, кроме менеджеров. Хорошо заходит на серверах, где админы не хотят палить локации баз через GUI телепортов.

/function pk_waystones:settings/hide_coordinates/true
/function pk_waystones:settings/hide_coordinates/false
/function pk_waystones:settings/hide_coordinates/get

Есть и команда для обычных игроков - она скрывает координаты только для их персонажа. О ней ниже в разделе "Другие команды".

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

/function pk_waystones:settings/list_public_waystones_first/true
/function pk_waystones:settings/list_public_waystones_first/false
/function pk_waystones:settings/list_public_waystones_first/get

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

Проблема вот в чём: WorldGuard запоминает и возвращает последний блок, который игрок попытался поставить. Но камень успевает существовать один тик и дропнуться, пока плагин его отменяет - получается дюп. Задержка в 2 тика это решает. По умолчанию задержки нет.

/function pk_waystones:settings/lootable_delay/set {delay:<тики>}

Пример - задержка в 2 тика:

/function pk_waystones:settings/lootable_delay/set {delay:2}

Узнать текущее значение:

/function pk_waystones:settings/lootable_delay/get

Paper и похожие ядра иногда странно работают с контейнерами. Чтобы игроки не могли вытащить предметы из интерфейса камня и задюпать их, включите тиковую очистку:

/function pk_waystones:settings/tick_clear_gui_items/true
/function pk_waystones:settings/tick_clear_gui_items/false
/function pk_waystones:settings/tick_clear_gui_items/get

Если запускаете сервер Майнкрафт на Paper - просто включите эту опцию сразу и не думайте о ней больше.

Минимальная задержка перед срабатыванием события "открытие" камня. Введена как обход бага #13839 на Paper начиная с версии 26.1.2 build #17. На Paper-серверах датапак сам выставит значение 2 тика.

/function pk_waystones:settings/open_container_delay/set {value:<тики>}

Пример - задержка в 2 тика:

/function pk_waystones:settings/open_container_delay/set {value:2}

Узнать текущее значение:

/function pk_waystones:settings/open_container_delay/get

Позволяет запретить игрокам использовать конкретные режимы видимости. Менеджеры от этих ограничений не страдают. По умолчанию игрокам доступны все режимы.

Разрешить, запретить или проверить публичную видимость:

/function pk_waystones:settings/permissions/change/visibility/public/true
/function pk_waystones:settings/permissions/change/visibility/public/false
/function pk_waystones:settings/permissions/change/visibility/public/get

То же самое для приватной:

/function pk_waystones:settings/permissions/change/visibility/private/true
/function pk_waystones:settings/permissions/change/visibility/private/false
/function pk_waystones:settings/permissions/change/visibility/private/get

И для режима discover:

/function pk_waystones:settings/permissions/change/visibility/discover/true
/function pk_waystones:settings/permissions/change/visibility/discover/false
/function pk_waystones:settings/permissions/change/visibility/discover/get

Или управлять всеми сразу одной командой:

/function pk_waystones:settings/permissions/change/visibility/all/true
/function pk_waystones:settings/permissions/change/visibility/all/false
/function pk_waystones:settings/permissions/change/visibility/all/get

Запрещает игрокам менять защиту собственных камней. По умолчанию разрешено.

/function pk_waystones:settings/permissions/change/protection/true
/function pk_waystones:settings/permissions/change/protection/false
/function pk_waystones:settings/permissions/change/protection/get

Запрещает игрокам редактировать список доступа своих камней. По умолчанию разрешено.

/function pk_waystones:settings/permissions/change/shared_with/true
/function pk_waystones:settings/permissions/change/shared_with/false
/function pk_waystones:settings/permissions/change/shared_with/get

Если выключить, игроки будут видеть в меню только камни из своего текущего измерения. Полезно на серверах с Multiverse, где прыжки между мирами нежелательны. По умолчанию включено - телепортируйся куда хочешь.

/function pk_waystones:settings/permissions/tp/in_other_dimensions/true
/function pk_waystones:settings/permissions/tp/in_other_dimensions/false
/function pk_waystones:settings/permissions/tp/in_other_dimensions/get

Если выключить, игрок не сможет телепортироваться в течение 15 секунд после получения урона от живого существа. На PvP-серверах это прямо обязательная опция - иначе любой замес будет заканчиваться мгновенным сливом через камень. По умолчанию включено, то есть телепорт доступен всегда.

/function pk_waystones:settings/permissions/tp/in_fight/true
/function pk_waystones:settings/permissions/tp/in_fight/false
/function pk_waystones:settings/permissions/tp/in_fight/get

Если у вас есть права оператора или включены читы в одиночном мире:

/function pk_waystones:cmd/give/waystone/andesite
/function pk_waystones:cmd/give/waystone/sand
/function pk_waystones:cmd/give/waystone/deepslate
/function pk_waystones:cmd/give/waystone/nether
/function pk_waystones:cmd/give/waystone/mossy

Позволяет напрямую разместить камень с заданным набором атрибутов. Это находка для разработчиков датапаков - например, можно встроить генерацию вейстоунов в собственные структуры, как в оригинальном моде.

Функция принимает параметр waystone с данными камня. Все свойства можно опустить - они получат значения по умолчанию. Но есть два важных момента:

• Если не указать owner, камень будет "незанятым". Первый игрок, который им воспользуется, автоматически станет владельцем. Удобно для камней на спавне.
• Координаты берутся из контекста выполнения команды. Но: если не указать location > dimension, камень зарегистрируется в обычном мире. Динамически определить кастомное измерение, когда команду выполняет не игрок, игра не даёт.

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

Примеры:

Камень с настройками по умолчанию в текущей позиции:

/function pk_waystones:cmd/setblock/waystone {waystone:{}}

Незанятый сланцевый камень в текущей позиции:

/function pk_waystones:cmd/setblock/waystone {waystone:{variant:"deepslate"}}

Незанятый, защищённый, публичный камень на координатах 0 80 0 в Энде:

/execute in minecraft:the_end positioned 0 80 0 run forceload add ~ ~
/execute in minecraft:the_end positioned 0 80 0 run function pk_waystones:cmd/setblock/waystone {waystone:{location:{dimension:"minecraft:the_end"},protected:true,visibility:"public"}}
/execute in minecraft:the_end positioned 0 80 0 run forceload remove ~ ~

Структура данных параметра waystone:

waystone (compound)
├─ id (int): id камня
├─ variant (string): вариант (regular, sand, deepslate, nether...)
├─ name (text component): имя камня
├─ owner (массив из 4 int): UUID владельца
├─ location (compound): расположение камня
│  └─ dimension (string): id измерения, по умолчанию "minecraft:overworld"
├─ discovered_by (array): список игроков, взаимодействовавших с камнем
│  └─ (compound)
│     └─ uuid (массив из 4 int): UUID игрока
├─ shared_with (array): игроки, с которыми поделились камнем
│  └─ (compound)
│     ├─ uuid (массив из 4 int): UUID игрока
│     └─ name (string): имя, если игрока ещё нет в базе
├─ protected (boolean): защищён ли камень (true/false)
├─ visibility (string): "public", "private" или "discover"
└─ render_item (compound):
   └─ id (string): id предмета-иконки камня в списке
   └─ tag (compound) [1.20.4 и ниже]: дополнительные теги предмета
   └─ components (compound) [1.20.5 и выше]: компоненты предмета