🔴 RedstoneDetector — Minecraft 自动红石卡顿机器防御 ⚡🛡️

在玩家开始抱怨 TPS（每秒刻数）之前，发现并阻止红石卡顿机器。RedstoneDetector 测量每个区块的真实成本，命名所发现的机器，并能自动暂停肇事机制——同时服务器的其余部分保持正常运行。

不再需要带着 /tp 满地图飞并猜测是哪座农场在吞噬你的刻。插件会告诉你世界、区块、方块类型、每秒更新次数和预估的 MSPT（每刻毫秒数）——并为你冻结它。

💡 1.2.0 版本的核心理念

冻结不再是“取消事件并听天由命”。被冻结的机制是真正被暂停的，因此 CPU 成本会实际下降，而不是保持不变。

向下滚动查看俄语版本 / Прокрутите вниз для русской версии 🇷🇺

🚀 为什么选择 RedstoneDetector？

🔍 真实成本检测 — 区块按测量的影响（MSPT 贡献）排名，而不仅仅是按方块数量
🧊 真正的自动冻结 — 暂停红石、活塞、漏斗、观察者、比较器、幽匿感测体和活板门，而不仅仅是取消事件
🤖 自动停止卡顿机器 — 持续产生极端活动的区块会被自动冻结，随后自动释放
🐛 专用幽匿感测体探测器 — 振动循环、过度激活、同步感测体组和重复爆发
🚪 专用活板门探测器 — 快速开/关循环、集群和红石驱动的垃圾信息
🌐 全局冻结 — 一键停止服务器上所有红石活动，一键恢复
🧠 智能冻结 — 仅冻结有问题的区块，因此玩家正常的农场继续工作
📊 实时 GUI 仪表盘 — 每秒自动刷新，无需手动刷新按钮，无菜单闪烁
🔎 通过聊天搜索区块 — 输入区块或方块坐标，直接跳转到报告
🧾 冻结日志 — 记录开始时间、结束时间、被暂停的方块和预估的改善效果
🌍 13 种内置语言 — 支持按每位玩家的客户端语言自动检测
🧩 两个平台 — Bukkit/Spigot/Paper/Purpur/Folia 以及原生 Sponge 构建版

🧊 冻结系统

🤖 自动停止

当服务器确实出现卡顿且某个区块连续几秒保持高成本时，该区块会自动冻结
极度活跃的区块无论 TPS 如何都会被冻结（auto-freeze-updates-per-second，默认 800）
幽匿和活板门卡顿机器由其各自的探测器冻结，可以是单个区块或其周围可配置的半径
冻结的区块会在 auto-unfreeze-seconds（默认 60）后自动释放，以便重新评估
暂停和恢复是按刻预算分配的，因此冻结大型农场永远不会导致刻本身出现峰值
幽匿感测体、校准感测体和尖啸者在释放时会恢复到干净的默认状态，以便之后正常工作

🌐 全局冻结

一次性停止所有世界中的红石活动
在服务器负载下仍能工作 — 检测、排名和执行继续运行
完全可逆：全部恢复 可还原每个被暂停的机制

✋ 手动控制

从 GUI 或聊天中冻结/解冻单个区块
移除红石方块并提供恢复选项
移除区块内的非玩家实体
忘记一个区块，使其停止被追踪

📊 实时仪表盘与 GUI

服务器状态 — TPS、MSPT、可疑区块、冻结区块、全局冻结状态、上次扫描
每秒活动 — 红石、活塞、漏斗、观察者、比较器、幽匿感测体、活板门、计划更新、实体、方块实体、卡顿评分
活跃检测 — 活跃冻结、幽匿监控、活板门监控、暂停的区块
区块列表 — 可按服务器成本、每秒更新、机制或实体排序，具备有效的分页功能
区块屏幕 — 世界、坐标、组件数量、活动、影响、探测器名称、机器类型、被暂停的方块、区块 MSPT 与服务器 MSPT 对比
快速操作 — 传送、冻结/解冻、停止/恢复、移除红石、移除实体、忘记
自动刷新 — 打开的屏幕每秒更新而不重建库存，因此你的光标永远不会跳动

识别的机器类型：飞行机器、观察者时钟、活塞时钟、红石时钟、快速更新机器、无限更新循环、幽匿卡顿机器、活板门卡顿机器、物品运输机器。

⚡ 平台与版本支持

平台	状态
Bukkit / Spigot	✅ 支持
Paper / Purpur	✅ 支持
Mohist / Arclight (混合端)	✅ 支持
Folia	✅ 支持（区域感知调度）
Sponge / SpongeVanilla	✅ 独立原生构建版

Minecraft 版本： 1.16.1 – 最新版

Java： Bukkit 构建版需 11+，Sponge 构建版需 21+

依赖项： 无需任何依赖

📋 命令

主命令：/redstonedetector，别名 /rd, /reddetect。

命令	描述	权限
`/rd gui`	打开实时仪表盘	`redstonedetector.gui`
`/rd status`	服务器状态：TPS、可疑和冻结的区块	`redstonedetector.gui`
`/rd info [world x z]`	区块完整报告（默认为你所在的区块）	`redstonedetector.gui`
`/rd list` (`/rd top`)	当前最重的区块	`redstonedetector.gui`
`/rd search <x> <z>`	通过区块或方块坐标查找区块	`redstonedetector.gui`
`/rd scan`	开始全面扫描	`redstonedetector.scan`
`/rd scan cancel`	取消正在运行的扫描	`redstonedetector.scan`
`/rd freeze [world x z]`	全局或在单个区块中冻结红石	`redstonedetector.freeze`
`/rd unfreeze [world x z]`	解除冻结	`redstonedetector.freeze`
`/rd stop [world x z]`	暂停机制而不破坏方块	`redstonedetector.freeze`
`/rd resume [world x z]`	恢复被暂停的机制	`redstonedetector.freeze`
`/rd entities <world> <x> <z>`	移除区块内的非玩家实体	`redstonedetector.admin`
`/rd tp <world> <x> <z>`	传送到区块	`redstonedetector.gui`
`/rd forget <world> <x> <z>`	停止追踪区块	`redstonedetector.admin`
`/rd lang [code\list]`	显示、列出或更改语言
`/rd version`	插件版本和更新状态	`redstonedetector.gui`
`/rd reload`	重载所有配置文件	`redstonedetector.reload`
`/rdcancel`	取消聊天输入（搜索/分页）	—

🔐 权限

权限	描述	默认
`redstonedetector.admin`	所有功能的完全访问权限	OP
`redstonedetector.command`	命令的基础访问权限	OP
`redstonedetector.gui`	仪表盘、状态、信息、列表、传送	OP
`redstonedetector.scan`	启动和取消区块扫描	OP
`redstonedetector.freeze`	冻结、解冻、停止和恢复红石	OP
`redstonedetector.reload`	重载配置	OP

⚙️ 配置

分为易读的文件：config.yml, performance.yml, blocks.yml, gui.yml 和 lang/ 文件夹。

检测 — 临界 TPS (15.0)，每区块最大红石数 (100)，最大实体数 (100)，冻结持续时间 (300 s)，区块数据保留时间 (24 h)

性能 — 每刻处理的区块数 (3)，扫描间隔，低 TPS 时扫描，仅扫描已加载区块，统计缓存，扫描冷却时间

智能冻结 — 智能冻结开关，更新评分阈值，800 次更新/秒时自动冻结，低 TPS 时 300 次更新/秒即冻结，60 s 后自动解冻，服务器 MSPT 阈值 (45.0)

探测器 — 灵敏度，幽匿激活数/组大小/循环窗口/重复爆发，活板门切换/集群大小/循环窗口/重复爆发，冻结半径，最大冻结秒数

过滤器 — 忽略的世界、忽略的区块、忽略的方块、调试日志记录

🌍 可用语言 (13)

🇬🇧 English (en_us)
🇷🇺 Russian (ru_ru)
🇺🇦 Ukrainian (uk_ua)
🇩🇪 German (de_de)
🇫🇷 French (fr_fr)
🇪🇸 Spanish (es_es)
🇮🇹 Italian (it_it)
🇳🇱 Dutch (nl_nl)
🇵🇱 Polish (pl_pl)
🇵🇹 Portuguese, Brazil (pt_br)
🇹🇷 Turkish (tr_tr)
🇯🇵 Japanese (ja_jp)
🇨🇳 Chinese, Simplified (zh_cn)

所有语言文件共享完全相同的键结构，因此翻译新语言只需复制一份 en_us.yml。将 lang/<locale>.yml 放入文件夹即可自动加载；缺失的键会回退到英语。启用 per-player-language: true 后，每位玩家都能看到自己客户端语言的插件界面。

💡 开发与支持

发现错误或有好主意？→ Discord
想帮助翻译？→ Discord 上的 #translation 频道
想贡献代码？→ GitHub

许可证： MIT

⚠️ 开发者备注

此插件最初是我为私人服务器开发的个人解决方案，现在免费提供给所有人。它处于积极开发中，您的反馈塑造了它 — 请在 Discord 上报告问题并分享想法！

Русская версия (Russian version) ▼

🔴 RedstoneDetector — автоматическая защита от лаг-машин ⚡🛡️

Находите и останавливайте редстоун лаг-машины до того, как игроки начнут жаловаться на TPS. RedstoneDetector измеряет реальную стоимость каждого чанка, называет найденную машину и может автоматически останавливать виновные механизмы — при этом остальной сервер продолжает работать как обычно.

Больше не нужно летать по карте и угадывать, какая ферма съедает тик. Плагин показывает мир, чанк, типы блоков, обновления в секунду и оценку MSPT — и замораживает проблему за вас.

💡 Главное в 1.2.0

Заморозка больше не «отменить событие и надеяться». Замороженные механизмы действительно приостанавливаются, поэтому нагрузка на процессор реально падает, а не остаётся прежней.

🚀 Почему RedstoneDetector?

🔍 Определение реальной нагрузки — чанки ранжируются по измеренному влиянию на MSPT, а не по количеству блоков
🧊 Настоящая авто-заморозка — приостанавливает редстоун, поршни, воронки, наблюдатели, компараторы, скалк-сенсоры и люки, а не просто отменяет события
🤖 Автоматическая остановка лаг-машин — чанк с экстремальной активностью замораживается автоматически, с последующим автоматическим снятием
🐛 Отдельный детектор скалк-сенсоров — петли вибраций, избыточные срабатывания, синхронные группы сенсоров, серии повторов
🚪 Отдельный детектор люков — быстрые циклы открытия/закрытия, кластеры, спам от редстоуна
🌐 Глобальная заморозка — один клик останавливает весь редстоун на сервере, один клик возвращает всё обратно
🧠 Умная заморозка — замораживает только виновные чанки, обычные фермы игроков продолжают работать
📊 Живая GUI-панель — обновляется каждую секунду, без кнопки обновления и без мерцания меню
🔎 Поиск чанка через чат — введите координаты чанка или блока и сразу получите отчёт
🧾 Журнал заморозок — время начала и конца, число приостановленных блоков и оценка выигрыша в логе
🌍 13 встроенных языков — с определением языка клиента для каждого игрока
🧩 Две платформы — Bukkit/Spigot/Paper/Purpur/Folia и отдельная сборка для Sponge

🧊 Система заморозки

🤖 Автоматическая остановка

Чанк замораживается автоматически, когда сервер действительно лагает и чанк остаётся дорогим несколько секунд подряд
Чрезмерно активные чанки замораживаются независимо от TPS (auto-freeze-updates-per-second, по умолчанию 800)
Скалк- и лаг-машины на люках замораживаются своими детекторами: сам чанк или настраиваемый радиус вокруг него
Заморозка снимается автоматически через auto-unfreeze-seconds (по умолчанию 60) для повторной оценки
Приостановка и восстановление ограничены бюджетом на тик, поэтому заморозка крупной фермы не вызывает просадок тика
Скалк-сенсоры, откалиброванные сенсоры и шрайкеры возвращаются в корректное состояние при снятии заморозки и продолжают работать нормально

🌐 Глобальная заморозка

Останавливает активность редстоуна во всех мирах сразу
Продолжает работать под нагрузкой: обнаружение, ранжирование и контроль не отключаются
Полностью обратима: Возобновить всё восстанавливает каждый приостановленный механизм

✋ Ручное управление

Заморозка и разморозка отдельного чанка из GUI или чата
Удаление редстоун-блоков с возможностью восстановления
Удаление сущностей (кроме игроков) в чанке
Забыть чанк, чтобы он больше не отслеживался

📊 Живая панель и GUI

Состояние сервера — TPS, MSPT, подозрительные чанки, замороженные чанки, глобальная заморозка, последнее сканирование
Активность в секунду — редстоун, поршни, воронки, наблюдатели, компараторы, скалк-сенсоры, люки, запланированные обновления, сущности, блок-сущности, lag score
Активные обнаружения — активные заморозки, наблюдение за скалком и люками, приостановленные чанки
Список чанков — сортировка по нагрузке на сервер, обновлениям в секунду, механизмам или сущностям, с корректной пагинацией
Экран чанка — мир, координаты, количество компонентов, активность, влияние, имя детектора, тип машины, приостановленные блоки, MSPT чанка против MSPT сервера
Быстрые действия — телепорт, заморозка/разморозка, стоп/возобновление, удаление редстоуна, удаление сущностей, забыть чанк
Авто-обновление — открытый экран обновляется раз в секунду без пересоздания инвентаря, курсор не сбрасывается

Распознаваемые типы машин: летающая машина, часы на наблюдателях, поршневые часы, редстоун-часы, машина быстрых обновлений, бесконечный цикл обновлений, скалк лаг-машина, люковая лаг-машина, машина транспортировки предметов.

⚡ Платформы и версии

Платформа	Статус
Bukkit / Spigot	✅ Поддерживается
Paper / Purpur	✅ Поддерживается
Mohist / Arclight (гибриды)	✅ Поддерживается
Folia	✅ Поддерживается (региональные планировщики)
Sponge / SpongeVanilla	✅ Отдельная нативная сборка

Версии Minecraft: 1.16.1 – актуальная

Java: 11+ для Bukkit-сборки, 21+ для Sponge-сборки

Зависимости: не требуются

📋 Команды

Основная команда: /redstonedetector, алиасы /rd, /reddetect.

Команда	Описание	Право
`/rd gui`	Открыть живую панель	`redstonedetector.gui`
`/rd status`	Состояние сервера: TPS, подозрительные и замороженные чанки	`redstonedetector.gui`
`/rd info [world x z]`	Полный отчёт по чанку (по умолчанию — вашему)	`redstonedetector.gui`
`/rd list` (`/rd top`)	Самые тяжёлые чанки прямо сейчас	`redstonedetector.gui`
`/rd search <x> <z>`	Поиск чанка по координатам чанка или блока	`redstonedetector.gui`
`/rd scan`	Запустить полное сканирование	`redstonedetector.scan`
`/rd scan cancel`	Отменить сканирование	`redstonedetector.scan`
`/rd freeze [world x z]`	Заморозить редстоун глобально или в одном чанке	`redstonedetector.freeze`
`/rd unfreeze [world x z]`	Снять заморозку	`redstonedetector.freeze`
`/rd stop [world x z]`	Приостановить механизмы без разрушения блоков	`redstonedetector.freeze`
`/rd resume [world x z]`	Возобновить приостановленные механизмы	`redstonedetector.freeze`
`/rd entities <world> <x> <z>`	Удалить сущности в чанке	`redstonedetector.admin`
`/rd tp <world> <x> <z>`	Телепортироваться к чанку	`redstonedetector.gui`
`/rd forget <world> <x> <z>`	Прекратить отслеживание чанка	`redstonedetector.admin`
`/rd lang [код/list]`	Показать, перечислить или сменить язык
`/rd version`	Версия плагина и статус обновления	`redstonedetector.gui`
`/rd reload`	Перезагрузить все конфигурации	`redstonedetector.reload`
`/rdcancel`	Отменить ввод в чат (поиск / листание)	—

🔐 Права

Право	Описание	По умолчанию
`redstonedetector.admin`	Полный доступ ко всем функциям	OP
`redstonedetector.command`	Базовый доступ к командам	OP
`redstonedetector.gui`	Панель, статус, инфо, список, телепорт	OP
`redstonedetector.scan`	Запуск и отмена сканирований	OP
`redstonedetector.freeze`	Заморозка, разморозка, стоп и возобновление	OP
`redstonedetector.reload`	Перезагрузка конфигурации	OP

⚙️ Настройка

Конфигурация разделена на понятные файлы: config.yml, performance.yml, blocks.yml, gui.yml и папка lang/.

Обнаружение — критический TPS (15.0), лимит редстоуна на чанк (100), лимит сущностей (100), длительность заморозки (300 с), хранение данных чанков (24 ч)

Производительность — чанков за тик (3), интервал сканирования, скан при низком TPS, только загруженные чанки, кэш статистики, кулдаун сканирования

Умная заморозка — включение интеллектуальной заморозки, порог update score, авто-заморозка при 800 обновлений/с, заморозка при низком TPS от 300 обновлений/с, авто-разморозка через 60 с, порог MSPT сервера (45.0)

Детекторы — чувствительность, параметры скалка (срабатывания, размер группы, окно петли, серии повторов), параметры люков (переключения, кластер, окно петли, серии), радиус заморозки, максимальное время заморозки

Фильтры — игнорируемые миры, чанки и блоки, отладочное логирование

🌍 Доступные языки (13)

🇬🇧 English (en_us)
🇷🇺 Русский (ru_ru)
🇺🇦 Українська (uk_ua)
🇩🇪 Deutsch (de_de)
🇫🇷 Français (fr_fr)
🇪🇸 Español (es_es)
🇮🇹 Italiano (it_it)
🇳🇱 Nederlands (nl_nl)
🇵🇱 Polski (pl_pl)
🇧🇷 Português (Brasil) (pt_br)
🇹🇷 Türkçe (tr_tr)
🇯🇵 日本語 (ja_jp)
🇨🇳 简体中文 (zh_cn)

Все языковые файлы имеют одинаковую структуру ключей, поэтому новый перевод — это копия en_us.yml. Положите lang/<locale>.yml в папку, и он подхватится автоматически; отсутствующие ключи берутся из английского. При per-player-language: true каждый игрок видит плагин на языке своего клиента.

💡 Разработка и поддержка

Нашли ошибку или есть идея? → Discord
Хотите помочь с переводом? → канал #translation в Discord
Хотите внести вклад? → GitHub

Лицензия: MIT

⚠️ Записка от разработчика

Плагин начинался как решение для моих частных серверов, а теперь доступен всем бесплатно. Он в стадии активной разработки, и ваши отзывы напрямую влияют на него — сообщайте о проблемах и делитесь идеями в Discord!

红石探测器