CoreProtect 2.10.0 — как пользоваться и обслуживать (подробно)

0) Что делает CoreProtect и что он «умеет» откатывать

CoreProtect — это журналирование действий (логирование) + быстрый поиск по истории + откаты (rollback) и «обратные откаты» (restore).

Что обычно логируется (зависит от настроек в config.yml):

• Блоки: поставил/сломал, «естественные» разломы (например, факел отвалился), движение блоков (песок/гравий), поршни, горение, воспламенение, взрывы.
• Сущности: убийства мобов, изменения блоков эндерменом и т.п.
• Таблички: текст на табличках.
• Вода/лава/ведра/потоки + трекинг «кто поставил источник» (важно для корректного отката разливов).
• Контейнеры/предметы: транзакции (взял/положил) в сундуки/печи/раздатчики и т.д. — это база для «возврата украденного».
• Команды, чат, сессии (логин/логаут), взаимодействия (дверь/кнопка/сундук — сами клики не откатываются, но могут быть полезны в расследовании).

1) Установка на Minecraft 1.7.10

1.1. Совместимость

CoreProtect 2.10.0 — релиз эпохи Bukkit/Spigot 1.7.x/1.8. На практике это обычно CraftBukkit/Spigot 1.7.10 (или близко по API).

1.2. Установка

1. Скопируй CoreProtect.jar в plugins/
2. Перезапусти сервер
3. Появится папка plugins/CoreProtect/ и файл config.yml
4. Проверь консоль: должен быть запуск CoreProtect и указание хранилища (SQLite/MySQL)

2) База данных: SQLite vs MySQL (и как выбрать)

3) Главный файл настроек plugins/CoreProtect/config.yml (2.10.0)

Ниже — «что означает каждая важная опция» из типового конфига ветки 2.x.

3.1. Отладка и поведение команд

• verbose — подробные сообщения при rollback/restore (или временно через #verbose).
• default-radius — радиус по умолчанию для rollback/restore, если ты не указал r:.
• max-radius — максимальный радиус, чтобы стафф случайно не сделал «ядерный» откат.
• check-updates — проверка обновлений при старте.
• api-enabled — разрешить другим плагинам пользоваться API CoreProtect.

3.2. Настройки MySQL

• use-mysql — включить MySQL.
• table-prefix — префикс таблиц.
• mysql-host/mysql-port/mysql-database/mysql-username/mysql-password — параметры подключения.

3.3. Что включать в откаты

• rollback-items — включать предметные транзакции в откаты (сундуки/инвентари).
• rollback-entities — включать сущности (например, убитых животных).
• skip-generic-data — не логировать «мусор» (условно: зомби горит на солнце и т.п.).

3.4. Опции логирования (самое важное)

Каждая из этих опций включает запись соответствующих событий:

• Блоки: block-place, block-break
• natural-break (важно для корректного отката дверей/кроватей/табличек)
• Механика: block-movement, pistons
• Огонь/взрывы: block-burn, block-ignite, explosions
• Сущности: entity-change, entity-kills
• Таблички: sign-text
• Жидкости: buckets, water-flow, lava-flow, liquid-tracking
• Мир: leaf-decay, tree-growth, mushroom-growth, vine-growth, portals
• Контейнеры: item-transactions (обязательно, если хочешь расследовать кражи)
• Следствие: player-interactions (не откатывается), player-messages, player-commands, player-sessions
• WorldEdit: worldedit (логировать изменения WE)

3.5. Пер-мировые конфиги

Можно сделать разные настройки логирования для разных миров: скопировать config.yml в world_nether.yml, world_the_end.yml и т.п., затем /co reload.

3.6. Blacklist логирования

Можно создать plugins/CoreProtect/blacklist.txt и указать пользователей/источники (например #tnt, #creeper) или команды, чтобы они не логировались, затем /co reload.

4) Команды CoreProtect: «как пользоваться» (расследование и откаты)

4.1. Быстрый список команд

5) Главная «грамматика» параметров (это 80% успеха)

Все ключевые команды (lookup/rollback/restore) используют один и тот же набор параметров:

u:<user> t:<time> r:<radius> a:<action> i:<include> e:<exclude> #<hashtag>

u:<user> — кто сделал

• u:Notch — один игрок
• u:Notch,Intelli — список
• u:#tnt,#creeper,#explosion — «не игроки», а причины (взрывы/криперы/и т.д.)

t:<time> — за какой период

• t:5d2h
• t:2.5h
• t:1h-2h (между 1 и 2 часами)

r:<radius> — где искать/откатывать

• r:10 — вокруг тебя
• r:#global — весь сервер (осторожно)
• r:#world_the_end — конкретный мир
• r:#worldedit / r:#we — по выделению WorldEdit

a:<action> — какой тип действий

• a:block, a:+block, a:-block — блоки
• a:container, a:+container, a:-container — контейнеры
• a:inventory / a:item — предметные события
• a:chat, a:command, a:session, a:sign и др.

i:<include> и e:<exclude>

• i:stone — только stone
• e:tnt — исключить TNT
• Списки — через запятую

Хэштеги

• #preview — предпросмотр отката
• #count — показать количество строк
• #verbose / #silent — больше/меньше вывода

6) Практические сценарии: расследование + откат без ошибок

6.1. «Кто сломал это?»

1. Встань рядом.
2. Включи инспектор: /co i
3. Кликни по блоку/сундуку — увидишь историю.
4. Выключи: /co i ещё раз.

6.2. Найти «кто копал алмазы» за час

/co lookup i:diamond_ore t:1h a:-block

6.3. Откат грифера в зоне (без «глобальной бомбы»)

Правильный безопасный подход:

1. Сначала предпросмотр:

/co rollback u:Griefer t:30m r:30 #preview

Если всё ок — выполнить то же без #preview.

6.4. Откат взрыва (TNT/крипер)

Сначала выясни:

/co lookup u:#tnt t:10m r:20

Потом откатывай:

/co rollback u:#tnt t:10m r:20

6.5. Вернуть украденное из сундука

Смотри транзакции контейнеров:

/co lookup a:container t:2h r:10/co lookup u:Player t:2h a:container

Если нужно откатить именно «изъятия»:

/co rollback u:Player t:2h a:-container r:10

6.6. «Я откатил лишнее — как вернуть?»

• Используй /co restore с теми же параметрами, чтобы вернуть действия.
• Или /co undo — быстрый «анти-откат».

7) Права (Permissions): как выдавать доступ стаффу

7.1. Базовые (главные)

• coreprotect.* — всё (обычно только админам)
• coreprotect.inspect — инспектор
• coreprotect.lookup — поиск
• coreprotect.rollback — откат
• coreprotect.restore — восстановление
• coreprotect.purge — чистка
• coreprotect.reload, coreprotect.status, coreprotect.consumer — сервис

7.2. Рекомендованная ролевая модель (практика)

• Хелпер/модератор: inspect, lookup (без rollback/restore).
• Старший модератор/админ: + rollback, restore.
• Техадмин: + purge, reload, consumer.

8) Обслуживание: производительность, место на диске, очереди, чистка

8.1. Очередь потребителя (consumer queue)

CoreProtect пишет события в очередь и постепенно «переваривает» их в БД. Команда /co consumer позволяет паузить/возобновлять обработку (удобно для диагностики).

8.2. Профилактика «база раздулась»

Команда:

/co purge t:30d

Удалит данные старше 30 дней (оставит только последние 30 дней).

8.3. Бэкапы (обязательно!)

• SQLite: копируй файл базы (обычно plugins/CoreProtect/database.db) при остановленном сервере.
• MySQL: делай регулярные дампы (mysqldump или панель хостинга).

8.4. Если база «повредилась» или CoreProtect тормозит

• Проверь диск/IO и размер базы.
• Если rollback/lookup «зависает» — тест на «пустой базе» помогает понять, проблема в данных или окружении.
• Всегда держи бэкап перед серьёзными операциями и purge.

9) Типовые ошибки админа (и как не угробить сервер)

1. Откат без #preview — потом приходится restore’ить. Используй предпросмотр почти всегда.
2. Слишком большой радиус / r:#global — можно откатить чужие постройки. Начинай с малого r:20 и увеличивай.
3. Не включили item-transactions — расследование краж становится почти невозможным.
4. Выдали rollback всем модерам — один промах = вайп половины спавна. Делай разграничение прав.
5. Переключили SQLite→MySQL и «пропали логи» — это ожидаемо: сменилась база. Планируй миграцию отдельно.

10) Мини-шпаргалка: самые полезные команды «на каждый день»

Инспектор

/co i

Найти, кто сломал в радиусе 10 за 15 минут

/co lookup t:15m r:10 a:-block

Откат игрока в радиусе 20 за час (предпросмотр)

/co rollback u:Player t:1h r:20 #preview

Откат только добычи (сломанных блоков) игроком

/co rollback u:Player t:2h a:-block r:20

Проверить сундуки (кто что брал/клал)

/co lookup a:container t:3d r:10

Очистить старые логи (30 дней)

/co purge t:30d

Источники

• docs.coreprotect.net — Commands
• docs.coreprotect.net — Config
• docs.coreprotect.net — Permissions
• BukkitDev — CoreProtect 2.10.0 file
• Пример config.yml для ветки 2.x (Pastebin)