En
| 问题 |
VCAnalyser 的作用 |
| "服务器卡顿,原因不明" |
汇总报告:TPS/MSPT、内存、CPU、实体、区块及可能原因列表 |
| "TPS 下降,但不知罪魁祸首" |
栈采样:正常状态与 MSPT 尖峰期间主线程时间在各插件中的占比 |
| "哪里的农场有一千个生物?" |
按实体数量排名的前几名区块;点击行即可传送至问题区块 |
| "内存占用过高 / GC 频繁" |
堆内存使用情况、填充百分比、GC 次数及耗时 |
| "内存中加载了太多区块" |
各世界已加载的区块数量 |
工作原理
- 监控 (
/vca enable) — 定期收集指标(间隔在 config.yml 中设置,默认约 5 秒)。禁用时(/vca disable),收集停止;状态保存于 state.yml,重启后恢复。
- 分析 (
/vca profile start) — 独立模式:异步采集主线程的栈快照。样本分为“MSPT 尖峰”和“正常”两类以便对比。不会随监控自动启动。
- 报告生成 (
/vca report) — 基于累积数据和配置中的阈值,生成报告:包含 OK / 警告 / 严重状态、原因分析及建议。
默认情况下,首次安装时监控功能为禁用状态,以避免影响性能,直到管理员显式启用。
功能特性
TPS 和 MSPT
- 1、5 和 15 分钟的 TPS;当前 MSPT(每刻毫秒数)。
- 与
tps-warning / tps-critical 和 mspt-warning / mspt-critical 阈值进行比较。
实体
- 按世界和类型统计(简要报告中显示前 5 种类型)。
- 过载最严重的区块(
entities-per-chunk-warning / critical 阈值)。
- 当实体总数 > 5000 时,统计地面掉落物(
ITEM)。
区块
- 整体及各世界的已加载区块数量。
- 出于性能考虑,代码中禁用了漏斗和红石块的计数。
内存和 CPU
- 堆内存使用量(MB 和 %)、GC 统计信息。
- 进程负载平均值(若操作系统支持)及核心数。
插件分析
独立的栈采样模式:/vca report 显示在卡顿期间和平稳时段主线程上正在运行什么。
建议
检测到问题时自动生成提示:清理掉落物、检查热点区域的农场、降低视距、增加 RAM 等。
权限
| 权限 |
默认值 |
用途 |
vcanalyser.admin |
op |
所有插件命令 |
命令
别名:/vcanalyser, /vca。
| 命令 |
描述 |
/vca |
帮助 |
/vca enable / on |
启用监控 |
/vca disable / off |
禁用监控(分析也会停止) |
/vca status |
监控和分析状态 |
/vca report |
完整报告(需启用监控) |
/vca tps |
仅 TPS 和 MSPT |
/vca entities |
按世界统计实体及前 10 名区块 |
/vca chunks |
按世界统计已加载区块 |
/vca memory |
内存和 GC 信息 |
/vca profile start |
开始栈采样 |
/vca profile stop |
停止分析并重置收集的样本 |
/vca tp <world> <chunkX> <chunkZ> |
传送到区块中心(仅限玩家) |
/vca language <ru|en> |
更改消息语言 |
/vca language |
显示当前语言 |
/vca reload |
重载 config.yml 和本地化文件 |
Ru
| Проблема |
Что делает VCAnalyser |
| «Сервер лагает, непонятно почему» |
Сводный отчёт: TPS/MSPT, память, CPU, сущности, чанки, список возможных причин |
| «TPS падает, но не знаю виновника» |
Stack sampling: доля времени главного потока по плагинам при норме и при просадках MSPT |
| «Где ферма с тысячей мобов?» |
Топ чанков по числу сущностей; клик по строке — телепорт в проблемный чанк |
| «Жрёт память / GC» |
Heap, процент заполнения, счётчик и время сборок мусора |
| «Много чанков в памяти» |
Число загруженных чанков по мирам |
Как это устроено
- Мониторинг (
/vca enable) — периодический сбор метрик (интервал задаётся в config.yml, по умолчанию раз в ~5 секунд). При выключении (/vca disable) сбор останавливается; состояние сохраняется в state.yml и восстанавливается после рестарта.
- Профилирование (
/vca profile start) — отдельный режим: асинхронно снимаются снимки стека главного потока. Сэмплы делятся на «просадка MSPT» и «норма» для сравнения. Не включается автоматически вместе с мониторингом.
- Анализ (
/vca report) — на основе накопленных данных и порогов из конфига строит отчёт: статусы OK / предупреждение / критично, причины и рекомендации.
По умолчанию при первой установке мониторинг выключен, чтобы не влиять на производительность, пока админ явно не включит его.
Возможности
TPS и MSPT
- TPS за 1, 5 и 15 минут; текущий MSPT (миллисекунды на тик).
- Сравнение с порогами
tps-warning / tps-critical и mspt-warning / mspt-critical.
Сущности
- Подсчёт по мирам и по типам (топ-5 типов в кратком отчёте).
- Топ перегруженных чанков (пороги
entities-per-chunk-warning / critical).
- Учёт дропа на земле (
ITEM) при общем числе сущностей > 5000.
Чанки
- Количество загруженных чанков всего и по мирам.
- Подсчёт хопперов и редстоун-блоков отключён в коде ради производительности.
Память и CPU
- Использование heap (МБ и %), статистика GC.
- Load average процесса (если доступен на ОС) и число ядер.
Профилирование плагинов
Отдельный режим stack sampling: в /vca report показывается, что выполнялось на главном потоке во время лагов и в спокойные моменты..
Рекомендации
Автоматические подсказки при обнаружении проблем: очистка дропа, проверка ферм в горячих чанках, снижение view-distance, увеличение RAM и т.д.
Права и доступ
| Право |
По умолчанию |
Назначение |
vcanalyser.admin |
op |
Все команды плагина |
命令
别名:/vcanalyser, /vca。
| 命令 |
描述 |
/vca |
帮助信息 |
/vca enable / on |
启用监控 |
/vca disable / off |
禁用监控(同时停止分析) |
/vca status |
查看监控与分析的状态 |
/vca report |
生成完整报告(需已启用监控) |
/vca tps |
仅显示 TPS 和 MSPT |
/vca entities |
按世界列出实体及前10个区块的统计 |
/vca chunks |
按世界列出已加载的区块 |
| /vca memory | 内存与垃圾回收(GC) |
| /vca profile start | 开始堆栈采样 |
| /vca profile stop | 停止分析并清除已收集的样本 |
| /vca tp <世界> <区块X> <区块Z> | 传送至区块中心(仅限玩家) |
| /vca language <ru\|en> | 切换消息语言 |
| /vca language | 显示当前语言 |
| /vca reload | 重新加载 config.yml 和本地化文件 |
好的,请提供需要翻译的文本内容。
En
| Problem |
What VCAnalyser does |
| "Server is lagging, unclear why" |
Summary report: TPS/MSPT, memory, CPU, entities, chunks, list of possible causes |
| "TPS drops, but don't know the culprit" |
Stack sampling: share of main thread time by plugins under normal conditions and during MSPT spikes |
| "Where is the farm with a thousand mobs?" |
Top chunks by entity count; click on a row — teleport to the problematic chunk |
| "Memory hog / GC" |
Heap, fill percentage, GC count and time |
| "Many chunks in memory" |
Number of loaded chunks per world |
How it works
- Monitoring (
/vca enable) — periodic collection of metrics (interval set in config.yml, default ~5 seconds). When disabled (/vca disable), collection stops; state is saved in state.yml and restored after a restart.
- Profiling (
/vca profile start) — separate mode: asynchronously takes stack snapshots of the main thread. Samples are divided into "MSPT spike" and "normal" for comparison. Does not start automatically with monitoring.
- Analysis (
/vca report) — based on accumulated data and thresholds from the config, builds a report: OK / warning / critical statuses, causes and recommendations.
By default, upon first installation, monitoring is disabled to avoid impacting performance until an admin explicitly enables it.
Features
TPS and MSPT
- TPS for 1, 5 and 15 minutes; current MSPT (milliseconds per tick).
- Comparison with
tps-warning / tps-critical and mspt-warning / mspt-critical thresholds.
Entities
- Count by world and by type (top 5 types in brief report).
- Top overloaded chunks (
entities-per-chunk-warning / critical thresholds).
- Counts ground items (
ITEM) when total entities > 5000.
Chunks
- Number of loaded chunks overall and per world.
- Counting hoppers and redstone blocks is disabled in code for performance.
Memory and CPU
- Heap usage (MB and %), GC statistics.
- Process load average (if available on OS) and number of cores.
Plugin Profiling
Separate stack sampling mode: /vca report shows what was running on the main thread during lag spikes and in calm moments.
Recommendations
Automatic hints when problems are detected: clearing dropped items, checking farms in hot chunks, lowering view-distance, increasing RAM, etc.
Permissions
| Permission |
Default |
Purpose |
vcanalyser.admin |
op |
All plugin commands |
Commands
Aliases: /vcanalyser, /vca.
| Command |
Description |
/vca |
Help |
/vca enable / on |
Enable monitoring |
/vca disable / off |
Disable monitoring (profiling also stops) |
/vca status |
Monitoring and profiling status |
/vca report |
Full report (requires monitoring enabled) |
/vca tps |
TPS and MSPT only |
/vca entities |
Entities by world and top 10 chunks |
/vca chunks |
Loaded chunks by world |
/vca memory |
Memory and GC |
/vca profile start |
Start stack sampling |
/vca profile stop |
Stop profiling and reset collected samples |
/vca tp <world> <chunkX> <chunkZ> |
Teleport to chunk center (player only) |
/vca language <ru|en> |
Change message language |
/vca language |
Show current language |
/vca reload |
Reload config.yml and localization files |
Ru
| Проблема |
Что делает VCAnalyser |
| «Сервер лагает, непонятно почему» |
Сводный отчёт: TPS/MSPT, память, CPU, сущности, чанки, список возможных причин |
| «TPS падает, но не знаю виновника» |
Stack sampling: доля времени главного потока по плагинам при норме и при просадках MSPT |
| «Где ферма с тысячей мобов?» |
Топ чанков по числу сущностей; клик по строке — телепорт в проблемный чанк |
| «Жрёт память / GC» |
Heap, процент заполнения, счётчик и время сборок мусора |
| «Много чанков в памяти» |
Число загруженных чанков по мирам |
Как это устроено
- Мониторинг (
/vca enable) — периодический сбор метрик (интервал задаётся в config.yml, по умолчанию раз в ~5 секунд). При выключении (/vca disable) сбор останавливается; состояние сохраняется в state.yml и восстанавливается после рестарта.
- Профилирование (
/vca profile start) — отдельный режим: асинхронно снимаются снимки стека главного потока. Сэмплы делятся на «просадка MSPT» и «норма» для сравнения. Не включается автоматически вместе с мониторингом.
- Анализ (
/vca report) — на основе накопленных данных и порогов из конфига строит отчёт: статусы OK / предупреждение / критично, причины и рекомендации.
По умолчанию при первой установке мониторинг выключен, чтобы не влиять на производительность, пока админ явно не включит его.
Возможности
TPS и MSPT
- TPS за 1, 5 и 15 минут; текущий MSPT (миллисекунды на тик).
- Сравнение с порогами
tps-warning / tps-critical и mspt-warning / mspt-critical.
Сущности
- Подсчёт по мирам и по типам (топ-5 типов в кратком отчёте).
- Топ перегруженных чанков (пороги
entities-per-chunk-warning / critical).
- Учёт дропа на земле (
ITEM) при общем числе сущностей > 5000.
Чанки
- Количество загруженных чанков всего и по мирам.
- Подсчёт хопперов и редстоун-блоков отключён в коде ради производительности.
Память и CPU
- Использование heap (МБ и %), статистика GC.
- Load average процесса (если доступен на ОС) и число ядер.
Профилирование плагинов
Отдельный режим stack sampling: в /vca report показывается, что выполнялось на главном потоке во время лагов и в спокойные моменты..
Рекомендации
Автоматические подсказки при обнаружении проблем: очистка дропа, проверка ферм в горячих чанках, снижение view-distance, увеличение RAM и т.д.
Права и доступ
| Право |
По умолчанию |
Назначение |
vcanalyser.admin |
op |
Все команды плагина |
Команды
Алиасы: /vcanalyser, /vca.
| Команда |
Описание |
/vca |
Справка |
/vca enable / on |
Включить мониторинг |
/vca disable / off |
Выключить мониторинг (профилирование тоже останавливается) |
/vca status |
Статус мониторинга и профилирования |
/vca report |
Полный отчёт (нужен включённый мониторинг) |
/vca tps |
Только TPS и MSPT |
/vca entities |
Сущности по мирам и топ-10 чанков |
/vca chunks |
Загруженные чанки по мирам |
/vca memory |
Память и GC |
/vca profile start |
Запустить stack sampling |
/vca profile stop |
Остановить профилирование и сбросить накопленные сэмплы |
/vca tp <мир> <chunkX> <chunkZ> |
Телепорт в центр чанка (только игрок) |
/vca language <ru|en> |
Сменить язык сообщений |
/vca language |
Показать текущий язык |
/vca reload |
Перезагрузить config.yml и файлы локализации |
评论 0
登录后参与评分
还没有评论,来抢沙发吧