update version

README.MD

@@ -1,698 +0,0 @@
-# GHAST TOOLS
-
-![version: 1.9](https://img.shields.io/badge/version-1.9-0a0.svg?style=flat)
-![bukkit-api: 1.12](https://img.shields.io/badge/bukkit--api-1.12-d50.svg?style=flat)
-
-Набор вспомогательных инструментов для Bukkit API.  
-_Основан на версии Bukkit API 1.12._
-
-## Содержание
-
-1. [Перед использованием](#перед-использованием)
-2. [GhastTools](#ghasttools)
-3. [AssetsManager](#assetsmanager)
-4. [BuildHelper](#buildhelper)
-5. [CommandManager](#commandmanager)
-6. [EffectsHelper](#effectshelper)
-7. [EventContext](#eventcontext)
-8. [JdbcTemplate](#jdbctemplate)
-9. [ScheduleManager](#schedulemanager)
-10. [ScheduleTask](#scheduletask)
-11. [Messages](#messages)
-12. [XLog](#xlog)
-13. [Подключение](#подключение)
-    1. [Gradle](#gradle)
-    2. [Maven](#maven)
-
----
-
-## Перед использованием
-
-Перед началом использования, необходимо в вашем Bukkit-плагине прописать подобный код:
-
-```java
-void onLoad() {
-    GhastTools.setPlugin(this);
-}
-```
-
-Это необходимо сделать, т.к. весь инструментарий основан на статических (static) методах.
-
-Все методы данного набора инструментов объеденены в классы, выполняющие роль группировщиков. 
-
-## GhastTools
-
-Методы общего назначения или без определённой группировки.
-
-### loadConfig
-
-Загрузка файла настроек плагина - `config.yml`.
-
-```java
-YamlConfiguration config = GhastTools.loadConfig();
-```
-
-По-умолчанию "гаст" пытается файл найти в папке плагина - `getDataFolder()`.
-Если файла там нет, то выгружает встроенный (имеющийся в `.jar` файле плагина) в эту папку и загружает его.
-
-```java
-YamlConfiguration config = GhastTools.loadConfig(false);
-```
-
-Если передать параметр `false`, то при отсутствии файла `config.yml` в папке плагина,
-будет загруден исключительно встроенный файл настроек.
-
-### copyLocation
-
-Копирования объекта `Location`
-
-```java
-Location location = ...;
-Location copyLoc = GhastTools.copyLocation(location); 
-```
-
-## AssetsManager
-
-Методы по работе с файлами плагина (_"ассетами"_).
-
-У каждой группы методов один и тот же набор входных параметров:
-
-- `resourceName` - наименование и путь к файлу в папке плагина
-- `defaultResourceName` - наименование и путь к файлу в плагине.  
-  _Опционально. По-умолчанию равнен `resourceName`_
-- `saveDefault` - необходимость скопировать содержимое файла из `defaultResourceName` в файл `resourceName`.  
-  _Опционально. По-умолчанию равен `true`_
-  
-Правила поиска файлов так же одинаков для каждой группы:
-
-- В начале файл ищется в папке плагина
-- Если файл отсутствует в папке плагина, то...
-    - если `defaultResourceName` не равен `null`...
-        - если `saveDefault` равен `true`, то файл из плагина будет выгружен в папку плагина и от туда загружен в память.
-        - если `saveDefault` равен `false`, то данные будут взяты из файлв в плагине.
-    - если `defaultResourceName` равен `null`, то будет брошено исключение `AssetsException` с описанием ошибки вида "Файл X не найден".
-
-### getAsInputStream
-
-```java
-InputStream inputStream = AssetsManager.getAsInputStream("translate.ru.yml", "translate.yml", false);
-```
-
-### getAsReader
-
-```java
-Reader reader = AssetsManager.getAsReader("translate.ru.yml", "translate.yml", false);
-```
-
-### getAsString
-
-```java
-String string = AssetsManager.getAsString("readme.txt", "readme.txt", StandardCharsets.UTF_8, false);
-```
-
-У этой группы есть дополнительный _опциональный_ параметр - `charset` - в котором указывается кодиривка получаемой строки.  
-_По-умолчанию равен `StandardCharsets.UTF_8`_
-
-## BuildHelper
-
-Набор методов облегчающих размецение объектов на карте.
-
-### placeSkull
-
-Установка черепа.
-
-```java
-Location location = ...;
-Skull skull = BuildHelper.placeSkull(location, BlockFace.NORTH);
-skull.update(true); // иначе изменения на карте не применятся и череп будет висеть в воздухе
-```
-
-### placePlayerHead
-
-Установка головы игрока.
-
-```java
-Location location = ...;
-Skull playerHead = BuildHelper.placePlayerHead(location, BlockFace.NORTH);
-playerHead.update(true); // иначе изменения на карте не применятся и голова будет висеть в воздухе
-```
-
-Если третьим параметром передать URL текстуры, то голова будет текстурирована.
-
-```java
-Location location = ...;
-BuildHelper.placePlayerHead(location, BlockFace.NORTH, "http://...");
-```
-
-### setPlayerHeadSkin
-
-Установка текстуры для головы игрока.
-
-```java
-Location location = ...;
-Skull playerHead = BuildHelper.placePlayerHead(location, BlockFace.NORTH);
-playerHead.update(true); // иначе изменения на карте не применятся и голова будет висеть в воздухе
-setPlayerHeadSkin(playerHead);
-```
-
-Порядок выполнения методов в приведённом выше примере **важен**. Если `playerHead.update(true)` вызвать после
-установки текстуры, она собъётся на стандартную.
-
-### placeSignWall
-
-```java
-Location location = ...;
-Sign signWall = BuildHelper.placeSignWall(location, BlockFace.NORTH)
-```
-
-## CommandManager
-
-Регистрация команд.
-
-Имеется два варианта использования: упрощённый
-
-```java
-CommandManager.register("start", (sender, args) -> sender.sendMessage("hello!"));
-```
-
-и подробный:
-
-```java
-CommandManager.create("start")
-        .useOnlyPlayer()
-        .executer((sender, args) -> sender.sendMessage("hello!"))
-        .register();
-```
-
-### register
-
-Упрощенная регистрация команды. Указывается лишь название команды и исполнитель.
-
-```java
-CommandManager.register("start", (sender, args) -> sender.sendMessage("hello!"));
-```
-
-### create
-
-Конструктор для подробного варианта регистрации команды.
-
-```java
-CommandManager.Builder builder = CommandManager.create("start");
-```
-
-### executer
-
-Указание исполнителя для команды
-
-```java
-CommandManager.Builder builder = CommandManager.create("start")
-        .executer((sender, args) -> sender.sendMessage("hello!"));
-```
-
-### onError
-
-Обработчик исключений
-
-```java
-CommandManager.Builder builder = CommandManager.create("start")
-        .onError((sender, commandName, args, exception) -> {
-            sender.sendMessage(ChatColor.RED + "Произошла ошибка при выполнении команды '" + commandName + "'.");
-            exception.printStackTrace();
-        });
-```
-
-### useOnlyPlayer
-
-Указание, что данную команду могут использовать только Игроки.
-Опционально можно указать сообщение, которое будет выводиться в консоль.  
-_Отменяет действие указателя `useOnlyConsole`_
-
-```java
-CommandManager.Builder builder = CommandManager.create("start")
-        .useOnlyPlayer("Команду могут использовать только игроки");
-```
-
-### useOnlyConsole
-
-Указание, что данную команду можно использовать только в консоле.
-Опционально можно указать сообщение, которое будет выводиться Игроку.  
-_Отменяет действие указателя `useOnlyPlayer`_
-
-```java
-CommandManager.Builder builder = CommandManager.create("start")
-        .useOnlyConsole(ChatColor.RED + "Команду можно использовать только в консоли");
-```
-
-### register
-
-Регистрация описанной в Конструкторе команды.
-
-```java
-CommandManager.create("start")
-        .useOnlyPlayer()
-        .executer((sender, args) -> sender.sendMessage("hello!"))
-        .register();
-```
-
-## EffectsHelper
-
-Набор методов для работы с эффектами.
-
-### playSound
-
-Воспроизвести звук.
-
-```java
-Location location = ...;
-EffectsHelper.playSound(location, Sound.AMBIENT_CAVE, 1.0f);
-```
-
-### particle
-
-Создание частиц.
-
-```java
-Location location = ...;
-EffectsHelper.particle(location, Particle.REDSTONE, 1.0d, 1.0d, 1.0d, 1.0d, 5);
-```
-
-## EventContext
-
-Регистрация группы обработчиков событий, объединённых общим условием выполнения.
-
-```java
-EventContext.create()
-        .filter(() -> Bukkit.getOnlinePlayers().size() > 10)
-        .onEvent(PlayerJoinEvent.class, event -> { event.getPlayer().kickPlayer("Max players"); });
-```
-
-### create
-
-Создание контекста событий.
-
-```java
-EventContext eventContext = EventContext.create();
-```
-
-### filter
-
-Условие, при котором будут срабатывать обработчики событий в данном контексте.
-
-```java
-EventContext.create()
-        .filter(() -> Bukkit.getOnlinePlayers().size() > 10)
-```
-
-### onEvent
-
-Указание события и его обработчика.  
-_Обработчик события регистрируется сразу же._
-
-```java
-EventContext.create()
-        .filter(() -> Bukkit.getOnlinePlayers().size() > 10)
-        .onEvent(PlayerJoinEvent.class, event -> event.getPlayer().kickPlayer("Max players"));
-```
-
-### cancelEvent
-
-Отменить событие.  
-_Обработчик события регистрируется сразу же._
-
-```java
-EventContext.create()
-        .cancelEvent(BlockPlaceEvent.class);
-```
-
-эквивалентен коду:
-
-```java
-EventContext.create()
-        .onEvent(BlockPlaceEvent.class, event -> event.setCancelled(true))
-```
-
-## JdbcTemplate
-
-Инструмент для упрощения работы с SQL базами данных, работающими через JDBC.
-
-Для начала потребуется создать объект `DataSource`
-
-```java
-// На примере MySQL
-MysqlDataSource dataSource = new MysqlDataSource();
-dataSource.setServerName("localhost");
-dataSource.setPort(3306);
-dataSource.setCharacterEncoding(StandardCharsets.UTF_8.name());
-dataSource.setDatabaseName("MyDataBase");
-dataSource.setUser("root");
-dataSource.setPassword("secret");
-```
-
-После чего создать `JdbcTemplate`
-
-```java
-JdbcTemplate jdbcTemplate = new JdbcTemplate(dataSource);
-```
-
-### execute
-
-Выполнение SQL запроса без последующей обработки результатов выполнения.
-
-```java
-jdbcTemplate.execute("CREATE TABLE my_table (id int, name varchar(16));");
-```
-
-### query
-
-Выполнение SQL запроса и обработка его результатов.  
-Может возвращать любой тип объектов. 
-
-```java
-String name = jdbcTemplate.query("SELECT name FROM my_table LIMIT 0,1", resultSet -> {
-        if (resultSet.next()) {
-            return resultSet.getString("name");
-        } else {
-            return null;
-        }
-});
-```
-
-```java
-List<String> names = jdbcTemplate.query("SELECT name FROM my_table", resultSet -> {
-        if (resultSet.next()) {
-            List<String> list = new ArrayList<>();
-            do {
-                list.add(resultSet.getString("name"));
-            } while (resultSet.next());
-            return list;
-        } else {
-            return Collections.emptyList();
-        }
-});
-```
-
-### queryOne
-
-Выполнение SQL запроса с расчетом, что результат будет единичным либо не будет вовсе.  
-Возвращает `Optional`.
-
-```java
-Optional<String> optName = jdbcTemplate.queryOne("SELECT name FROM my_table WHERE name LIKE 'dmitriymx'", rs -> rs.getString("name"));
-```
-
-### queryList
-
-Выполнение SQL запроса и обработка результата как списка данных.  
-Возвращает `List`.
-
-```java
-List<String> names = jdbcTemplate.queryList("SELECT name FROM my_table", (resultSet, rowNum) -> resultSet.getString("name"));
-```
-
-### queryForMap
-
-Выполнение SQL запроса с расчетом, что результат будет единичным либо не будет вовсе.  
-Возвращает `Map<String, Object>`, где ключ — это наименование колонок таблицы, а значения — это значения в ячейках таблицы.
-
-```java
-Map<String, Object> map = jdbcTemplate.queryForMap("SELECT * FROM my_table LIMIT 0,1;");
-```
-
-### queryForMapList
-
-Выполнение SQL запроса и обработка результата как списка данных.  
-Возвращает `List<Map<String, Object>>`, где ключ — это наименование колонок таблицы, а значения — это значения в ячейках таблицы.
-
-```java
-List<Map<String, Object>> mapList = jdbcTemplate.queryForMapList("SELECT * FROM my_table");
-```
-
-### update
-
-Выполнение SQL запроса где будет происходить обновление данных в таблице.
-Под "обновлением" подразумеваются любые изменения в таблице: `UPDATE`, `DELETE`, `INSERT`.  
-Возвращает число строк, которые были _по факту обновлены_ в таблице.
-
-```java
-int rows = jdbcTemplate.update("DELETE FROM my_table WHERE name LIKE 'dmitriymx';");
-```
-
-## ScheduleManager
-
-Набор методов для создания параллельных задач, выполняющихся один раз или по рассписанию.
-
-### createTask
-
-Создание конструктора задачи.
-
-```java
-ScheduleManager.Builder builder = ScheduleManager.createTask();
-```
-
-### useBukkitScheduler
-
-Если задача будет взаимодействоватьс **Bukkit API** или необходима привязка задачи к _тикам_,
-то необходимо использовать данный указатель.
-
-В ином случае, указатель не нужен.
-
-```java
-ScheduleManager.Builder builder = ScheduleManager.createTask()
-        .useBukkitScheduler();
-```
-
-### after
-
-Указание, что задачу нужно выполнить не сразу, а с некоторой задержкой перед запуском.
-
-```java
-ScheduleManager.Builder builder = ScheduleManager.createTask()
-        .after(5, TimeUnit.MINUTES);
-```
-
-### every
-
-Указание, что задачу нужно повторять через указанное время.
-
-```java
-ScheduleManager.Builder builder = ScheduleManager.createTask()
-        .every(5, TimeUnit.MINUTES);
-```
-
-### create
-
-Создание описанной задачи.
-
-```java
-ScheduleTask scheduleTask = ScheduleManager.createTask()
-        .every(1, TimeUnit.SECONDS)
-        .create(() -> Bukkit.getServer().getLogger().info("TimeMS: " + System.currentTimeMillis()));
-```
-
-_Задача будет только создана. Для её выполнения нужно вызвать `scheduleTask.start()`._
-
-### execute
-
-Создание и выполнение описанной задачи.
-
-```java
-ScheduleTask scheduleTask = ScheduleManager.createTask()
-        .every(1, TimeUnit.SECONDS)
-        .execute(() -> Bukkit.getServer().getLogger().info("TimeMS: " + System.currentTimeMillis()));
-```
-
-## ScheduleTask
-
-Вспомогательный объект, созданный через `ScheduleManager`. Позволяет управлять созданной задачей.
-
-### start
-
-Запускает задачу, если она еще не запущена.
-
-```java
-ScheduleTask scheduleTask = ...;
-scheduleTask.start();
-```
-
-### isCanceled
-
-Возвращает состояние задачи. Если `true`, значит задача была или _отменена/остоновлена_ или была завершена.
-
-```java
-ScheduleTask scheduleTask = ...;
-boolean status = scheduleTask.isCanceled();
-```
-
-### cancel
-
-Отменяет/Остонавливает выполнение задачи.
-
-```java
-ScheduleTask scheduleTask = ...;
-scheduleTask.cancel();
-```
-
-## Messages
-
-Инструмент для работы с параметизированными сообщениями или просто сообщениями, которые храняться в отдельном файле.
-
-Параметизированные сообщения имеют следующий вид: `Привет, {player}!`.
-
-### load
-
-Загрузка сообщений в инструмент.
-
-Есть три варианта: через `Properties`
-
-```java
-Properties properties = ...;
-Messages.load(properties);
-```
-
-через `Map<String, String>`
-
-```java
-Map<String, String> map = ...;
-Messages.load(map);
-```
-
-через `Reader`
-
-```java
-Reader reader = ...;
-Messages.load(reader);
-```
-
-Следует учесть, про при работе через `Reader`, **Messages** ожидает там обнаружить список строк в формате `key=value`.
-
-### get
-
-Получение обычноего или параметизированного сообщения.
-
-Для примера, пусть у нас будут такие сообщения:
-
-```properties
-simple=Простое сообщение
-welcome=Приветствуем, {player}!
-```
-
-Для получения простого сообщения, просто указываем его ключ:
-
-```java
-String message = Messages.get("simple");
-// Простое сообщение
-```
-
-Для получения параметизированного сообщения, нужно помимо ключа передать параметры.
-Есть два способа: через `Map<String, Object>`
-
-```java
-Map<String, Object> = map = new HashMap<>(1);
-map.put("player", "David");
-
-String message = Messages.get("welcome", map);
-// Приветствуем, David!
-```
-
-через попарное перечисление параметров
-
-```java
-String message = Messages.get("welcome", "player", "David");
-// Приветствуем, David!
-```
-
-Если по указанному ключу сообщение отсутствует, то **Messages** вернёт значение самого ключа
-
-```java
-String message = Messages.get("not_exists_key");
-// not_exists_key
-
-message = Messages.get("not_exists_key", "player", "David");
-// not_exists_key
-```
-
-Если параметр, который указан в шаблоне не был указан/определён, то параметр останется как есть
-
-```java
-String message = Messages.get("welcome");
-// Приветствуем, {player}!
-
-message = Messages.get("welcome", "unknown_param_key", 123);
-// Приветствуем, {player}!
-```
-
-### format
-
-**Messages** можно использовать и просто для форматирования параметизированных шаблонов:
-
-```java
-Map<String, Object> = map = new HashMap<>(1);
-map.put("player", "David");
-
-String message = Messages.format("Приветствуем, {player}!", map);
-// Приветствуем, David!
-```
-
-```java
-String message = Messages.foramt("Приветствуем, {player}!", "player", "David");
-// Приветствуем, David!
-```
-
-## XLog
-
-Замена стандартному `getLogger()`, который использует `java.utils.Logger` и не всегда удобен для логирования.
-
-Имеет 4 уровня логирования: `debug`, `info`, `warning`, `error`.
-
-Сообщения могут быть шаблонизированными. Синтаксис шаблонов — `java.text.MessageFormat`.
-
-Примеры:
-
-```java
-XLog.info("Hello");
-XLog.info("Player {0} join game", event.getPlayer().getName());
-
-XLog.error("ERROR!", exception);
-XLog.error("ERROR: {0}", exception.getMessage());
-// Для экранирования "{" нужно перед ней поставить "'".
-// А для использования "'" нужно их дублировать.
-XLog.error("ERROR ''{0}'' in Event '{{1}'}: {2}", exception.getClass(), event.getClass(), exception.getMessage());
-XLog.error("ERROR: {0}", exception.getMessage(), exception);
-```
-
----
-
-## Подключение
-
-### Gradle
-
-```groovy
-repositories {
-    maven { url 'https://dmx-mc-project.gitlab.io/maven-repository/' }
-}
-```
-
-```groovy
-implementation group: 'ghast', name: 'ghast-tools', version: '1.9'
-```
-
-### Maven
-
-```xml
-<repositories>
-    <repository>
-        <id>dmx-mc-project</id>
-        <url>https://dmx-mc-project.gitlab.io/maven-repository/</url>
-    </repository>
-</repositories>
-```
-
-```xml
-<dependencies>
-    <dependency>
-        <groupId>ghast</groupId>
-        <artifactId>ghast-tools</artifactId>
-        <version>1.9</version>
-    </dependency>
-</dependencies>
-```

build.gradle

@@ -29,7 +29,8 @@ ext {
             ]],
             commons_text: 'org.apache.commons:commons-text:1.9',
             lombok: 'org.projectlombok:lombok:1.18.12',
-            reflection_object: 'ru.dmitriymx:reflection-object:1.2',
+            reflection_object: 'ru.dmitriymx:reflection-object:1.0-BETA',
+            mysql: 'mysql:mysql-connector-java:8.0.22',
             test: [
                     junit5: [
                             "org.junit.jupiter:junit-jupiter-api:$junitVersion",
@@ -65,6 +66,7 @@ dependencies {
     annotationProcessor libs.lombok
 
     compileOnly2 libs.bukkit
+    compileOnly libs.mysql
     implementation libs.commons_text
     implementation libs.reflection_object
 

gradle.properties

@@ -1,3 +1,3 @@
 projectGroup=ghast
 projectName=ghast-tools
-projectVersion=1.4
+projectVersion=1.9

src/main/java/ghast/BuildHelper.java

@@ -3,111 +3,26 @@ package ghast;
 import lombok.experimental.UtilityClass;
 import org.bukkit.Location;
 import org.bukkit.Material;
-import org.bukkit.SkullType;
 import org.bukkit.block.Block;
 import org.bukkit.block.BlockFace;
 import org.bukkit.block.Sign;
 import org.bukkit.block.Skull;
-import ru.dmitriymx.reflection.ReflectionClass;
-import ru.dmitriymx.reflection.ReflectionObject;
-
-import java.nio.charset.StandardCharsets;
-import java.util.Base64;
-import java.util.UUID;
 
 @UtilityClass
 @SuppressWarnings("unused")
 public class BuildHelper {
 
-    private final Class<?> CLASS_BLOCKPOSITION = getClassForName("net.minecraft.server.v1_12_R1.BlockPosition");
-    private final Class<?> CLASS_GAMEPROFILE = getClassForName("com.mojang.authlib.GameProfile");
-
-    /**
-     * Установка черепа.
-     * <p>
-     * После установки, необходимо выполнить <code>skull.update(true);</code>
-     *
-     * @param location место установки.
-     * @param face куда будет повёрнут череп.
-     * @return Блок типа {@link Skull}
-     */
 	public Skull placeSkull(Location location, BlockFace face) {
-        Location fixedLocation = GhastTools.copyLocation(location);
-        fixedLocation.setZ(fixedLocation.getZ() - 1);
-
 		Block block = location.getWorld().getBlockAt(location);
 		block.setType(Material.SKULL);
-
 		Skull skull = (Skull) block.getState();
 		skull.setRotation(face);
-
 		org.bukkit.material.Skull skullMaterial = (org.bukkit.material.Skull) skull.getData();
 		skullMaterial.setFacingDirection(BlockFace.SELF);
 
 		return skull;
 	}
 
-    /**
-     * Установка головы игрока.
-     * <p>
-     * После установки, необходимо выполнить <code>skull.update(true);</code>
-     *
-     * @param location место установки.
-     * @param face куда будет повёрнута голова.
-     * @return Блок типа {@link Skull}
-     */
-    public static Skull placePlayerHead(Location location, BlockFace face) {
-        Location fixedLocation = GhastTools.copyLocation(location);
-        fixedLocation.setZ(fixedLocation.getZ() - 1);
-
-        Block block = fixedLocation.getWorld().getBlockAt(fixedLocation);
-        block.setType(Material.SKULL);
-
-        Skull skull = (Skull) block.getState();
-        skull.setSkullType(SkullType.PLAYER);
-        skull.setRotation(face);
-
-        org.bukkit.material.Skull skullMaterial = (org.bukkit.material.Skull) skull.getData();
-        skullMaterial.setFacingDirection(BlockFace.SELF);
-        return skull;
-    }
-
-    /**
-     * Установка текстурированной головы игрока.
-     *
-     * @param location место установки.
-     * @param face куда будет повёрнута голова.
-     * @param skinUrl URL на текстуру
-     * @return Блок типа {@link Skull}
-     */
-    public static Skull placePlayerHead(Location location, BlockFace face, String skinUrl) {
-        Skull playerHead = placePlayerHead(location, face);
-        playerHead.update(true);
-        setPlayerHeadSkin(playerHead, skinUrl);
-
-        return playerHead;
-    }
-
-    /**
-     * Установка текстуры для головы игрока.
-     *
-     * @param skull блок головы игрока
-     * @param skinUrl URL на текстуру
-     */
-    public static void setPlayerHeadSkin(Skull skull, String skinUrl) {
-        //TODO заменить рефлексию на "фантомные" классы
-        ReflectionObject refobjBlockPosition = new ReflectionClass(CLASS_BLOCKPOSITION)
-                .constructor(double.class, double.class, double.class)
-                .newInstance(skull.getX(), skull.getY(), skull.getZ());
-
-        new ReflectionObject(skull.getWorld())
-                .method("getHandle").invoke()
-                .method("getTileEntity", CLASS_BLOCKPOSITION)
-                    .invoke(refobjBlockPosition.getOriginalObject())
-                .method("setGameProfile", CLASS_GAMEPROFILE)
-                    .invoke(getRefObjPlayerProfile(skinUrl).getOriginalObject());
-    }
-
 	public Sign placeSignWall(Location location, BlockFace face) {
 		Block block = location.getWorld().getBlockAt(location);
 		block.setType(Material.WALL_SIGN);
@@ -118,30 +33,4 @@ public class BuildHelper {
 
 		return sign;
 	}
-
-    private ReflectionObject getRefObjPlayerProfile(String url){
-        ReflectionObject refobjProperty = new ReflectionClass(
-                    getClassForName("com.mojang.authlib.properties.Property"))
-                .constructor(String.class, String.class)
-                .newInstance("textures", Base64.getEncoder()
-                        .encodeToString(("{textures:{SKIN:{url:\"" + url + "\"}}}").getBytes(StandardCharsets.UTF_8)));
-
-        ReflectionObject refobjGameProfile = new ReflectionClass(CLASS_GAMEPROFILE)
-                .constructor(UUID.class, String.class)
-                .newInstance(UUID.randomUUID(), null);
-        refobjGameProfile
-                .method("getProperties").invoke()
-                .method("put", Object.class, Object.class)
-                    .invoke("textures", refobjProperty.getOriginalObject());
-
-        return refobjGameProfile;
-    }
-
-    private Class<?> getClassForName(String className) {
-        try {
-            return Class.forName(className);
-        } catch (Exception e) {
-            throw new RuntimeException(e);
-        }
-    }
 }

src/main/java/ghast/GhastTools.java

@@ -2,7 +2,6 @@ package ghast;
 
 import ghast.assets.AssetsManager;
 import lombok.experimental.UtilityClass;
-import org.bukkit.Location;
 import org.bukkit.configuration.file.YamlConfiguration;
 import org.bukkit.plugin.Plugin;
 
@@ -16,10 +15,16 @@ public class GhastTools {
 
 	private static WeakReference<Plugin> refPlugin;
 
+	@SuppressWarnings("java:S2696")
 	public void setPlugin(Plugin plugin) {
-        refPlugin = plugin == null ? null : new WeakReference<>(plugin);
+		if (plugin == null) {
+			refPlugin = null;
+		} else {
+			refPlugin = new WeakReference<>(plugin);
+		}
 	}
 
+	@SuppressWarnings("java:S112")
 	public Plugin getPlugin() {
 		if (refPlugin == null) {
 			throw new RuntimeException("Plugin not set.");
@@ -33,6 +38,7 @@ public class GhastTools {
 		return plugin;
 	}
 
+	@SuppressWarnings("java:S112")
 	public YamlConfiguration loadConfig(boolean saveDefault) {
 		if (saveDefault) {
 			getPlugin().saveDefaultConfig();
@@ -48,8 +54,4 @@ public class GhastTools {
 	public YamlConfiguration loadConfig() {
 		return loadConfig(true);
 	}
-
-    public Location copyLocation(Location location) {
-        return new Location(location.getWorld(), location.getX(), location.getY(), location.getZ());
-    }
 }

src/main/java/ghast/I18n.java

@@ -14,18 +14,15 @@ import java.io.Reader;
 import java.util.HashMap;
 import java.util.Map;
 
-/**
- * @deprecated use {@link Messages}
- */
 @UtilityClass
 @SuppressWarnings("unused")
-@Deprecated
 public class I18n {
 
 	private final String DEFAULT_LANG = "en";
 	private final Table<String/*Lang*/, String/*Key*/, String/*Template|Message*/> messagesMap = HashBasedTable.create();
 
 	//region Load messages
+	@SuppressWarnings("java:S112")
 	public void loadMessages(String lang, Reader reader) {
 		Map<String, String> map = messagesMap.row(lang.toLowerCase());
 

src/main/java/ghast/Messages.java

@@ -1,150 +0,0 @@
-package ghast;
-
-import lombok.experimental.UtilityClass;
-import org.apache.commons.text.StringSubstitutor;
-
-import java.io.BufferedReader;
-import java.io.IOException;
-import java.io.Reader;
-import java.util.HashMap;
-import java.util.Map;
-import java.util.Properties;
-
-@UtilityClass
-public class Messages {
-
-	private final Map<String/*Key*/, String/*Template|Message*/> MESSAGES_MAP = new HashMap<>();
-
-	//region Load messages
-
-	/**
-	 * Загрузка сообщений из {@link Properties}
-	 *
-	 * @param properties список сообщений и шаблонов
-	 */
-	public void load(Properties properties) {
-		MESSAGES_MAP.clear();
-		properties.forEach((key, value) -> MESSAGES_MAP.put(key.toString().trim().toLowerCase(), value.toString().trim()));
-	}
-
-	/**
-	 * Загрузка сообщений из {@link Reader}.
-	 * <p>
-	 * Формат строк: {@code key=value}
-	 * </p>
-	 *
-	 * @param reader {@link Reader} со списоком сообщений и шаблонов
-	 */
-	public void load(Reader reader) {
-		MESSAGES_MAP.clear();
-		try {
-			BufferedReader bufferedReader = new BufferedReader(reader);
-			String line;
-			while ((line = bufferedReader.readLine()) != null) {
-				String[] split = line.split("=", 2);
-				MESSAGES_MAP.put(split[0].trim().toLowerCase(), split[1].trim());
-			}
-		} catch (IOException e) {
-			//TODO заменить на специализированный Exception
-			throw new RuntimeException("Error load messages: " + e.getMessage(), e);
-		}
-	}
-
-	/**
-	 * Загрузка сообщений из {@link Map}<{@link String}, {@link String}>.
-	 *
-	 * @param messages список сообщений и шаблонов
-	 */
-	public void load(Map<String, String> messages) {
-		MESSAGES_MAP.clear();
-		MESSAGES_MAP.putAll(messages);
-	}
-	//endregion
-
-	//region Get messages
-	/**
-	 * Получить обычное сообщение по ключу/коду.
-	 *
-	 * @param key ключ/код
-	 * @return сообщение, если таковое задано. Иначе - ключ
-	 */
-	public String get(String key) {
-		String keyLc = key.toLowerCase();
-		return MESSAGES_MAP.getOrDefault(keyLc, keyLc);
-	}
-
-	/**
-	 * Получить параметизированное сообщение по ключу/коду.
-	 *
-	 * @param key    ключ/код
-	 * @param params список параметров
-	 * @return сообщение, если таковое задано. Иначе - ключ
-	 */
-	public String get(String key, Map<String, Object> params) {
-		String keyLc = key.toLowerCase();
-
-		if (MESSAGES_MAP.containsKey(keyLc)) {
-			return format(MESSAGES_MAP.get(keyLc), params);
-		} else {
-			return keyLc;
-		}
-	}
-
-	/**
-	 * Получить параметизированное сообщение по ключу/коду.
-	 *
-	 * @param key    ключ/код
-	 * @param params чередующийся по парный список параметров: {@link String (str)param_name}, {@link Object (obj)param_value} и т.д.
-	 * @return сообщение, если таковое задано. Иначе - ключ
-	 */
-	public String get(String key, Object... params) {
-		String keyLc = key.toLowerCase();
-
-		if (MESSAGES_MAP.containsKey(keyLc)) {
-			return format(MESSAGES_MAP.get(keyLc), params);
-		} else {
-			return keyLc;
-		}
-	}
-	//endregion
-
-	//region Format message
-	/**
-	 * Получить сообщение по формату.
-	 *
-	 * @param format параметизированное сообщение
-	 * @param params параметры
-	 * @return сообщение
-	 */
-	public String format(String format, Map<String, Object> params) {
-		return StringSubstitutor.replace(format, params, "{", "}");
-	}
-
-	/**
-	 * Получить сообщение по формату.
-	 *
-	 * @param format параметизированное сообщение
-	 * @param params параметры
-	 * @return сообщение
-	 */
-	public String format(String format, Object... params) {
-		return format(format, arrayParamsToMap(params));
-	}
-	//endregion
-
-	private Map<String, Object> arrayParamsToMap(Object... params) {
-		int len;
-		if ((params.length % 2) == 1) {
-			len = params.length - 1;
-		} else {
-			len = params.length;
-		}
-
-		Map<String, Object> map = new HashMap<>(len / 2);
-		for (int i = 0; i < len; i = i + 2) {
-			map.put((String) params[i], params[i + 1]);
-		}
-
-		return map;
-	}
-}

src/main/java/ghast/command/CommandWrapper.java

@@ -46,6 +46,7 @@ class CommandWrapper extends BukkitCommand {
 	}
 
 	@Override
+	@SuppressWarnings("java:S1066")
 	public boolean execute(CommandSender commandSender, String commandName, String[] args) {
 		if (Boolean.TRUE.equals(onlyPlayer)) {
 			if (!(commandSender instanceof Player)) {

src/main/java/ghast/database/DataAccessException.java

@@ -2,11 +2,21 @@ package ghast.database;
 
 import lombok.Getter;
 
+@SuppressWarnings("java:S1165")
 @Getter
 public class DataAccessException extends RuntimeException {
 
 	private String sql;
 
+	public DataAccessException(String msg) {
+		super(msg);
+	}
+
+	public DataAccessException(String msg, String sql) {
+		this(msg);
+		this.sql = sql;
+	}
+
 	public DataAccessException(String msg, Throwable cause) {
 		super(msg, cause);
 	}

src/main/java/ghast/database/EmptyResultDataAccessException.java

@@ -0,0 +1,8 @@
+package ghast.database;
+
+public class EmptyResultDataAccessException extends IncorrectResultSizeDataAccessException {
+
+	public EmptyResultDataAccessException(int expectedSize) {
+		super(expectedSize);
+	}
+}

src/main/java/ghast/database/IncorrectResultSizeDataAccessException.java

@@ -0,0 +1,8 @@
+package ghast.database;
+
+public class IncorrectResultSizeDataAccessException extends DataAccessException {
+
+	public IncorrectResultSizeDataAccessException(int expectedSize) {
+		super("Incorrect result size: expected " + expectedSize);
+	}
+}

src/main/java/ghast/database/JdbcOperations.java

@@ -2,7 +2,6 @@ package ghast.database;
 
 import java.util.List;
 import java.util.Map;
-import java.util.Optional;
 
 public interface JdbcOperations {
 
@@ -10,13 +9,15 @@ public interface JdbcOperations {
 
 	<T> T query(String sql, ResultSetExtractor<T> rse) throws DataAccessException;
 
-    <T> Optional<T> queryOne(String sql, ResultSetExtractor<T> rse) throws DataAccessException;
+	<T> List<T> query(String sql, RowMapper<T> rowMapper) throws DataAccessException;
 
-    <T> List<T> queryList(String sql, RowMapper<T> rowMapper) throws DataAccessException;
+	<T> T queryForObject(String sql, RowMapper<T> rowMapper) throws DataAccessException;
 
 	Map<String, Object> queryForMap(String sql) throws DataAccessException;
 
-    List<Map<String, Object>> queryForMapList(String sql) throws DataAccessException;
+	List<Map<String, Object>> queryForList(String sql) throws DataAccessException;
 
 	int update(String sql) throws DataAccessException;
+
+	int delete(String sql) throws DataAccessException;
 }

src/main/java/ghast/database/JdbcTemplate.java

@@ -6,16 +6,17 @@ import lombok.NoArgsConstructor;
 import lombok.Setter;
 
 import javax.sql.DataSource;
-import java.sql.Date;
 import java.sql.*;
-import java.util.*;
+import java.util.ArrayList;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
 
 @NoArgsConstructor
 @Getter
 @Setter
 public class JdbcTemplate implements JdbcOperations {
 
-    private static final String DBG_SQL_INFO = "Execute SQL: {0}";
 	private DataSource dataSource;
 
 	public JdbcTemplate(DataSource dataSource) {
@@ -24,7 +25,7 @@ public class JdbcTemplate implements JdbcOperations {
 
 	@Override
 	public void execute(String sql) throws DataAccessException {
-        XLog.debug(DBG_SQL_INFO, sql);
+		XLog.debug("Execute SQL: {0}", sql);
 
 		Connection connection = openConnection();
 		Statement statement = null;
@@ -41,7 +42,7 @@ public class JdbcTemplate implements JdbcOperations {
 
 	@Override
 	public <T> T query(String sql, ResultSetExtractor<T> rse) throws DataAccessException {
-        XLog.debug(DBG_SQL_INFO, sql);
+		XLog.debug("Execute SQL: {0}", sql);
 
 		Connection connection = openConnection();
 		Statement statement = null;
@@ -60,74 +61,71 @@ public class JdbcTemplate implements JdbcOperations {
 	}
 
 	@Override
-    public <T> Optional<T> queryOne(String sql, ResultSetExtractor<T> rse) throws DataAccessException {
+	public <T> List<T> query(String sql, final RowMapper<T> rowMapper) throws DataAccessException {
 		return query(sql, rs -> {
-            if (rs.next()) {
+			List<T> resultList = new ArrayList<>();
-                return Optional.ofNullable(rse.extractData(rs));
+			int rowNum = 0;
-            } else {
+			while (rs.next()) {
-                return Optional.empty();
+				resultList.add(rowMapper.mapRow(rs, rowNum++));
 			}
+			return resultList;
 		});
 	}
 
 	@Override
-    public <T> List<T> queryList(String sql, final RowMapper<T> rowMapper) throws DataAccessException {
+	public <T> T queryForObject(String sql, RowMapper<T> rowMapper) throws DataAccessException {
 		return query(sql, rs -> {
-            List<T> resultList;
-            int rowNum = 0;
 			if (rs.next()) {
-                resultList = new ArrayList<>();
+				T resultObj = rowMapper.mapRow(rs, 0);
 
-                do {
+				if (rs.next()) {
-                    resultList.add(rowMapper.mapRow(rs, rowNum++));
+					throw new IncorrectResultSizeDataAccessException(1);
-                } while (rs.next());
-            } else {
-                resultList = Collections.emptyList();
 				}
 
-            return resultList;
+				return resultObj;
+			} else {
+				throw new EmptyResultDataAccessException(1);
+			}
 		});
 	}
 
 	@Override
 	public Map<String, Object> queryForMap(String sql) throws DataAccessException {
-        return query(sql, rs -> {
+		return queryForObject(sql, (rs, rowNum) -> {
-            if (rs.next()) {
 			ResultSetMetaData metaData = rs.getMetaData();
 			int columnCount = metaData.getColumnCount();
+			Map<String, Object> resultMap = new LinkedHashMap<>(columnCount);
 
-                return rowToMap(columnCount, metaData, rs);
+			for (int i = 1; i <= columnCount; i++) {
-            } else {
+				String key = lookupColumnName(metaData, i);
-                return Collections.emptyMap();
+				Object value = getResultSetRawValue(rs, i);
+				resultMap.put(key, value);
 			}
+
+			return resultMap;
 		});
 	}
 
 	@Override
-    public List<Map<String, Object>> queryForMapList(String sql) throws DataAccessException {
+	public List<Map<String, Object>> queryForList(String sql) throws DataAccessException {
-        return query(sql, rs -> {
+		return query(sql, (rs, rowNum) -> {
-            List<Map<String, Object>> resultList;
-
-            if (rs.next()) {
-                resultList = new ArrayList<>();
-
 			ResultSetMetaData metaData = rs.getMetaData();
 			int columnCount = metaData.getColumnCount();
+			Map<String, Object> resultMap = new LinkedHashMap<>(columnCount);
 
-                do {
+			for (int i = 1; i <= columnCount; i++) {
-                    resultList.add(rowToMap(columnCount, metaData, rs));
+				String key = lookupColumnName(metaData, i);
-                } while (rs.next());
+				Object value = getResultSetRawValue(rs, i);
-            } else {
+				resultMap.put(key, value);
-                resultList = Collections.emptyList();
 			}
 
-            return resultList;
+			return resultMap;
 		});
 	}
 
 	@Override
 	public int update(String sql) throws DataAccessException {
-        XLog.debug(DBG_SQL_INFO, sql);
+		XLog.debug("Execute SQL: {0}", sql);
 
 		Connection connection = openConnection();
 		Statement statement = null;
@@ -145,10 +143,16 @@ public class JdbcTemplate implements JdbcOperations {
 		}
 	}
 
+	@Override
+	public int delete(String sql) throws DataAccessException {
+		return update(sql);
+	}
+
 	private Connection openConnection() {
 		try {
 			return getDataSource().getConnection();
-        } catch (SQLException ex) {
+		}
+		catch (SQLException ex) {
 			throw new CannotGetJdbcConnectionException("Could not get JDBC Connection", ex);
 		}
 	}
@@ -161,26 +165,13 @@ public class JdbcTemplate implements JdbcOperations {
 		return name;
 	}
 
-    private Map<String, Object> rowToMap(int columnCount, ResultSetMetaData metaData, ResultSet rs) throws SQLException {
-        Map<String, Object> rowMap = new LinkedHashMap<>(columnCount);
-
-        for (int i = 1; i <= columnCount; i++) {
-            String key = lookupColumnName(metaData, i);
-            Object value = getResultSetRawValue(rs, i);
-            rowMap.put(key, value);
-        }
-
-        return rowMap;
-    }
-
 	private Object getResultSetRawValue(ResultSet resultSet, int index) throws SQLException {
 		Object obj = resultSet.getObject(index);
-        if (obj == null) {
+		String className = null;
-            return null;
+		if (obj != null) {
+			className = obj.getClass().getName();
 		}
 
-        String className = obj.getClass().getName();
-
 		if (obj instanceof Blob) {
 			Blob blob = (Blob) obj;
 			obj = blob.getBytes(1, (int) blob.length());
@@ -189,17 +180,19 @@ public class JdbcTemplate implements JdbcOperations {
 			obj = clob.getSubString(1, (int) clob.length());
 		} else if ("oracle.sql.TIMESTAMP".equals(className) || "oracle.sql.TIMESTAMPTZ".equals(className)) {
 			obj = resultSet.getTimestamp(index);
-        } else if (className.startsWith("oracle.sql.DATE")) {
+		} else if (className != null && className.startsWith("oracle.sql.DATE")) {
 			String metaDataClassName = resultSet.getMetaData().getColumnClassName(index);
 			if ("java.sql.Timestamp".equals(metaDataClassName) || "oracle.sql.TIMESTAMP".equals(metaDataClassName)) {
 				obj = resultSet.getTimestamp(index);
-            } else {
+			}
+			else {
 				obj = resultSet.getDate(index);
 			}
-        } else if (obj instanceof Date
+		} else if (obj instanceof Date) {
-                && "java.sql.Timestamp".equals(resultSet.getMetaData().getColumnClassName(index))) {
+			if ("java.sql.Timestamp".equals(resultSet.getMetaData().getColumnClassName(index))) {
 				obj = resultSet.getTimestamp(index);
 			}
+		}
 
 		return obj;
 	}

src/test/java/ghast/database/JdbcTemplateTest.java

@@ -17,7 +17,6 @@ import java.sql.SQLException;
 import java.text.MessageFormat;
 import java.util.List;
 import java.util.Map;
-import java.util.Optional;
 import java.util.StringJoiner;
 import java.util.logging.Logger;
 import java.util.stream.Collectors;
@@ -85,7 +84,7 @@ class JdbcTemplateTest {
 	}
 
 	@Test
-    void testQuery_Simple_Single() {
+	void testQuery_Single() {
 		String sql = MessageFormat.format("SELECT {2} FROM {0} WHERE {1} LIKE ''{3}''",
 				TABLE_NAME, COLUMN_NAME, COLUMN_VALUE, DATA[0][0]);
 
@@ -101,41 +100,44 @@ class JdbcTemplateTest {
 	}
 
 	@Test
-    void testQuery_Simple_Optional() {
+	void testQuery_List() {
-        String sql = MessageFormat.format("SELECT {2} FROM {0} WHERE {1} LIKE ''{3}''",
-                TABLE_NAME, COLUMN_NAME, COLUMN_VALUE, DATA[0][0]);
-
-        Optional<Integer> optValue = jdbcTemplate.queryOne(sql, rs -> rs.getInt(1));
-
-        assertTrue(optValue.isPresent());
-        assertEquals(DATA[0][1], optValue.get());
-    }
-
-    @Test
-    void testQuery_Simple_List() {
 		String sql = MessageFormat.format("SELECT {2} FROM {0} WHERE {1} LIKE ''{3}'' OR {1} LIKE ''{4}''",
 				TABLE_NAME, COLUMN_NAME, COLUMN_VALUE, DATA[0][0], DATA[1][0]);
 
-        List<Integer> listValues = jdbcTemplate.queryList(sql, (rs, rowNum) -> rs.getInt(1));
+		List<Integer> listValues = jdbcTemplate.query(sql, (rs, rowNum) -> rs.getInt(1));
 
 		assertIterableEquals(Lists.newArrayList(DATA[0][1], DATA[1][1]), listValues);
 	}
 
 	@Test
-    void testQuery_Object_Single() {
+	void testQueryForObject() {
+		class Player {
+			String name;
+			int value;
+
+			@Override
+			public boolean equals(Object o) {
+				if (this == o) return true;
+				if (!(o instanceof Player)) return false;
+				Player player = (Player) o;
+				return new EqualsBuilder().append(value, player.value).append(name, player.name).isEquals();
+			}
+
+			@Override
+			public int hashCode() {
+				return new HashCodeBuilder(17, 37).append(name).append(value).toHashCode();
+			}
+		}
+
 		String sql = MessageFormat.format("SELECT {1}, {2} FROM {0} WHERE {1} LIKE ''{3}''",
 				TABLE_NAME, COLUMN_NAME, COLUMN_VALUE, DATA[0][0]);
 
-        Player actualPlayer = jdbcTemplate.query(sql, rs -> {
+		Player actualPlayer = jdbcTemplate.queryForObject(sql, (rs, rowNum) -> {
-            if (rs.next()) {
 			Player player0 = new Player();
 			player0.name = rs.getString(COLUMN_NAME);
 			player0.value = rs.getInt(COLUMN_VALUE);
 
 			return player0;
-            } else {
-                return null;
-            }
 		});
 
 		Player expectedPlayer = new Player();
@@ -145,34 +147,6 @@ class JdbcTemplateTest {
 		assertEquals(expectedPlayer, actualPlayer);
 	}
 
-    @Test
-    void testQuery_Object_List() {
-        String sql = MessageFormat.format("SELECT {1}, {2} FROM {0}",
-                TABLE_NAME, COLUMN_NAME, COLUMN_VALUE);
-
-        List<Player> actualPlayers = jdbcTemplate.queryList(sql, (rs, num) -> {
-            Player player0 = new Player();
-            player0.name = rs.getString(COLUMN_NAME);
-            player0.value = rs.getInt(COLUMN_VALUE);
-
-            return player0;
-        });
-
-
-        List<Player> expectedPlayers = Stream.of(DATA)
-                .map(datum -> {
-                    Player player1 = new Player();
-                    player1.name = (String) datum[0];
-                    player1.value = (int) datum[1];
-
-                    return player1;
-                })
-                .collect(Collectors.toList());
-
-
-        assertIterableEquals(expectedPlayers, actualPlayers);
-    }
-
 	@Test
 	void testQueryForMap() {
 		String sql = MessageFormat.format("SELECT {1}, {2} FROM {0} WHERE {1} LIKE ''{3}''",
@@ -188,11 +162,11 @@ class JdbcTemplateTest {
 	}
 
 	@Test
-    void testQueryForMapList() {
+	void testQueryForList() {
 		String sql = MessageFormat.format("SELECT {1}, {2} FROM {0}",
 				TABLE_NAME, COLUMN_NAME, COLUMN_VALUE);
 
-        List<Map<String, Object>> actualMapList = jdbcTemplate.queryForMapList(sql);
+		List<Map<String, Object>> actualMapList = jdbcTemplate.queryForList(sql);
 
 		List<Map<String, Object>> expectedMapList = Stream.of(DATA)
 				.map(datum -> ImmutableMap.of(COLUMN_NAME, datum[0], COLUMN_VALUE, datum[1]))
@@ -237,24 +211,6 @@ class JdbcTemplateTest {
 		jdbcTemplate.execute("DROP TABLE IF EXISTS " + TABLE_NAME);
 	}
 
-    class Player {
-        String name;
-        int value;
-
-        @Override
-        public boolean equals(Object o) {
-            if (this == o) return true;
-            if (!(o instanceof Player)) return false;
-            Player player = (Player) o;
-            return new EqualsBuilder().append(value, player.value).append(name, player.name).isEquals();
-        }
-
-        @Override
-        public int hashCode() {
-            return new HashCodeBuilder(17, 37).append(name).append(value).toHashCode();
-        }
-    }
-
 	@Nested
 	class JdbcTemplateTest_ExecuteTestCase {