Description / Описание

EN:

Perimeter — is an addon that adds a tactical radar to the game, allowing you to equip standard drones from the Superb Warfare mod with advanced artificial intelligence. But that's only half of it. With the latest update, Perimeter also brings a full-featured network mode in the spirit of Battlefield: capture points A/B/C, match rounds with a timer, a Battlefield-style spawn screen, team pings and live drone cameras on the radar.

Requires Minecraft 1.21.1 / NeoForge, Superb Warfare and GeckoLib installed on the server and all clients (same version).

Swarm Control (Drone Binding)

You can create your own battle swarm of up to 16 drones per player (configurable — maxSwarmSize). Add a drone to the swarm: Take the tracking device in your hand, go to the installed drone and press Shift + RMB (right mouse button). Remove the drone from the swarm: Repeat the same procedure (Shift + RMB with the device in hand), and the drone will be excluded from the list. Swarm summary: Press Shift + RMB into the air to get a brief swarm report in the chat.

The drone remains a native Superb Warfare entity: health, sounds and vulnerability to weapons are unchanged. A drone linked to a monitor cannot be recruited — manual control is never broken. Swarm membership is stored on the drone itself and survives chunk unloading and server restarts.

How to open and use the radar

To access the radar interface, you don't have to hold the device in your hands — just have it in your inventory. To open the radar: Press the X key on your keyboard (or press RMB while holding the device in your hand).

Interface features:

The radar screen is a monochrome green heightmap of the patrol area with a grid, sweep, scanlines and ASCII frames. It allows you to track positions of your drones, detected enemies, allies and capture zones in real time. Green dots: Your swarm drones. Red dot: The target in real time while there is visual contact. Yellow dot: The last known coordinates of a lost target during the 40-second search. Capture zones: Shown on the map with color fill — blue (yours), red (enemy), grey (neutral).

Radar map management:

LMB drag on the map: Define the patrol zone for your swarm ("WATCH HERE"). RMB + Drag: Move the map.

Mouse wheel / + -: Zoom in and out. Middle mouse click (MMB): Send a ping to your team — an orange "!" with your name appears for allies for 10 seconds with a soft sound (1 ping per second anti-spam). "Return Units" button: Orders the drones to fly to you immediately. Pressing it again resumes patrol. "Drone Cameras" button: Opens a live feed from a drone — no HUD, no hand, with analog noise. Switch between drones with < > or arrow keys. Signal cuts out beyond 128 blocks. Pencil tool (right side of map): Draw annotations visible only to your side — three colors (red / yellow / blue), eraser, clear all. Sound button (♪ / ∅): Toggle ping sounds on/off.

Live data is transmitted only while the radar screen is open, so the addon is easy on server performance.

Swarm AI

The drones are no longer just static turrets — each one is controlled by its own flight brain, and the whole swarm acts as a single organism. Patrolling: Drones pick random points within the patrol radius (default 160 blocks) and fly 6–20 blocks above the terrain. Shared target: The target is common for the entire swarm — as soon as one drone establishes visual contact, all drones know the coordinates. 80% of the swarm moves to engage, 20% continues patrolling. Shadowing: Drones circle around the target in orbital slots and never come closer than 5 blocks. Losing contact: The drones fly to the last known coordinates and sweep a 24-block radius. After 40 seconds without contact they forget the target and return to patrol. Smart building flight: In buildings and skyscrapers the swarm switches to indoor mode — real raycast altitudes instead of heightmap, lowering, wall-hugging and self-recovery from traps. Obstacle avoidance: Drones steer around terrain, gain altitude and push each other apart to prevent collisions. Dodging: When a projectile is flying at a drone, it has a chance to make a sharp strafe perpendicular to the trajectory (configurable — dodgeChance).

Detection and notification system

Drones actively conduct reconnaissance and transmit tactical data to both sides:

For the owner of the swarm:

When a drone spots an opponent, a [ ! ] CONTACT indicator appears in the top-right corner of the screen and a red dot appears on the radar map. When the target is lost and the search begins, the indicator changes to [ ? ] SEARCH. For the target ("victim"): A player who has been spotted by a drone sees a blinking red ASCII indicator <[O]> in the top-right corner, signaling they have been detected.

Losing the target and avoiding the chase:

If the "victim" escapes from sight, a yellow marker appears on the radar map marking their last known location. The "victim's" indicator <[O]> turns yellow, a melting bar |||||||||| and a 40-second timer appear. If the drones do not reacquire the player within 40 seconds, the swarm completely forgets them — the indicator turns green for 10 seconds and disappears, meaning the chase is over.

Capture Points

Perimeter adds tactical capture points A/B/C in the spirit of Battlefield — stand inside a zone to capture it, hold the most zones to win the round. The zone is a cylinder that spans the full world height. Both sides inside simultaneously — CONTESTED, progress freezes. Everyone leaves — progress rolls back. Zone colors: blue (yours), red (enemy's), grey (neutral) — each player sees colors from their own perspective. In the world: a dotted ring along the terrain, a light pillar and a letter above the flag mark each point. Active captures are shown at the top of the screen as HUD badges — a ring filling clockwise in the attacker's color.

Capture point commands (operator permission level 2):

/flag set A — Place point A at your location (default radius 24, capture time 60 s). /flag set A <radius> <seconds> — Custom radius (8–128) and capture time (5–3600 s). /flag remove A — Remove a point. /flag reset — Reset all points to neutral (flags stay in place). /flag list — List all active points. /flag zonespawn on|off — Enable the Battlefield-style spawn screen on death.

Spawn Screen

When /flag zonespawn is enabled, dying players launch into a top-down view above their owned zones and choose where to drop. A 10-second respawn timer counts down — you cannot land before it expires (enforced server-side). RMB drag: Pan the camera over the map. Letter buttons at the bottom: Instantly fly the camera to that point. Click a zone marker: Spawn at a random spot within that zone. No choice within 40 seconds — automatic spawn. No owned zones — standard respawn.

Rounds

Start a timed match with a boss-bar countdown visible to all players. /round time <minutes> — Set match duration (default 15). /round start — Start the match. The boss-bar counts down; the last minute turns red. /round stop — Cancel without a verdict (zones are untouched). /round end — Force an immediate verdict. The side holding the most points wins: a full-screen title, score in chat and fanfare. After the verdict, all points automatically reset — the field is ready for the next round.

Playing with friends:

The addon reads all players without exception as an enemy. If you want to play team vs. team and not have your drones targeting your teammates, create scoreboard teams with the vanilla command /team add <name> and join them with /team join <name>. The addon separates "friends and foes" when players are assigned to teams.

RU:

Perimeter — это аддон, который добавляет в игру тактический радар, позволяющий наделить стандартных дронов из мода Superb Warfare продвинутым искусственным интеллектом. Но это лишь половина. В новом обновлении Perimeter также добавляет полноценный сетевой режим в духе Battlefield: точки захвата A/B/C, раунды с таймером, экран высадки в стиле Battlefield, командные пинги и живые трансляции с камер дронов на радаре.

Требуется Minecraft 1.21.1 / NeoForge, Superb Warfare и GeckoLib — установить на сервере и на всех клиентах (одинаковой версии).

Управление роем (Привязка дронов)

Вы можете создать собственный боевой рой до 16 дронов на одного игрока (настраивается — maxSwarmSize). Добавить дрон в рой: Возьмите прибор слежения в руку, подойдите к установленному дрону и нажмите Shift + ПКМ (правая кнопка мыши). Удалить дрон из роя: Повторите ту же процедуру (Shift + ПКМ с прибором в руке), и дрон исключится из списка. Сводка по рою: Нажмите Shift + ПКМ в воздух, чтобы получить краткий отчёт о рое в чат.

Дрон остаётся родной сущностью Superb Warfare: здоровье, звуки и уязвимость к оружию не изменяются. Привязанный к монитору дрон завербовать нельзя — ручное управление никогда не ломается. Членство в рое хранится на самом дроне и переживает выгрузку чанков и рестарт сервера.

Как открыть и использовать радар

Чтобы получить доступ к интерфейсу радара, необязательно держать прибор в руках — достаточно просто иметь его в инвентаре. Открыть радар: Нажмите клавишу X на клавиатуре (или нажмите ПКМ, держа прибор в руке).

Возможности интерфейса:

Экран радара — это монохромная зелёная карта высот зоны патрулирования с сеткой, развёрткой, сканлайнами и ASCII-рамками. Она позволяет в реальном времени отслеживать позиции ваших дронов, обнаруженных врагов, союзников и зон захвата. Зелёные точки: Дроны вашего роя. Красная точка: Цель в реальном времени, пока есть визуальный контакт. Жёлтая точка: Последние известные координаты потерянной цели во время 40-секундного поиска. Зоны захвата: Отображаются на карте с цветной заливкой — синяя (ваша), красная (вражеская), серая (нейтральная).

Управление картой радара:

ЛКМ-рамка по карте: Определить зону патрулирования роя («СЛЕДИТЬ ЗДЕСЬ»). ПКМ + перетаскивание: Перемещение карты.

Колёсико мыши / + -: Приближение и отдаление (зум). СКМ (клик колесом): Отправить пинг команде — у союзников появляется оранжевый «!» с вашим ником на 10 секунд с тихим звоном (антиспам 1 раз в секунду). Кнопка «Камеры дронов»: Открывает живой эфир с дрона — без HUD и руки, с шумом аналогового сигнала. Переключение между дронами кнопками < > или стрелками. Сигнал пропадает дальше 128 блоков. Инструмент «Карандаш» (справа от карты): Рисовать аннотации, видимые только вашей стороне — три цвета (красный / жёлтый / синий), ластик, стереть всё. Кнопка звука (♪ / ∅): Включить/выключить звук пингов.

Живые данные передаются только пока экран радара открыт, поэтому аддон почти не нагружает сервер.

Роевой ИИ

Дроны больше не просто статичные турели — каждым управляет собственный полётный мозг, а весь рой действует как единый организм. Патрулирование: Дроны выбирают случайные точки в радиусе патрулирования (по умолчанию 160 блоков) и летают в коридоре 6–20 блоков над рельефом. Общая цель: Таргет общий на весь рой — как только один дрон установил визуальный контакт, координаты мгновенно известны всем. При этом 80% роя идёт на контакт, а 20% продолжает патрулировать. Слежка: Дроны кружат вокруг цели по орбитальным слотам и никогда не подлетают ближе 5 блоков. Потеря контакта: Дроны летят к последним известным координатам и прочёсывают радиус 24 блока. Через 40 секунд без контакта — сброс цели и возврат к патрулированию. Умный полёт в зданиях: В постройках и небоскрёбах рой переключается в режим помещений — реальные raycast-высоты вместо карты высот, снижение, движение вдоль стен и выход из ловушек. Огибание препятствий: Дроны облетают рельеф и постройки, набирают высоту и расталкивают друг друга, чтобы рой не сталкивался. Уклонение: Когда в дрона летит снаряд, у него есть шанс сделать резкий стрейф перпендикулярно траектории (настраивается — dodgeChance).

Система обнаружения и оповещений

Дроны активно ведут разведку и передают тактические данные обеим сторонам:

Для владельца роя:

Когда дрон замечает противника, в правом верхнем углу экрана появляется индикатор [ ! ] CONTACT, а на карте радара — красная точка. Когда цель потеряна и начался поиск, индикатор меняется на [ ? ] SEARCH. Для цели («жертвы»): Игрок, которого засек дрон, видит мигающий красный ASCII-индикатор <[O]> в правом верхнем углу, сигнализирующий об обнаружении.

Потеря цели и уход от погони:

Если «жертве» удалось скрыться из виду, на карте радара появляется жёлтый маркер с последним известным местоположением. Индикатор <[O]> у «жертвы» становится жёлтым, появляется тающая полоса |||||||||| и 40-секундный таймер. Если за эти 40 секунд дроны снова не обнаружат игрока, рой его полностью «забудет» — индикатор станет зелёным на 10 секунд и исчезнет, а значит, погоня окончена.

Точки захвата

Perimeter добавляет тактические точки захвата A/B/C в духе Battlefield — стойте внутри зоны, чтобы захватить её, удерживайте больше точек — победите в раунде. Зона — цилиндр на всю высоту мира. Обе стороны внутри одновременно — CONTESTED, прогресс замирает. Все ушли — прогресс откатывается. Цвета зон: синий (ваша), красный (вражеская), серый (нейтральная) — каждый игрок видит цвета со своей стороны. В мире: пунктирное кольцо по рельефу, световой столб и буква над флагом обозначают каждую точку. Идущие захваты отображаются вверху экрана в виде HUD-бейджей — кольцо заполняется по часовой стрелке цветом захватчика.

Команды для точек захвата (уровень оператора 2):

/flag set A — Поставить точку A на месте игрока (радиус 24, захват 60 с). /flag set A <радиус> <секунды> — Произвольный радиус (8–128) и время захвата (5–3600 с). /flag remove A — Убрать точку. /flag reset — Сбросить все точки до нейтральных (сами флаги остаются). /flag list — Список всех активных точек. /flag zonespawn on|off — Включить экран высадки в стиле Battlefield при смерти.

Экран высадки

При включённом /flag zonespawn после смерти игрок взлетает над своими зонами и выбирает, где приземлиться. 10-секундный таймер возрождения — высадиться раньше нельзя (проверяет сервер). ПКМ + перетаскивание: Панорамирование камеры над картой. Кнопки-буквы внизу: Мгновенный перелёт камеры к нужной точке. Клик по маркеру зоны: Высадка в случайное место этой зоны. Не выбрали за 40 секунд — принудительная высадка. Нет своих точек — обычное возрождение.

Раунды

Запустите матч с отсчётом в босс-баре, видным всем игрокам. /round time <минуты> — Установить продолжительность матча (по умолчанию 15). /round start — Запустить матч. Босс-бар отсчитывает время; последняя минута становится красной. /round stop — Отменить без вердикта (точки не трогаются). /round end — Немедленный вердикт. Побеждает сторона с наибольшим числом точек: титул на весь экран, счёт в чат и фанфары. После вердикта все точки автоматически сбрасываются — поле готово к новому раунду.

Игра с друзьями:

Аддон считывает всех игроков без исключения как врага. Если вы хотите поиграть команду на команду и чтобы ваши дроны не следили за тимейтами, нужно создать разные команды через ванильную команду /team add <название> и потом зайти в неё /team join <название>. Аддон позволяет разделять «своих и чужих», если игроки распределены по командам.

WARNING / Внимание

RU:

Для оптимизации мод делает "скриншот" местности ландшафта (карта высот) всего один раз при открытии радара. Поэтому если ландшафт изменился во время того как был открыт радар то ландшафт на радаре не поменяется и его нужно закрыть и открыть заново.
Аддон не работает без оригинального мода Superb Warfare и библиотек Curios API и Geckolib

Ссылки на нужные моды:

SB - https://modrinth.com/mod/superb-warfare

Geckolib - https://modrinth.com/mod/geckolib

Curios API - https://modrinth.com/mod/curios

EN:

For optimization, the mod takes a "screenshot" of the terrain (elevation map) only once when opening the radar. Therefore, if the landscape has changed while the radar was opened, then the landscape on the radar will not change and it needs to be closed and reopened.
The addon does not work without international assistance from Superb Warfare, Curios API & Geckolib biotechnology

Links to the required mods:

SW - https://modrinth.com/mod/superb-warfare