Average Essentials

This plugin provides some "essential" features such as region management, chat coloring and prefixes, broadcasts and many more QoL utilities for server hosts.

266.0 загрузок

Обновлён 6 дней назад

Улучшение Качества Жизни Утилиты Разное

Описание

Кинетический хостинг: Посмотрите на моего хостинг-партнера! Они предлагают быстрый, доступный хостинг с отличной поддержкой клиентов!

Средние значения

Средние значения Это легкий Java-плагин для серверов Hytale, построенный с помощью Gradle, предназначенный для улучшения функциональности основного сервера с необходимыми инструментами для управления игроками, связи и администрирования.

Особенности

Управление чатами

Чат форматированиеАвтоматически форматирует сообщения в чате с групповыми префиксами. Отображает наиболее взвешенный префикс группы разрешений вместе с именем пользователя и сообщением игрока для чистого, организованного чата.
Система фильтрации чатаПродвинутая модерация контента с трехуровневой фильтрацией:
- Запрещенные терминыАвтоматический запрет для игроков, которые используют определенные запрещенные условия. Игроки, использующие запрещенные слова, мгновенно отключаются и навсегда блокируются с сервера.
- Поддающиеся контролю термины: Автоматически цензурировать (заменить на ****) определенные слова, позволяя при этом отправлять сообщение, обеспечивая менее разрушительный подход к модерации.
- Съемные условияМолча блокировать сообщения, содержащие ограниченные слова, и уведомлять игрока о том, что сообщение не разрешено. Сообщения не отправляются другим игрокам.
- Обсуждение Regex Pattern: Все фильтры используют чувствительный к регистру шаблон, соответствующий обнаружению границы слова для точной и гибкой фильтрации.
Поддержка цветового кода: Цветовые коды в стиле Parses Minecraft (&0-&f для цветов, &l для жирных) в сообщениях и префиксах для форматирования насыщенного текста. Необязательно отключать цветовые коды в чате на конфигурацию.
Конфигурируемое вещаниеЗапланированные трансляции с настраиваемой частотой и сообщениями, езда на велосипеде через очередь для разнообразия.

Администрация

Управление плагинамиОбеспечивает комплексные команды для перечисления, загрузки, разгрузки, перезагрузки и управления плагинами непосредственно с консоли сервера или в игре.
Управление группойПозволяет администраторам устанавливать и управлять префиксами для групп разрешений, хранящихся в настраиваемых файлах JSON.
Информационные сообщенияПоддерживает приветственные сообщения для новых игроков, периодические трансляции для всех онлайн-игроков и динамические команды для быстрого распространения информации (например, ссылки Discord).

Игровые сервисы

Домашняя системаПозволяет игрокам устанавливать, телепортироваться, перечислять и удалять личные домашние местоположения с настраиваемыми ограничениями на основе разрешений. Неограниченные дома для операторов.
Никнейм МенеджментПозволяет игрокам и администраторам устанавливать пользовательские прозвища с поддержкой очистки прозвищ обратно к именам пользователей по умолчанию.
Управление регионом: Расширенная региональная система подачи заявок и управления:
- Заявлять и управлять земельными регионами с точным контролем уровня блоков
- Безопасная телепортация в заявленных регионах
- Конфигурируемые разрешения на взаимодействие (блок-брейк, место, взаимодействие)
- Визуализация границ региона и управление
- Поддержка совместного использования и совместного землепользования в регионе

Требования

Hytale Server (последняя версия API)
Java 8 или выше
Стелла для строительства (входит в проект)

установка

Скачать последнюю версию JAR (версия 0.2.7) из раздела релизов.
Поместите файл JAR в каталог плагинов вашего сервера.
Перезагрузите сервер, чтобы загрузить плагин.
Настройка групп, сообщений, передач, домашних ограничений, встраивания ссылок и других настроек через сгенерированные файлы конфигурации JSON в Моды/Средние значения/.

Новый в v0.2.7

Опция встраивания ссылок с настраиваемыми настройками предварительного просмотра
Обновленный Hytale Совместимость зависимостей сервера
Улучшенная функциональность домашней и чат-системы

конфигурация

Конфигурация фильтра чата (Chat Filter Configuration)`чат json`)

Фильтр чата очень настраиваемый и позволяет администраторам определять три уровня модерации контента:

{
"конфиг": {
"Запрещаемые термины": ["badword1", "badword2"],
"termsToCensor": ["mildword1", "mildword2"],
"termsToDisable": ["restrictedword1", "restrictedword2"],
«AlllowUsersToUseChatColorCodes»: правда
?
?

Варианты конфигурации:

подлежащий запрету Условия (Стринг[]): Множество терминов, которые вызывают автоматический постоянный запрет. Игроки, использующие эти слова, мгновенно отключаются и запрещаются. Используйте это для самых серьезных нарушений.
терминыЦензор (Стринг[]): Множество терминов, которые автоматически заменяются ***** в сообщениях чата. Сообщения доставляются игрокам. Используйте это для мягкой речи или предотвращения спама.
термины нетрудоспособный (Стринг[]): Множество ограниченных терминов, сообщения которых блокируются. Отправитель получает уведомление, но другие игроки не видят сообщения. Используйте это для поддержания актуальности темы или предотвращения конкретных обсуждений.
Разработчик:UseChatColorCodes (Булевский): Когда истинныйИгроки могут использовать цветовые коды в стиле Minecraft (&0-&f, &l и т. д.) в своих сообщениях. Когда ложныйЦветовые коды рассматриваются как простой текст. По умолчанию: истинный

Поведение фильтрации:

Все фильтры являются нечувствительный к делу Улавливать вариации капитализации
использование Обнаружение границ слова (регекс разрыва слов) для соответствия только целым словам, предотвращая ложные срабатывания (например, «тест» не будет совпадать в «тестировании»)
Фильтры обрабатываются в порядке: Bannable → Removable → Застрахованный
Если сообщение вызывает запретный термин, оно немедленно блокируется, и игроку запрещается.
Если он запускает съемный термин, сообщение блокируется, и игрок уведомлен.
Застрахованные условия применяются после прохождения других проверок

Конфигурация менеджера группы (`group.json`)

Настройка префиксов группы разрешений для форматирования чата:

{
"группы": {
"админ": {
"префикс": "&c [Admin]&r",
"вес": 100
?
"Модератор": {
«Приставка»: «&6[Mod]&r»,
"вес": 50
?
"член": {
«Приставка»: «&7[Member]&r»,
"вес": 1
?
?
?

весОпределяет приоритет, когда игрок имеет несколько групп. Более высокий вес = более высокий приоритет в чате.
префикс: Текст отображается перед именем игрока в чате, поддерживая цветовые коды.

Домашняя конфигурация (`Homes.json`)

Настройка домашних лимитов по умолчанию для игроков:

{
"DefaultMaxHomes": 3
?

Варианты конфигурации:

По умолчанию MaxHomes (целое число): Максимальное количество домов, которое может установить игрок. Это может быть отменено разрешениями (например, Средние значения.homes.limit.5 5 домов. Операторы имеют неограниченные дома по умолчанию. По умолчанию: 3

Никнейм Конфигурация`Прозвища.json`)

Прозвища игроков (автоматически управляемые, ручное редактирование не требуется):

{
"названия": {
"игрок-уид-1": "Крутой Ник",
«Игрок-uuid-2»: «Другой Ник»
?
?

Примечания:

Прозвища хранятся в виде карты UUID игроков на их пользовательские прозвища.
Этот файл автоматически обновляется, когда никнеймы устанавливаются или очищаются.
Редактирование вручную не рекомендуется, так как это может вызвать несоответствия.

Показать оригинальное описание (English)

Kinetic Hosting: Check out my game hosting partner! They offer fast, affordable hosting with excellent customer support!

AverageEssentials

AverageEssentials is a lightweight Java plugin for Hytale servers, built with Gradle, designed to enhance core server functionality with essential tools for player management, communication, and administration.

Features

Chat Management

Chat Formatting: Automatically formats player chat messages with group-based prefixes. Displays the highest-weighted permission group prefix alongside the player's username and message for a clean, organized chat experience.
Chat Filtering System: Advanced content moderation with three-tier filtering:
- Bannable Terms: Automatically ban players who use specified prohibited terms. Players using bannable words are instantly disconnected and permanently banned from the server.
- Censurable Terms: Automatically censor (replace with ****) specified words while allowing the message to be sent, providing a less disruptive moderation approach.
- Removable Terms: Silently block messages containing restricted words and notify the player that the message was not allowed. Messages are not sent to other players.
- Regex Pattern Matching: All filters use case-insensitive regex pattern matching with word boundary detection for accurate and flexible filtering.
Color Code Support: Parses Minecraft-style color codes (&0-&f for colors, &l for bold) in messages and prefixes for rich text formatting. Optionally disable color codes in chat per configuration.
Configurable Broadcasting: Scheduled broadcasts with customizable frequency and messages, cycling through a queue for variety.

Administration

Plugin Management: Provides comprehensive commands to list, load, unload, reload, and manage plugins directly from the server console or in-game.
Group Management: Allows administrators to set and manage prefixes for permission groups, stored in configurable JSON files.
Informational Messages: Supports welcome messages for new players, periodic broadcasts to all online players, and dynamic commands for quick information dissemination (e.g., Discord links).

Player Utilities

Home System: Allows players to set, teleport to, list, and delete personal home locations with configurable limits based on permissions. Supports unlimited homes for operators.
Nickname Management: Enables players and administrators to set custom nicknames, with support for clearing nicknames back to default usernames.
Region Management: Advanced region claiming and management system:
- Claim and manage land regions with precise block-level controls
- Safe teleportation within claimed regions
- Configurable interaction permissions (block break, place, interact)
- Region boundary visualization and management
- Supports region sharing and collaborative land management

Requirements

Hytale Server (latest API version)
Java 8 or higher
Gradle for building (included in the project)

Installation

Download the latest release JAR (version 0.2.7) from the releases section.
Place the JAR file in your server's plugins directory.
Restart the server to load the plugin.
Configure groups, messages, broadcasts, home limits, link embedding, and other settings via the generated JSON config files in mods/AverageEssentials/.

New in v0.2.7

Link embedding option with configurable preview settings
Updated Hytale Server dependency compatibility
Improved home and chat system functionality

Configuration

Chat Filter Configuration (`chat.json`)

The chat filter is highly configurable and allows administrators to define three levels of content moderation:

{
  "config": {
    "bannableTerms": ["badword1", "badword2"],
    "termsToCensor": ["mildword1", "mildword2"],
    "termsToDisable": ["restrictedword1", "restrictedword2"],
    "allowUsersToUseChatColorCodes": true
  }
}

Configuration Options:

bannableTerms (String[]): An array of terms that trigger an automatic permanent ban. Players using these words are instantly disconnected and banned. Use this for the most severe violations.
termsToCensor (String[]): An array of terms that are automatically replaced with **** in chat messages. Messages are still delivered to players. Use this for mild language or spam prevention.
termsToDisable (String[]): An array of restricted terms whose messages are silently blocked. The sender receives a notification but other players don't see the message. Use this for maintaining topic relevance or preventing specific discussions.
allowUsersToUseChatColorCodes (Boolean): When true, players can use Minecraft-style color codes (&0-&f, &l, etc.) in their messages. When false, color codes are treated as plain text. Default: true

Filtering Behavior:

All filters are case-insensitive to catch variations in capitalization
Uses word boundary detection (word break regex) to match whole words only, preventing false positives (e.g., "test" won't match in "testing")
Filters are processed in order: Bannable → Removable → Censurable
If a message triggers a bannable term, it's immediately blocked and the player is banned
If it triggers a removable term, the message is blocked and the player is notified
Censurable terms are applied after other checks pass

Group Manager Configuration (`group.json`)

Configure permission group prefixes for chat formatting:

{
  "groups": {
    "admin": {
      "prefix": "&c[Admin]&r",
      "weight": 100
    },
    "moderator": {
      "prefix": "&6[Mod]&r",
      "weight": 50
    },
    "member": {
      "prefix": "&7[Member]&r",
      "weight": 1
    }
  }
}

weight: Determines priority when a player has multiple groups. Higher weight = higher priority in chat display.
prefix: The text displayed before the player's name in chat, supporting color codes.

Home Configuration (`homes.json`)

Configure default home limits for players:

{
  "defaultMaxHomes": 3
}

Configuration Options:

defaultMaxHomes (Integer): The default maximum number of homes a player can set. This can be overridden by permissions (e.g., averageessentials.homes.limit.5 for 5 homes). Operators have unlimited homes by default. Default: 3

Nickname Configuration (`nicknames.json`)

Stores player nicknames (automatically managed, no manual editing required):

{
  "nicknames": {
    "player-uuid-1": "CoolNick",
    "player-uuid-2": "AnotherNick"
  }
}

Notes:

Nicknames are stored as a map of player UUIDs to their custom nicknames.
This file is automatically updated when nicknames are set or cleared.
Manual editing is not recommended as it may cause inconsistencies.

Последние версии