Bukkit

English version

Description

The plugin is designed to search for the blocks by the given <id|name>[:data] in all currently loaded chunks in the specified world. It is supposed mostly to find lag machines. Initially, the plugin was made to find quarries from the modification "BuildCraft" and "world anchors" from the modification "RailCraft". These blocks load chunks, and if too much actually unused chunks are loaded, your server can start to lag really hard. If the game world is huge, it is not easy at all to find lag machine manually.

Рermissions

blockfinder.blockfinder: gives full permissions.

Usage

The commands can be executed only by players.

/blockfinder <id|name>[:data] search <world> [-f]: starts scanning the world <world>. If you do not specify world, it will use your current world. If more than 10000 blocks are found, the plugin stops its work to prevent server lagging. To avoid it, use "-f" (without quotes) as the last argument.

Results are saved in the file: "<block name>[-block data if exists].txt". It contains the date, the number of loaded chunks, the player that performed the scan, the coordinates and the world file in *.mcr formant for every block found. Each scan result has its ID. They are written to a file in order, starting with the first. Knowing the ID of the scan result, you can easily explore it.

/blockfinder <id|name>[:data] lookup <ID of the report or "last"> <page_number> : shows search results for the selected block in the specified report, or in the last report, if you entered "last" instead of ID. Coordinates of each block and name of the world file (*.mcr) containing this block will be output.

/blockfinder <id|name>[:data] list <page_number> [p:<player_name>] [w:<world_name>] [d:<date_by_the_format_dd.mm.yyyy>]: displays IDs of reports satisfying to the given conditions (if given):

p:admin: reports created only by a player with nickname "admin";

w:world - reports created only for a world with name "world";

d:20.10.2013 - reports created only at 20.10.2013.

Aliases

/bf

Examples

/bf 5:1 search world: this command will find all blocks of spruce boards in the loaded chunks of the world "world" and output it in file called "WOOD-1.txt" in your "plugins/block_finder" folder.

/bf wood:1 lookup last 2: this command will output the second page of the last report for spruce boards blocks.

/bf 5:1 lookup 2 3: this command will show the third page of the report for spruce boards with ID = 2;

/bf 5:1 list 1 p:admin d:20.10.2013: this command will show the list of all reports made by player "admin" in any world at 20.10.2013.

We are really sorry for our English.

Русская версия

Описание

Плагин для поиска блока по его id:data во всех загруженных в данный момент чанках указанного мира. Полезен для поиска лаг-машин на сервере. Изначально плагин создавался для поиска карьеров из мода BuildCraft и мирового якоря из мода RailCraft. Эти блоки подгружают чанки, которые всегда находятся в оперативной памяти сервера и обрабатываются. Если в таком месте установлена лаг-машина, то сервер будет лагать, даже если на нем нет игроков. Если карта огромна, то найти лаг-машину вручную - огромная проблема для администратора. Именно для поиска таких мест и создан этот плагин.

Разрешения

blockfinder.blockfinder: даст полные права.

Команды

/blockfinder <id|name>[:data] search <имя мира> [-f]: начать сканирование в мире <имя мира>. Если не указать мир, то будет использован текущий мир. По умолчанию, если плагин найдет более 10000 блоков, он завершит свою работу, чтобы предотвратить лаги или падение сервера. Чтобы обойти это ограничение, используйте "-f" в качестве последнего аргумента.

Результат будет сохранен в файле "<имя_блока>[-data_если_существует].txt" в папке "plugins/block_finder". Каждый результат сканирования имеет свой ID. Он содержит дату, имя игрока, который провел сканирование, имя мира, координаты каждого блока и файл мира в формате *.mcr для каждого из них. Результаты записываются в файл по порядку, начиная с первого. Зная ID результата сканирования, можно легко его посмотреть.

/blockfinder <id|name>[:data] lookup <id отчета или "last"> <номер страницы> : покажет результат поиска для выбранного блока в указанном отчете, или в последнем, если указан аргумент last. Результат содержит координаты каждого блока и файл мира (*.mcr), в котором находится данный блок.

/blockfinder <id|name>[:data] list <номер страницы> [p:<имя игрока>] [w:<название мира>] [d:<дата в формате дд.мм.гггг>] поиск ID отчета по заданным условиям, если они даны:

p:admin - ник игрока, проводившего сканирование: "admin";

w:world - мир, в котором выполнялся поиск: "world";

d:20.10.2013 - дата выполнения поиска: 20.10.2013.

Алиасы для команд

/bf

Пример использования

/bf 5:1 search world: данная команда найдет все блоки еловых досок в загруженных чанках мира world и сохранит их в отчет.

/bf 5:1 lookup last 3: покажет 3-ю страницу результата последнего поиска еловых досок.

/bf 5:1 lookup 2 3: команда покажет третью страницу результата поиска еловых досок с ID = 2

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

/bf 5:1 list 1 p:admin d:20.10.2013: ищем результаты сканирования для еловых досок, проведенного игроком "admin" в любом мире 20.10.2013.