Описание
**ParticleCrashDefender** 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:
- 📦 **Per-packet limit** - drops packets with unrealistic particle counts
- ⏱ **Packet rate limit** - 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)
- **ModMenu** - 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.
---
# 🇷🇺 Русское описание
**ParticleCrashDefender** - это лёгкий **клиентский мод для Fabric**, который защищает вашу игру от фризов, лагов и вылетов, вызванных спамом частиц со стороны сервера.
В обычном Minecraft клиент пытается обработать каждый полученный пакет частиц. Если сервер отправляет огромное количество частиц - намеренно или случайно - игра может начать сильно лагать, зависнуть или даже вылететь из-за переполнения памяти.
ParticleCrushDefender предотвращает это, фильтруя опасные пакеты частиц ещё до того, как Minecraft начнёт их обрабатывать.
---
## ✨ Возможности
- 🛡️ **Защита от спама частицами**
Блокирует вредоносные команды `/particle`, которые могут вызвать фриз или вылет игры.
- ⚡ **Ранняя фильтрация пакетов**
Опасные пакеты частиц блокируются до их обработки клиентом.
- 🎯 **Сбалансированные ограничения**
Обычные эффекты - зелья, фейерверки и стандартные команды - продолжают работать нормально.
- ⚙ **Настраиваемая защита**
Лимиты можно изменять прямо в меню настроек игры.
- 📝 **Логирование для отладки**
При желании мод может записывать заблокированные пакеты в лог.
---
## 🔍 Как это работает
Мод перехватывает входящие пакеты частиц и применяет три уровня защиты:
- 📦 **Ограничение на пакет** - блокирует пакеты с нереалистичным количеством частиц
- ⏱ **Ограничение частоты пакетов** - ограничивает количество пакетов частиц в секунду
- 📊 **Общий лимит частиц** - ограничивает суммарное количество создаваемых частиц в секунду
Это позволяет сохранять нормальные визуальные эффекты игры, одновременно защищая клиент от перегрузки.
---
## 📦 Зависимости
### Обязательные
- **Fabric API**
### Опциональные (рекомендуется)
- **ModMenu** - добавляет кнопку настроек в меню модов
- **Cloth Config API** - обеспечивает интерфейс настройки
При установке ModMenu и Cloth Config вы сможете изменять все лимиты защиты прямо в игре.
---
## 💻 Только клиент
Этот мод устанавливается **только на клиент** и работает на любых серверах.