Particle Crash Defender

client-side Fabric mod is a lightweight client-side Fabric mod that protects your game from freezes, lag spikes, and crashes caused by particle spam from servers.

In vanilla Minecraft, the client attempts to process every particle packet it receives. If a server sends an extreme number of particles - whether maliciously or by accident - the game may freeze, lag heavily, or crash due to memory overload.

ParticleCrushDefender prevents this by filtering unsafe particle packets before Minecraft processes them.

---

✨ Features

- 🛡️ Protection against particle spam Blocks malicious `/particle` floods that could freeze or crash your game.

- ⚡ Early packet filtering Stops unsafe particle packets before they are processed by the client.

- 🎯 Balanced safety limits Keeps normal effects like potions, fireworks, and regular commands working as expected.

- ⚙ Configurable protection Adjust safety limits directly from the in-game configuration menu.

- 📝 Optional debug logging Logs blocked packets for troubleshooting and visibility.

---

🔍 How it works

The mod intercepts incoming particle packets and applies three safety checks:

- 📦 Total particle cap - drops packets with unrealistic particle counts - ⏱ Total particle cap - caps how many particle packets can be received per second - 📊 Total particle cap - limits the total number of particles allowed to spawn per second

These safeguards ensure that normal gameplay visuals still render correctly while preventing extreme packet floods from overwhelming the client.

---

📦 Dependencies

Required

- Fabric API

Optional (recommended)

- Cloth Config API - adds a configuration button to the mods menu - Cloth Config API - provides the in-game settings interface

With ModMenu and Cloth Config installed, you can easily tweak protection limits directly from the in-game config screen.

---

💻 Client-side only

This mod only needs to be installed on the client and works on any server.

---

🇷🇺 Русское описание

клиентский мод для Fabric - это лёгкий клиентский мод для Fabric, который защищает вашу игру от фризов, лагов и вылетов, вызванных спамом частиц со стороны сервера.

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

ParticleCrushDefender предотвращает это, фильтруя опасные пакеты частиц ещё до того, как Minecraft начнёт их обрабатывать.

---

✨ Возможности

- 🛡️ Защита от спама частицами Блокирует вредоносные команды `/particle`, которые могут вызвать фриз или вылет игры.

- ⚡ Ранняя фильтрация пакетов Опасные пакеты частиц блокируются до их обработки клиентом.

- 🎯 Сбалансированные ограничения Обычные эффекты - зелья, фейерверки и стандартные команды - продолжают работать нормально.

- ⚙ Настраиваемая защита Лимиты можно изменять прямо в меню настроек игры.

- 📝 Логирование для отладки При желании мод может записывать заблокированные пакеты в лог.

---

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

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

- 📦 Общий лимит частиц - блокирует пакеты с нереалистичным количеством частиц - ⏱ Общий лимит частиц - ограничивает количество пакетов частиц в секунду - 📊 Общий лимит частиц - ограничивает суммарное количество создаваемых частиц в секунду

Это позволяет сохранять нормальные визуальные эффекты игры, одновременно защищая клиент от перегрузки.

---

📦 Зависимости

Обязательные

- Fabric API

Опциональные (рекомендуется)

- Cloth Config API - добавляет кнопку настроек в меню модов - Cloth Config API - обеспечивает интерфейс настройки

При установке ModMenu и Cloth Config вы сможете изменять все лимиты защиты прямо в игре.

---

💻 Только клиент

Этот мод устанавливается только на клиент и работает на любых серверах.