Магазин плагинов Hytale

OnequeryFakeOnline — плагин для Hytale, который подменяет отображаемый онлайн в мониторингах и сервер-листах. К реальному числу игроков добавляется настраиваемое значение из диапазона FakePlayersMin–FakePlayersMax, при этом прибавка меняется плавно со временем (без резких скачков). Что умеет: Работает поверх существующего OneQuery. Поддерживает ответы протоколов v1 и v2. Работает и в обычном режиме, и в network/aggregate режиме. Автоматически не допускает ситуации, когда online > maxPlayers в ответе. Не влияет на фактический онлайн сервера, только на данные мониторинга/query. Идеально подходит для красивого и “живого” отображения онлайна в листингах.

Полноценная система PvP-дуэлей 1 на 1 с графическим интерфейсом, экономикой, ставками, аренами, китами, лидербордами и админ-панелью. Плагин поддерживает ставки валютой и ресурсами, автоматический подбор противников. ## Возможности ### Для игроков - **Графический UI** — полноценное HyUI-меню (`/duels menu`) с навигацией между экранами - **Приглашения** — вызов игрока на дуэль с выбором кита и ставки - **Автоподбор** — очередь с автоматическим поиском соперника - **Ставки** — валюта (EconomyAPI) или ресурсы из инвентаря - **Киты** — фиксированные наборы экипировки, голосование, рандом или свой инвентарь - **Арены** — автовыбор свободной арены с контролем границ - **Статистика** — победы, поражения, винрейт, серии, заработок - **Лидерборд** — топ по победам, заработку, сериям (с вкладками) - **Claim Box** — невостребованные предметы/валюта сохраняются и ждут игрока - **Реванш** — предложение повторного боя после завершения матча ### Для администраторов - **Админ-панель** (`/duels admin ui`) — управление через графический интерфейс - **Управление аренами** — создание, настройка позиций, границ, лобби - **Управление китами** — создание из текущего инвентаря, удаление - **Мониторинг** — активные матчи, очередь, логи аудита - **Принудительная остановка** — все матчи останавливаются с возвратом ставок - **Перезагрузка конфига** — горячая перезагрузка без рестарта сервера --- ## Команды ### Игровые | Команда | Описание | |---------|----------| | `/duels menu` | Открыть главное меню | | `/duels invite <игрок> [кит]` | Пригласить на дуэль | | `/duels accept` | Принять приглашение | | `/duels deny` | Отклонить приглашение | | `/duels queue` | Встать в очередь | | `/duels leave` | Покинуть очередь / матч | | `/duels surrender` | Сдаться | | `/duels rematch` | Предложить реванш | | `/duels wager <тип> <сумма>` | Установить ставку | | `/duels kit` | Выбрать кит | | `/duels stats [игрок]` | Статистика | | `/duels top` | Таблица лидеров | | `/duels claim` | Забрать награды | ### Административные | Команда | Описание | |---------|----------| | `/duels admin ui` | Открыть админ-панель | | `/duels admin reload` | Перезагрузить конфиг | | `/duels admin forcestop` | Принудительно завершить все матчи | | `/duels admin arena create <id>` | Создать арену | | `/duels admin arena pos1/pos2` | Установить точки спавна | | `/duels admin arena lobby` | Установить точку лобби | | `/duels admin arena enable <id>` | Включить/выключить арену | | `/duels admin arena list` | Список арен | | `/duels admin kit create <id>` | Создать кит из инвентаря | | `/duels admin kit delete <id>` | Удалить кит | | `/duels admin kit list` | Список китов | --- ## Права (Permissions) | Право | Описание | |-------|----------| | `duels.use` | Использование плагина | | `duels.invite` | Отправка приглашений | | `duels.queue` | Вход в очередь | | `duels.wager.currency` | Ставки валютой | | `duels.wager.resources` | Ставки ресурсами | | `duels.kit.select` | Выбор кита | | `duels.loadout.custom` | Свой набор экипировки | | `duels.stats` | Просмотр статистики | | `duels.admin` | Доступ к админ-командам | | `duels.admin.ui` | Доступ к админ-панели | | `duels.admin.force` | Принудительная остановка матчей | | `duels.admin.logs` | Просмотр логов аудита | --- ## Конфигурация Файл `config.json` создаётся при первом запуске. Основные секции: | Секция | Параметры | |--------|-----------| | **economy** | enabled, taxPercent, minBet, maxBet, operationTimeoutMs | | **resources** | enabled, allowedItemIds, blockedTags, maxStacksPerPlayer | | **escrow** | claimBoxEnabled, claimTtlDays, overflowPolicy | | **kits** | modeDefault, allowed, customLoadoutEnabled, defaultKitId | | **match** | countdownSeconds (1–10), maxDurationSeconds (30–1800), disconnectIsLoss, rematchTimeoutSeconds, requestTtlSeconds | | **queue** | enabled, maxWaitSeconds | | **arena** | autoSelect, boundaryEnforced, outOfBoundsPolicy (TELEPORT_BACK / KILL) | | **spectator** | enabled, maxPerArena | | **messages** | locale, fallbackLocales, enablePluralForms | | **observability** | metricsEnabled, blockedCommandsInDuel, alerts |

RollbackGuard записывает каждое изменение мира — постановку и разрушение блоков, перемещение предметов в инвентаре — и позволяет администраторам мгновенно откатить любой ущерб, нанесённый гриферами или ошибками. Возможности Логирование действий Постановка и разрушение блоков с сохранением полного состояния (тип блока до и после) Изменения инвентаря: добавление и удаление предметов с метаданными Привязка каждого действия к игроку, координатам и миру Инспектор блоков Режим инспектора (/rg inspect) — кликните по любому блоку, чтобы увидеть полную историю изменений: кто, когда и что сделал Поиск по истории Гибкие фильтры: по игроку, времени, радиусу, миру, типу действия Постраничный вывод результатов Откат и восстановление /rg rollback — откат действий по заданным фильтрам: блоки возвращаются в исходное состояние, предметы возвращаются/удаляются из инвентаря /rg restore — отмена отката, если он был выполнен по ошибке Режим предпросмотра (--dry-run) — узнайте, сколько действий будет затронуто, до выполнения Подтверждение крупных операций через токен (/rg confirm) Инвентарный откат При откате CONTAINER_ADD предмет удаляется из инвентаря игрока При откате CONTAINER_REMOVE предмет возвращается игроку Если игрок оффлайн — изменения ставятся в очередь и автоматически применяются при входе на сервер Политика конфликтов SKIP_CONFLICTS — пропускать блоки, изменённые после логируемого действия (безопасный режим) FORCE_APPLY — принудительно применять все изменения Хранилище данных SQLite из коробки — не требует дополнительных сервисов PostgreSQL для высоконагруженных серверов Автоматическая очистка старых записей по расписанию (настраиваемый retention) Производительность Асинхронная очередь записи с батч-вставками в БД Настраиваемый размер очереди, интервал сброса и размер батча Degraded mode — плагин продолжает работать даже при временной недоступности БД Конфигурация Полностью настраиваемый JSON-конфиг Локализация через внешний файл переводов (русский язык из коробки) Горячая перезагрузка конфига (/rg reload) Команды /rg inspect Включить/выключить режим инспектора /rg lookup [фильтры] Поиск действий по фильтрам /rg rollback <фильтры> Откатить действия /rg restore <jobId> Отменить откат /rg purge <время> Удалить старые записи /rg confirm <токен> Подтвердить операцию /rg status [jobId] Статус очереди / задачи /rg reload Перезагрузить конфиг Фильтры: player:<имя>, time:<30m|2h|7d>, radius:<число>, world:<мир>, action:<типы>

## 1) Что делает `NEI`? `NEI` добавляет GUI-браузер рецептов: - `Recipes` — где предмет является результатом крафта, - `Uses` — где предмет используется как ингредиент, - поиск по `item id` и `recipe id`, - кнопки поиска по предмету в руке (`Hand Recipe`, `Hand Uses`), - пагинация и автообновление индекса рецептов. ## 2) Какие команды доступны? - `/nei` — открыть GUI NEI. - `/neir` — открыть NEI в режиме `Recipes` для предмета в руке. - `/neiu` — открыть NEI в режиме `Uses` для предмета в руке. ## 3) Есть ли встроенные бинды клавиш внутри UI? Нет. В текущей версии встроенных UI-биндов нет. Если нужны горячие клавиши, можно назначить команды `/neir` и `/neiu` через `Controls -> Command Input` (если это поддерживается вашим клиентом/сборкой). ## 4) Нужен ли отдельный плагин `HyUI`? Нет. `HyUI` уже встроен в `NEI.jar`. ## 5) Как переключить язык интерфейса? В верхней части NEI есть кнопка `EN/RU`, она переключает язык интерфейса. ## 6) Как работают `Hand Recipe` и `Hand Uses`? - `Hand Recipe` ищет рецепты, где предмет в руке — результат. - `Hand Uses` ищет рецепты, где предмет в руке — ингредиент. Если рука пустая, выводится: `NEI: Hold an item in hand first.` ## 7) Как часто обновляется индекс рецептов? - Автоматически: каждые 15 секунд. - Вручную: кнопкой `Refresh Index` в GUI. ## 8) Почему не находятся рецепты? Проверьте: - сервер полностью загрузился, - у предмета корректный `item id`, - в поле поиска нет лишних символов, - после изменения модов нажмите `Refresh Index`. ## 9) Работает ли NEI с модами? Да. Индекс строится из общего стора рецептов, включая рецепты, добавленные модами.

## 1) Что делает этот мод `TheComplicator` усложняет ванильные крафты, но сохраняет ванильную цепочку прогрессии. Главная идея: - рецепт остается тем же по логике (те же предметы); - но количество ингредиентов становится больше; - эти новые значения видны сразу в интерфейсе верстака (актуальный UI). --- ## 2) Как это работает технически (простыми словами) При старте сервера мод: 1. Читает все крафт-рецепты из asset store. 2. Для каждого рецепта считает новый требуемый `input`. 3. Подменяет рецепты в store. 4. Клиент получает обновленные рецепты и показывает их в UI. Важно: - изменения применяются **на старте сервера**; - после правки `complicator.json` нужен **рестарт сервера**, чтобы увидеть новый баланс. --- ## 3) Где лежит конфиг После первого запуска создается файл: `mods/TheComplicator/complicator.json` Если файла нет: - проверь, что плагин загрузился без ошибок; - проверь `manifest.json` и `Main` класс; - проверь, что `TheComplicator.jar` лежит в папке плагинов сервера. --- ## 4) Полный разбор всех настроек Ниже перечислены все поля конфига, которые сейчас используются модом. ### `enabled` - Тип: `boolean` - По умолчанию: `true` - Что делает: включает/выключает подмену рецептов. - Если `false`: рецепты остаются ванильными. ### `baseExtraFactor` - Тип: `number` - По умолчанию: `0.60` - Диапазон (с учетом валидации): `0.0 .. 5.0` - Что делает: базовая надбавка для **всех** рецептов. ### `equipmentBonusFactor` - Тип: `number` - По умолчанию: `0.60` - Диапазон: `0.0 .. 5.0` - Что делает: доп. надбавка для рецептов, распознанных как экипировка. ### `advancedBonusFactor` - Тип: `number` - По умолчанию: `0.35` - Диапазон: `0.0 .. 5.0` - Что делает: доп. надбавка для “продвинутых” рецептов. ### `memoryLevelBonusFactor` - Тип: `number` - По умолчанию: `0.15` - Диапазон: `0.0 .. 2.0` - Что делает: доп. надбавка за каждый уровень `RequiredMemoriesLevel` выше 1. ### `maxTotalExtraFactor` - Тип: `number` - По умолчанию: `3.0` - Диапазон: `0.0 .. 10.0` - Что делает: ограничивает итоговый множитель сверху. ### `catalystPerCraft` - Тип: `integer` - По умолчанию: `2` - Минимум: `0` - Что делает: фиксированно добавляет стоимость к **первому ингредиенту** рецепта. ### `catalystOnlyForEquipment` - Тип: `boolean` - По умолчанию: `false` - Что делает: - `true` -> catalyst применяется только к экипировке; - `false` -> catalyst применяется ко всем рецептам. ### `advancedIngredientThreshold` - Тип: `integer` - По умолчанию: `3` - Минимум: `1` - Что делает: если в рецепте столько или больше разных входов, он считается advanced. ### `advancedCraftTimeSeconds` - Тип: `number` - По умолчанию: `1.0` - Диапазон: `0.0 .. 60.0` - Что делает: если `timeSeconds` рецепта больше/равно порогу, рецепт считается advanced. ### `equipmentKeywords` - Тип: `array<string>` - По умолчанию: список ключевых слов (sword, pickaxe, armor и т.д.) - Что делает: по этим словам мод понимает, что рецепт относится к экипировке. - Сравнение: по `recipeId` и `primaryOutput.itemId`, в lower-case. ### `excludedRecipeIds` - Тип: `array<string>` - По умолчанию: `[]` - Что делает: полностью исключает указанные рецепты из усложнения. - Удобно для стартовых предметов и "узких мест" прогрессии. --- ## 5) Формула расчета (самое важное) Для каждого ингредиента рецепта: 1. Считается итоговый множитель: `totalFactor = base + equipmentBonus + advancedBonus + memoryBonus` Где: - `equipmentBonus` добавляется только для equipment-рецептов; - `advancedBonus` только для advanced-рецептов; - `memoryBonus = (RequiredMemoriesLevel - 1) * memoryLevelBonusFactor` (если уровень > 1); - затем `totalFactor` ограничивается `maxTotalExtraFactor`. 2. Новое количество ингредиента: `newQty = baseQty + ceil(baseQty * totalFactor)` 3. Для первого ингредиента дополнительно: `newQty += catalystPerCraft` (если условия применения catalyst выполнены). --- ## 6) Как определяется equipment и advanced ### Equipment-рецепт Рецепт считается equipment, если хотя бы одно слово из `equipmentKeywords` встречается в: - `recipeId`, или - `primaryOutput.itemId`. ### Advanced-рецепт Рецепт считается advanced, если выполняется **хотя бы одно** условие: - число входных типов `>= advancedIngredientThreshold`; - есть `benchRequirement`; - `timeSeconds >= advancedCraftTimeSeconds`; - `RequiredMemoriesLevel > 1`. --- ## 7) Примеры расчета ### Пример A: обычный рецепт - База: `4 wood` - `totalFactor = 0.50` - Надбавка: `ceil(4 * 0.50) = 2` - Итог: `6 wood` ### Пример B: сложный рецепт + catalyst - База: `3 iron`, `2 leather` - `totalFactor = 0.90` - `iron`: `3 + ceil(3 * 0.90) = 6` - `leather`: `2 + ceil(2 * 0.90) = 4` - + `catalystPerCraft = 2` к первому ингредиенту -> `iron = 8` - Итог: `8 iron`, `4 leather` --- ## 8) Готовые пресеты конфига Ниже три заготовки. Вставь нужные значения в `complicator.json` и перезапусти сервер. ### Вариант 1: Легкий (чуть дольше ванилы) ```json { "enabled": true, "baseExtraFactor": 0.15, "equipmentBonusFactor": 0.15, "advancedBonusFactor": 0.10, "memoryLevelBonusFactor": 0.05, "maxTotalExtraFactor": 0.80, "catalystPerCraft": 0, "catalystOnlyForEquipment": true, "advancedIngredientThreshold": 4, "advancedCraftTimeSeconds": 2.0, "equipmentKeywords": ["sword", "axe", "pickaxe", "armor", "helmet", "boots"], "excludedRecipeIds": [] } ``` ### Вариант 2: Средний (рекомендованный) ```json { "enabled": true, "baseExtraFactor": 0.60, "equipmentBonusFactor": 0.60, "advancedBonusFactor": 0.35, "memoryLevelBonusFactor": 0.15, "maxTotalExtraFactor": 3.0, "catalystPerCraft": 2, "catalystOnlyForEquipment": false, "advancedIngredientThreshold": 3, "advancedCraftTimeSeconds": 1.0, "equipmentKeywords": [ "sword", "axe", "pickaxe", "shovel", "hoe", "hammer", "dagger", "bow", "crossbow", "staff", "wand", "shield", "helmet", "chestplate", "leggings", "boots", "armor", "tool", "weapon" ], "excludedRecipeIds": [] } ``` ### Вариант 3: Хардкор (долгая прогрессия) ```json { "enabled": true, "baseExtraFactor": 0.60, "equipmentBonusFactor": 0.60, "advancedBonusFactor": 0.35, "memoryLevelBonusFactor": 0.15, "maxTotalExtraFactor": 3.0, "catalystPerCraft": 2, "catalystOnlyForEquipment": false, "advancedIngredientThreshold": 3, "advancedCraftTimeSeconds": 1.0, "equipmentKeywords": [ "sword", "axe", "pickaxe", "shovel", "hoe", "hammer", "dagger", "bow", "crossbow", "staff", "wand", "shield", "helmet", "chestplate", "leggings", "boots", "armor", "tool", "weapon" ], "excludedRecipeIds": [] } ``` --- ## 9) Как правильно балансить (практика) Рекомендованный порядок: 1. Подними только `baseExtraFactor` до нужной сложности. 2. Потом отдельно усилить экипировку через `equipmentBonusFactor`. 3. Потом аккуратно добавить `advancedBonusFactor`. 4. `catalystPerCraft` трогай в конце, это часто сильно бьет по раннему геймплею. 5. Не забывай `excludedRecipeIds` для стартовых рецептов, если старт стал душным. --- ## 10) Частые проблемы и решения ### Проблема: В верстаке все еще ванильные рецепты Проверь: 1. Сервер был полностью перезапущен после правки конфига. 2. В логах есть строка загрузки `TheComplicator loaded ... recipesPatched=true`. 3. Нет другого мода, который позже перезаписывает те же рецепты. ### Проблема: Конфиг меняю, а ничего не меняется Причина: мод применяет изменения на старте. Решение: полный рестарт сервера после каждой правки `complicator.json`. ### Проблема: Старт игры стал слишком тяжелым Решение: - снизь `baseExtraFactor`; - поставь `catalystPerCraft = 0`; - добавь первые ключевые рецепты в `excludedRecipeIds`. ### Проблема: Слишком дорогая экипировка Решение: - уменьши `equipmentBonusFactor`; - сузь `equipmentKeywords`, чтобы меньше рецептов попадало в equipment-класс. ### Проблема: Мод не запускается Проверь: - корректность `manifest.json`; - что `TheComplicator.jar` в нужной папке плагинов; - что версия API совместима с твоим `HytaleServer.jar`. --- ## 11) Безопасные границы значений (рекомендация) Если не хочешь ломать экономику сервера: - `baseExtraFactor`: `0.15 .. 0.60` - `equipmentBonusFactor`: `0.15 .. 0.70` - `advancedBonusFactor`: `0.10 .. 0.40` - `memoryLevelBonusFactor`: `0.05 .. 0.20` - `catalystPerCraft`: `0 .. 2` - `maxTotalExtraFactor`: `1.0 .. 3.0` --- ## 12) Быстрый чеклист после настройки 1. Измени `complicator.json`. 2. Перезапусти сервер. 3. Проверь лог загрузки плагина. 4. Открой верстак и проверь 3-5 ключевых рецептов. 5. Подстрой коэффициенты. 6. Повтори цикл. --- ## 13) Минимальный рабочий конфиг (шаблон) ```json { "enabled": true, "baseExtraFactor": 0.35, "equipmentBonusFactor": 0.35, "advancedBonusFactor": 0.20, "memoryLevelBonusFactor": 0.10, "maxTotalExtraFactor": 2.0, "catalystPerCraft": 1, "catalystOnlyForEquipment": true, "advancedIngredientThreshold": 4, "advancedCraftTimeSeconds": 2.0, "equipmentKeywords": [ "sword", "axe", "pickaxe", "shovel", "hoe", "armor" ], "excludedRecipeIds": [] }

Античит для сервера Hytale