WorldCannon Configuration

WorldCannon использует один глобальный конфигурационный файл и один конфигурационный файл для каждой пушки.

File Layout

• Глобальный конфиг: plugins/FunRTP/config.yml
• Конфиги отдельных пушек: plugins/FunRTP/custom/fun_rtps/<id>.yml

Плагин также поставляется с примером пакета пушки под названием example_world_cannon. По умолчанию он отключен.

Global Config Structure

Основной конфиг организован по разделам:

• runtime.*
• landing.*
• messages.*
• protection.*

Runtime Settings

Key	Default	Behavior
runtime.scanIntervalTicks	10	Как часто пушки проверяют ближайших игроков
runtime.particleIntervalTicks	15	Как часто отображаются частицы у неактивной пушки

Landing Search Settings

Key	Default	Behavior
landing.searchAttemptsPerTick	2	Попытки поиска на пушку за тик во время предзагрузки
landing.preloadedLocationsPerCannon	5	Сколько безопасных точек назначения плагин старается держать в очереди
landing.searchTimeoutSeconds	1000	Время до того, как пушка с продолжающимся поиском будет помечена как exhausted
landing.slowFallingSeconds	60	Длительность Slow Falling после прибытия (эффект снимается досрочно, когда игрок приземляется)
landing.failOpenOnProtectionErrors	false	Если API защиты дает ошибку, приземление по умолчанию блокируется

Landing Sounds

Следующие sound keys можно настраивать:

• landing.sounds.levitationStart.sound
• landing.sounds.levitationStart.volume
• landing.sounds.levitationStart.pitch
• landing.sounds.blastOff.sound
• landing.sounds.blastOff.volume
• landing.sounds.blastOff.pitch

Звуки по умолчанию: BLOCK_BEACON_ACTIVATE для подготовки и ENTITY_GENERIC_EXPLODE для взлета.

Unsafe Material Lists

WorldCannon отклоняет кандидаты на точку приземления на основе двух списков материалов:

• landing.unsafeGroundMaterials
• landing.unsafeBodyMaterials

Материалы земли, считающиеся опасными по умолчанию:

• LAVA
• MAGMA_BLOCK
• CAMPFIRE
• SOUL_CAMPFIRE
• CACTUS
• POWDER_SNOW

Материалы в пространстве тела, считающиеся опасными по умолчанию:

• LAVA
• WATER
• FIRE
• SOUL_FIRE
• SWEET_BERRY_BUSH
• POWDER_SNOW
• COBWEB

Message Settings

Плагин предоставляет message keys и title keys в разделах:

• messages.prefix
• messages.helpHeader
• messages.createdCannon
• messages.deletedCannon
• messages.movedCannon
• messages.targetWorldUpdated
• messages.searchCenterUpdated
• messages.reload
• messages.noPermission
• messages.cannonDisabled
• messages.queueCalibration
• messages.noValidLocationYet
• messages.noValidLocationFound
• messages.invalidConfiguration
• messages.statusLine
• messages.probeAllowed
• messages.probeBlocked
• messages.unknownCommand
• messages.titles.launchQueuedTitle
• messages.titles.launchQueuedSubtitle
• messages.titles.destinationPreviewTitle
• messages.titles.destinationPreviewSubtitle
• messages.titles.destinationConfirmedTitle
• messages.titles.destinationConfirmedSubtitle
• messages.titles.arrivalSubtitles

Ключи title управляют автоматическими сообщениями при запуске и прибытии. arrivalSubtitles — это список; плагин случайным образом выбирает одну строку при каждом запуске. В текущей реализации нет ручного окна подтверждения.

Per-Cannon Config Fields

Каждый файл пушки хранит следующие поля:

Field	Default	Notes
isEnabled	true для только что созданных пушек	Отключенные пушки не срабатывают
displayName	Санитизированный id, где underscores заменены пробелами	Используется в сообщениях и выводе статуса
cannonLocation	Обязательно	Где находится триггер пушки
targetWorld	Текущий мир на момент создания	Должен быть загружен во время runtime
searchCenter	Спавн текущего мира на момент создания	Если позже не задан, плагин использует спавн целевого мира
triggerRadius	1.75	Радиус для обнаружения ближайших игроков
minSearchRadius	500	Минимальная дистанция поиска от search center
maxSearchRadius	5000	Максимальная дистанция поиска от search center
launchWarmupSeconds	6	Время levitation/countdown перед запуском
verticalBoostTicks	45	Количество тиков вертикального ускорения до телепорта
verticalBoostVelocity	1.35	Вертикальная скорость, применяемая во время запуска
enableParticles	true	Управляет частицами неактивной пушки
requiredPermission	пусто	Дополнительная необязательная проверка прав для этой пушки

Cannon Creation Defaults

Когда вы выполняете /wc create:

• id пушки переводится в lowercase, а символы, отличные от a-z, 0-9, _ и -, заменяются на _
• display name по умолчанию становится санитизированным id с underscores, преобразованными в пробелы
• cannonLocation устанавливается в вашу текущую точку
• targetWorld устанавливается в ваш текущий мир
• searchCenter устанавливается в спавн этого мира

Runtime Validation Behavior

WorldCannon отклоняет кандидаты на точку приземления, если не проходит любая из этих проверок:

• целевой мир не загружен
• search center недействителен
• случайная точка оказывается за границей мира
• не удается найти безопасную твердую поверхность
• пространство для ног или головы заблокировано
• блоки поверхности или пространства тела совпадают с настроенными списками опасных материалов
• интеграция защиты блокирует приземление

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