Physics Activator (EN)

A server-side and client-side utility mod for Minecraft Fabric 1.20.1 that introduces block physics mechanics through specific items.

---

Key Features

1. Physics Activator (Base Item)

• Converts a targeted cluster of connected solid blocks into Falling Block entities upon interaction.
• Utilizes a Breadth-First Search (BFS) algorithm with a strict built-in limit of up to 200 blocks per execution to prevent server strain.
• The item can be repaired on an anvil using Netherite Ingots.

2. Glow Railgun

• An advanced ranged weapon that fires a linear kinetic beam up to a distance of 120 blocks.
• Triggers a physics-based structural collapse of up to 300 connected blocks at the impact point.
• Approximately 40% of the blocks in the immediate impact radius are removed with smoke particle indicators.
• Displays visual electric and portal particle trails along the shot trajectory.
• Features server-side anti-duplication logic that eliminates non-solid/fragile blocks (such as torches, doors, beds, and carpets) instead of converting them into falling entities.

---

Configuration & Performance Features

• Custom Configuration File: Generates an editable "physics_activator.json" file inside the /config directory. Allows modification of block limits, range, and explosion velocity variables for each item independently.
• Leaf Decay Suppression: Disables vanilla leaf decay math for physics-affected leaf entities in mid-air to stabilize frame rates.
• Network & Audio Optimization: Employs specific block update triggers (Block.NOTIFY_LISTENERS) to cull simultaneous audio events and avoid audio engine overload.
• Action Cooldowns: Implemented a mandatory 0.5-second (10 ticks) cooldown buffer on both items to prevent client-side action spam and packet flooding.
• Server Safety Mechanics: Safe handling for containers, inventories, and bedrock. Falling blocks automatically dissolve if dropped into the void below Y = -60.

---

Crafting Recipe (Glow Railgun)

• 1x Nether Star (Center-Bottom)
• 2x Netherite Blocks (Center-Left & Center-Right)
• 2x Redstone Blocks (Middle-Left & Middle-Right)
• 2x Diamonds (Top-Left & Top-Right)
• 1x Spyglass (Top-Center)

================================================================================

Physics Activator (RU)

Серверный и клиентский служебный мод для Minecraft Fabric 1.20.1, который добавляет механику физики блоков с помощью специализированных предметов.

---

Основные возможности

1. Активатор Физики (Базовый предмет)

• Превращает целевую группу соединённых твёрдых блоков в сущности Falling Block при взаимодействии.
• Использует оптимизированный алгоритм поиска в ширину (BFS) с жёстким встроенным лимитом до 200 блоков за одно использование для предотвращения нагрузки на сервер.
• Предмет можно чинить на наковальне с помощью Незеритовых слитков.

2. Грави-Рельсотрон

• Продвинутое дальнобойное оружие, выпускающее линейный кинетический луч на расстояние до 120 блоков.
• Вызывает физическое обрушение структуры объёмом до 300 соединённых блоков в точке попадания.
• Примерно 40% блоков в непосредственном радиусе удара удаляются с отображением дымовых частиц.
• Отображает визуальные следы электрических и портальных частиц вдоль траектории выстрела.
• Содержит серверную логику защиты от дюпа, которая бесшумно удаляет неполные/хрупкие блоки (такие как факелы, двери, кровати и ковры) вместо их превращения в падающие сущности.

---

Настройки и производительность

• Пользовательский файл конфигурации: Создаёт редактируемый файл "physics_activator.json" в папке /config. Позволяет независимо изменять лимиты блоков, дальность действия и скорость взрыва для каждого предмета.
• Подавление распада листвы: Отключает ванильные вычисления гниения листвы для падающих блоков листьев в воздухе для стабилизации частоты кадров (FPS).
• Сетевая и звуковая оптимизация: Использует специфические триггеры обновления блоков (Block.NOTIFY_LISTENERS) для сокращения одновременных звуковых событий и исключения перегрузки аудиодвижка.
• Задержка действий (Кулдаун): Введён обязательный кулдаун в 0,5 секунды (10 тиков) на оба предмета для предотвращения спама действиями со стороны клиента и флуда пакетами.
• Безопасность сервера: Корректная обработка контейнеров, инвентарей и коренной породы (бедрока). Падающие блоки автоматически удаляются при падении в пустоту ниже уровня Y = -60.

---

Рецепт крафта (Грави-Рельсотрон)

• 1x Звезда Незера (Снизу по центру)
• 2x Незеритовых блока (Слева и справа в среднем ряду)
• 2x Редстоун блока (Слева и справа в нижнем ряду)
• 2x Алмаза (Слева и справа в верхнем ряду)
• 1x Подзорная труба (Сверху по центру)