Search the Community

[Программа] Программа для редактирования GM-команд (pkodev.tool.editgmcmd) Данный инструментарий предназначен для редактирования (переименовывания) GM-команд в GameServer.exe (команды &) и GroupServer.exe ( команды @@). Отличительной особенностью программы является то, что она позволяет задавать новые имена для GM-команд как короче, так и длиннее оригинальных имен. Например, команду &updateall можно заменить на &upd, а команду &move - на &letsmove. Использование Программа представляет собой консольное приложение и, соответственно, работа с ней происходит с помощью командной строки в следующем виде: pkodev.tool.editgmcmd <команда> [параметры команды] Сначала указывается путь до исполняемого .exe файла программы, далее выбирается команда, а после задаются её параметры. Для возможности работы с конкретным целевым файлом GameServer.exe или GroupServer.exe применяется файл базы данных GM-команд в формате .json. В данном файле указываются: 1) Название целевого .exe файла; 2) Метка времени его сборки (linker timestamp); 3) Символ GM-команды (например, '&' или '@@'); 4) Список строк с именами GM-команд и их адреса в целевом .exe файле. С примером .json файла базы данных GM-команд можно ознакомиться по ссылке. В данный момент инструментарий поддерживает (7) команд, которые будут рассмотрены далее. 1. Команда 'name' Отобразить текущее название GM-команды в целевом .exe файле. Параметры: --in "Путь до целевого .exe файла" --db "Путь до .json файла с базой данных GM-команд" (необязателен*) --old "Оригинальное название GM-команды" Например, команда &updateall была переименована в команду &updateall1024, тогда вызов: pkodev.tool.editgmcmd.x64.Release name --in "GameServer.exe" --old "updateall" --db "pkodev.tool.editgmcmd.json" Вернет следующий результат: The GM-command '&updateall' is defined as '&updateall1024'. 2. Команда 'rename' Изменить название GM-команды в целевом .exe файле. Параметры: --in "Путь до целевого .exe файла" --db "Путь до .json файла с базой данных GM-команд" (необязателен*) --bp "Режим резервного копирования" (необязателен**) --old "Оригинальное название GM-команды" --new "Новое название GM-команды" Пример: pkodev.tool.editgmcmd.x64.Release rename --in "GameServer.exe" --old "move" --new "letsmove" --db "pkodev.tool.editgmcmd.json" В результате GM-команда &move будет заменена на GM-команду &letstmove. 3. Команда 'reset' Сбросить все измененные названия GM-команд в целевом .exe файле на оригинальные. Параметры: --in "Путь до целевого .exe файла" --db "Путь до .json файла с базой данных GM-команд" (необязателен*) --bp "Режим резервного копирования" (необязателен**) Пример: pkodev.tool.editgmcmd.x64.Release reset --in "GameServer.exe" --db "pkodev.tool.editgmcmd.json" Внимание! В результате все ранее измененные GM-команды в целевом .exe файле приобретут старые (оригинальные) названия. 4. Команда 'enum' Вывести список всех GM-команд в целевом .exe файле в виде таблицы в консоль. Параметры: --in "Путь до целевого .exe файла" --db "Путь до .json файла с базой данных GM-команд" (необязателен*) Пример: pkodev.tool.editgmcmd.x64.Release enum --in "GameServer.exe" --db "pkodev.tool.editgmcmd.json" Примерный результат вывода см. в изображении в шапке темы. 5. Команда 'supported' Вывести список поддерживаемых целевых .exe файлов в виде таблицы в консоль. Параметры: --db "Путь до .json файла с базой данных GM-команд" (необязателен*) Пример: pkodev.tool.editgmcmd.x64.Release supported --db "pkodev.tool.editgmcmd.json" По итогам выполнения команды в консоль будет выведен список поддерживаемых .exe файлов, например: +------+------------------------------------------------+-----------------+------------------+ | # | Executable file name | Version | GM-commands | +------+------------------------------------------------+-----------------+------------------+ | 1.| GameServer.exe 1.36 (GAMESERVER_136) | 1204708785 | 53 | | 2.| GameServer.exe 1.38 (GAMESERVER_138) | 1225867911 | 53 | | 3.| GroupServer.exe 1.38 (GROUPSERVER_138) | 1224838510 | 8 | +------+------------------------------------------------+-----------------+------------------+ 6. Команда 'check' Проверить, поддерживается ли целевой .exe файл программой. Параметры: --in "Путь до целевого .exe файла" --db "Путь до .json файла с базой данных GM-команд" (необязателен*) Пример: pkodev.tool.editgmcmd.x64.Release check --in "GameServer.exe" --db "pkodev.tool.editgmcmd.json" Результат: GameServer.exe 1.38 (GAMESERVER_138) (Version: 1225867911) is supported! 7. Команда 'help' Получить помощь по программе. Параметры: Отсутствуют Пример: pkodev.tool.editgmcmd.x64.Release help Результат: Usage: pkodev.tool.editgmcmd.x64.Release <command> [parameters] There are supported commands: 1) name --in <.exe file> --old <GM-command> {--db <addresses file>} Get the original name of a given GM-command. 2) rename --in <.exe file> --old <GM-command> --new <GM-command> {--db <addresses file>} {--bp <backup mode [off|name|time]>} Rename a given GM-command. 3) reset --in <.exe file> {--db <addresses file>} {--bp <backup mode [off|name|time]>} Reset all GM-command names to the original ones. 4) enum --in <.exe file> {--db <addresses file>} Print a list of GM-commands as a table. 5) supported {--db <addresses file>} Print a list of supported .exe files as a table. 6) check --in <.exe file> {--db <addresses file>} Check if an .exe file is supported by the tool. Parameters in the curly braces {} are optional. * Параметр '--db' Данный параметр отвечает за путь до .json файла базы данных GM-команд, является необязательным и может отсутствовать. Если параметр '--db' не указан, то программа автоматически ищет этот файл в той же директории, в которой находится, и с таким же названием, что и её .exe файл, но с расширением .json. Например, если .exe файл программы находится по пути: "D:\tools\pkodev.tool.editgmcmd.x64.Release.exe", то программа будет пытаться загрузить базу данных GM-команд из файла: "D:\tools\pkodev.tool.editgmcmd.x64.Release.json". ** Параметр '--bp' Некоторые команды вносят изменения в целевой .exe файл. С целью предотвращения порчи данных, программа может сделать резервную копию целевого .exe файла. Данный параметр необязателен и при его отсутствии принимается значение по умолчанию. Параметр '--bp' принимает только следующие значения: 1) --bp "name" (значение по умолчанию) - файл резервной копии будет иметь такое же название, что и целевой .exe файл, но с расширением .backup; 2) --bp "time" - файл резервной копии будет иметь такое же название, что и целевой .exe файл, но с расширением .backup, плюс в начало названия добавляется временная метка на момент создания резервной копии; 3) --bp "off" - не создавать резервную копию целевого .exe файла. Скачать 1. Исполняемый файл (.exe) программы и файл (.json) с базой данных GM-команд; 2. Репозиторий с исходным кодом программы на языке C++ (Visual Studio 2022 Community). Если Вы столкнулись с какой-либо проблемой, багом или у Вас возникли вопросы, то пишите в данной теме.