HTDevLib
A comprehensive utility library for Hytale plugin development, providing tested helpers and utilities that simplify common modding tasks.
3.3 тысяч загрузок
Обновлён 9 дней назад
Описание
HytaleDevLib Полезная библиотека для разработчиков
Комплексная библиотека утилит для разработки плагинов Hytale, которая упрощает общие задачи моддинга с проверенными классами помощников и интуитивно понятными API.
️️ Раннее развитие: Это работа, которая ведется с большим количеством запланированных! Не стесняйтесь вносить предложения по вопросам GitHub.
Сайт и документация
Ключевые особенности
WorldHelper
- Система времени и дня - Получить / установить время игры, проверить день / ночь, отслеживать фазы луны
- Отслеживание клещей - Расписание отложенных действий и интервальные обратные вызовы
- Управление игроками - Легкий поиск игроков и обмен сообщениями
- Операции Thread-Safe Безопасный мир манипуляции с любой нитью
EntityHelper
- NPC Spawing - Спаун любой NPC по имени с правильной настройкой ECS
- Игровые сервисы Найти игроков по имени / UUID, получить позиции, рассчитать расстояния
- Управление предприятием - Переменные объекты, контрольная близость, телепортируемые объекты
- Тип обнаружения - Имена типов считываемых объектов (например, "Корова", "Skeleton_Fighter")
ZoneHelper
- Отслеживание Zone Discovery Отслеживайте зоны, которые обнаружил каждый игрок.
- Текущие запросы зоны - Получите текущую зону игрока или проверьте, находятся ли они в определенной зоне.
- Поиск игроков в зоне Найдите всех игроков в определенной зоне
- Статистика зон Получите количество открытий, все открытые зоны и популярность зоны
- Безопасное хранение Отслеживание на основе имени пользователя с параллельными коллекциями
BlockHelper
- Названные операции - Ссылки на блоки в стиле Minecraft (например, «Rock_Stone»)
- Разрешение динамических блоков - Использует собственную игровую систему для автоматической совместимости
- Мировое редактирование Заполните области, замените блоки, найдите блоки по типу
- Автоматическая клиентская синхронизация Изменения блоков мгновенно видны игрокам
Блокировать StateHelper
- Блок управления государством Работа с сундуками, знаками и другими государственными блоками
- Доступ к контейнеру - Легкий доступ к запасам грудной клетки и другим контейнерам
- Стойкость государства Марк заявляет о сохранении для обеспечения сохранения данных
- Доказательство будущего Аннотация к книге BlockState API
Помощник
- Пункт Создание - Создание стеков элементов с определенными количествами
- Управление контейнерами - Добавлять, удалять, считать предметы в контейнерах
- Случайное размещение слота - Заполните контейнеры предметами в случайных слотах для разнообразия добычи
- Инвентарные запросы - Проверяйте пространство, подсчитывайте предметы, получайте информацию о предметах
- Сброшенный элемент управления предприятием - Получите все упавшие предметы, отфильтровать по типу/радиусу, удалить предметы, телепортировать предметы
- Пункт Телепортация Телепортировать предметы игрокам
- Пункт Очистка Подсчитывать и удалять определенные типы предметов из мира
Исполнитель
- Упрощенные события - Нет ручной записи событий
- События с участием игрока - Бросить, забрать и создать обнаружение с доступом к сущности игрока
- Игровые события - чат-сообщения, отслеживание соединения/отключения
- Парсинг транзакций - Автоматический анализ транзакций инвентаризации
- Интеграция - Статистика игроков доступа непосредственно в обратном вызове событий элемента
Исполнитель: EcsEventHelper
- Блокировать события с участием игрока - Отслеживание поломок, мест и повреждений с доступом к объекту игрока
- Прогресс в горнодобывающей промышленности Отслеживание прогресса майнинга и взаимодействия блоков с конкретными игроками
- BlockDamageКонтекст - Доступ к чтению/записи для множителей скорости майнинга
- Фильтрация типа Gather - фильтр по категориям блоков (камни, леса, почвы и т.д.)
- Умножители скорости майнинга - Внедрение заклинаний эффективности и индивидуальной механики майнинга
- Зона обнаружения Обнаружение карты с метаданными зоны
- ECS интеграция Автоматическая система регистрации событий для игроков
- Умная фильтрация Фильтры ложных срабатываний (например, «пустые» блоки)
Смертельный помощник
- Организация Death Tracking Отслеживайте смерти лиц с исчерпывающей информацией
- Информация об убийцах Получить сущность убийцы (игрок, NPC или окружающая среда)
- Источник повреждения - Получить источник повреждения и как они умерли
- Позиция смерти - Получить координаты, где существо умерло
- Автоматическое разрешение имени Имена игроков и имена ролей NPC
Статсхелпер
- Управление статистикой организаций - Получить / установить здоровье, выносливость, мана, кислород и любой пользовательский статус
- Модификаторы Stat - Добавить аддитивные или мультипликативные баффы/дебаффы к статистике
- Методы удобства Быстрый доступ к общей статистике (здоровье, выносливость, мана, кислород)
- Запросы Stat Получите значения min/max, проценты, проверьте, существует ли статистика
- Операции Min/Max Максимизация, минимизация или сброс статистики по умолчанию
- Автозажим Значения автоматически остаются в пределах min/max
изобретатель
- Управление пунктами - Давать, удалять, считать предметы с количественной поддержкой
- Инвентарные проверки - Есть пункт, полный, получить активный горячий пункт
- Игровые операции - Чистый инвентарь, проверяем пропускную способность
- Безопасный API Безопасные операции с надлежащей обработкой ошибок
PlayerHelper
- сообщение Отправляйте сообщения игрокам
- Разрешения Проверьте разрешения игроков с значениями по умолчанию
- Режим игры - Режим игры Get/set Player (Creative, Adventure)
- Блок таргетинга - Получить блоки игрок смотрит с информацией о расстоянии
- Игровые данные - Получите игровой компонент и данные о коже
- Проверка типа Проверьте, является ли компания игроком
помощник
- Пользовательское управление страницами - Открытые/закрытые пользовательские страницы пользовательского интерфейса
- Контроль HUD - Показать/скрыть компоненты HUD
- Анимация Fade Плавные эффекты в/вне элементов пользовательского интерфейса
- Переходы UI - Создание полированного пользовательского опыта
Оригинальное название: Helper
- Уведомления о заголовке на экране Отображение основных и второстепенных титулов игрокам
- Основные титулы Крупные, заметные уведомления о важных событиях
- Незначительные титулы Меньшие, тонкие уведомления для менее важной информации
- Иконки на заказ Добавьте иконки в заголовки из путей активов
- Анимация Fade - Контроль за выцветанием и выцветанием
- Контроль продолжительности Установите, как долго заголовки отображаются на экране
Лутхелпер
- Пользовательский блок Drops - Отменить блокировку по умолчанию с пользовательскими элементами
- Таблицы для лута Регистрируйте пользовательский лут для определенных типов блоков
- Физические объекты - Заросшие предметы с надлежащей физикой и столкновением
- Гибкая логика добычи - Процентные, взвешенные, глубинные и условные капли
ContainerHelper
- Отслеживание контейнеров - Отслеживание изменений в сундуках, печах и других контейнерах
- Контейнерные операции API Автоматический анализ транзакций с помощью чистого API
- Отмена сделки Отменить транзакции, чтобы предотвратить изменения элемента с автоматической реверсией
- Авторегистрация Автоматически отслеживать все контейнеры по мере их размещения / уничтожения.
- Обнаружение Shift-Click Правильно обнаруживает ADDED vs REMOVED для переноса кликов
- Защита грудной клетки - Создание систем защиты и журналирование предметов
Оборудование Помощник
- Отслеживание оборудования - Трековая броня, утилита/оффхенд и изменения инструмента для любой LivingEntity
- оборудование Изменение API Структурированные объекты изменений со старыми / новыми предметами и информацией о слотах
- Обнаружение оборудования/оборудования Удобные помощники для обнаружения оборудования против необорудованных действий
- Поддержка Shift-Click - Работает как с перетаскиванием, так и с переключателем
ParticleHelper
- 535+ Системы частиц Доступ ко всем эффектам частиц Hytale по имени
- 2D и 3D нерест - частицы-спауны в положениях, блоках или объектах
- Контроль масштаба - Настройка размера частиц (1.0 = нормальный, 2.0 = двойной)
- Цветовая настройка - Встроенные цветовые пресеты для тонирования частиц
- Игровые частицы Показать частицы только конкретным игрокам
- Автоматическая очистка Временные частицы самоисчезают, петлевые эффекты сохраняются
SoundHelper
- 1156+ Звуковые события Доступ ко всем звуковым эффектам Hytale по имени
- 2D Звуки (UI/Global) Играйте звуки для всех игроков или конкретных игроков
- 3D Звуки (позиционные) Играть звуки на мировых позициях с затуханием расстояния
- Volume & Pitch Control - Настройка воспроизведения звука (1.0 = нормально)
- Звуковые категории - SFX, MUSIC, AMBIENT, VOICE, MASTER
- Игроко-специфическое аудио Играть звуки для отдельных игроков
КомпонентHelper
- Безопасная ECS Безопасный доступ к компонентам с нулевой обработкой
- Имена дисплеев Легкое управление именем организации
- Пункт Данные - Извлекать информацию о товаре из компонентов
Для владельцев серверов
Это а Библиотека Мод - он ничего не делает сам по себе. Установите его, только если другой плагин требует его в качестве зависимости.
Установка:
- Скачать HytaleDevLib JAR
- Место на вашем сервере
Модыпапка - Установите любые плагины, которые зависят от HytaleDevLib
- Перезагрузите свой сервер
Разработчики Mod
HytaleDevLib - это библиотека зависимостей для ваших плагинов. Он предоставляет необходимые утилиты без добавления функций геймплея, сохраняя ваш мод сосредоточенным на том, что делает его уникальным.
Документация
- Полный API Ссылка
- Руководство класса Helper
- Примеры кода и случаи использования
Поддержка и проблемы
- Проблемы GitHub: Сообщать об ошибках или запрашивать функции
- Вики: Полная документация
- Исходный код: Посмотреть на GitHub
Лицензия и кредиты
Автор: Шейнеекс
Лицензия: МТИ Лицензия
Версия: 0.4.2.2
Вы можете использовать этот мод в качестве зависимости от любого мода, который вы разрабатываете, до тех пор, пока загрузка остается размещенной в экосистеме CurseForge.
Показать оригинальное описание (English)
HytaleDevLib - Developer Utility Library
A comprehensive utility library for Hytale plugin development that simplifies common modding tasks with tested helper classes and intuitive APIs.
⚠️ Early Development: This is a work in progress with lots planned! Feel free to make suggestions in GitHub Issues.
Website & Documentation
Key Features
WorldHelper
- Time & Day System - Get/set game time, check day/night, track moon phases
- Tick Tracking - Schedule delayed actions and interval callbacks
- Player Management - Easy player lookups and messaging
- Thread-Safe Operations - Safe world manipulation from any thread
EntityHelper
- NPC Spawning - Spawn any NPC by name with proper ECS setup
- Player Utilities - Find players by name/UUID, get positions, calculate distances
- Entity Management - Iterate entities, check proximity, teleport entities
- Type Detection - Readable entity type names (e.g., "Cow", "Skeleton_Fighter")
ZoneHelper
- Zone Discovery Tracking - Track which zones each player has discovered
- Current Zone Queries - Get a player's current zone or check if they're in a specific zone
- Player-in-Zone Searches - Find all players currently in a specific zone
- Zone Statistics - Get discovery counts, all discovered zones, and zone popularity
- Thread-Safe Storage - Username-based tracking with concurrent collections
BlockHelper
- Name-Based Operations - Minecraft-style block referencing (e.g., "Rock_Stone")
- Dynamic Block Resolution - Uses game's native asset system for automatic compatibility
- World Editing - Fill regions, replace blocks, find blocks by type
- Automatic Client Sync - Block changes instantly visible to players
BlockStateHelper
- Block State Management - Work with chests, signs, and other stateful blocks
- Container Access - Easy access to chest inventories and other containers
- State Persistence - Mark states for saving to ensure data persists
- Future-Proof - Abstracts deprecated BlockState API
ItemHelper
- Item Creation - Create item stacks with specified quantities
- Container Management - Add, remove, count items in containers
- Random Slot Placement - Fill containers with items in random slots for loot variety
- Inventory Queries - Check space, count items, get item information
- Dropped Item Entity Management - Get all dropped items, filter by type/radius, remove items, teleport items
- Item Teleporting - Teleport items to players
- Item Cleanup - Count and remove specific item types from the world
EventHelper
- Simplified Events - No manual EventRegistry boilerplate
- Item Events with Player Entity - Drop, pickup, and crafting detection with player entity access
- Player Events - Chat messages, join/disconnect tracking
- Transaction Parsing - Automatic inventory transaction analysis
- Stat Integration - Access player stats directly in item event callbacks
EcsEventHelper
- Block Events with Player Entity - Break, place, and damage tracking with player entity access
- Mining Progress - Track mining progress and player-specific block interactions
- BlockDamageContext - Read/write access to block health for mining speed multipliers
- Gather Type Filtering - Filter by block categories (Rocks, Woods, Soils, etc.)
- Mining Speed Multipliers - Implement efficiency enchantments and custom mining mechanics
- Zone Discovery - Detect map exploration with zone metadata
- ECS Integration - Automatic system registration for player events
- Smart Filtering - Filters out false positives (e.g., "Empty" blocks)
DeathHelper
- Entity Death Tracking - Track entity deaths with comprehensive information
- Killer Information - Get killer entity (player, NPC, or environment)
- Damage Source - Get damage source and how they died
- Death Position - Get coordinates where entity died
- Automatic Name Resolution - Player usernames and NPC role names
StatsHelper
- Entity Stats Management - Get/set health, stamina, mana, oxygen, and any custom stat
- Stat Modifiers - Add additive or multiplicative buffs/debuffs to stats
- Convenience Methods - Quick access to common stats (health, stamina, mana, oxygen)
- Stat Queries - Get min/max values, percentages, check if stat exists
- Min/Max Operations - Maximize, minimize, or reset stats to defaults
- Auto-Clamping - Values automatically stay within min/max bounds
InventoryHelper
- Item Management - Give, remove, count items with quantity support
- Inventory Checks - Has item, is full, get active hotbar item
- Player Operations - Clear inventory, check capacity
- Safe API - Null-safe operations with proper error handling
PlayerHelper
- Messaging - Send messages to players
- Permissions - Check player permissions with default values
- Game Mode - Get/set player game mode (Creative, Adventure)
- Block Targeting - Get blocks player is looking at with distance info
- Player Data - Get player component and skin data
- Type Checking - Verify if entity is a player
UIHelper
- Custom Page Management - Open/close custom UI pages
- HUD Control - Show/hide HUD components
- Fade Animations - Smooth fade in/out effects for UI elements
- UI Transitions - Create polished user experiences
TitleHelper
- On-Screen Title Notifications - Display major and minor titles to players
- Major Titles - Large, prominent notifications for important events
- Minor Titles - Smaller, subtle notifications for less critical info
- Custom Icons - Add icons to titles from asset paths
- Fade Animations - Control fade-in and fade-out timing
- Duration Control - Set how long titles display on screen
LootHelper
- Custom Block Drops - Override default block drops with custom items
- Loot Tables - Register custom loot for specific block types
- Physical Item Entities - Spawn items with proper physics and collision
- Flexible Loot Logic - Percentage-based, weighted, depth-based, and conditional drops
ContainerHelper
- Container Tracking - Track item changes in chests, furnaces, and other containers
- ContainerTransaction API - Automatic transaction parsing with clean API
- Transaction Cancellation - Cancel transactions to prevent item changes with automatic reversion
- Auto-Registration - Automatically track all containers as they're placed/destroyed
- Shift-Click Detection - Properly detects ADDED vs REMOVED for shift-click transfers
- Chest Protection - Build protection systems and item logging
EquipmentHelper
- Equipment Tracking - Track armor, utility/offhand, and tool changes for any LivingEntity
- EquipmentChange API - Structured change objects with old/new items and slot info
- Equip/Unequip Detection - Convenience helpers for detecting equip vs unequip actions
- Shift-Click Support - Works with both drag/drop and shift-click equipping
ParticleHelper
- 535+ Particle Systems - Access to all Hytale particle effects by name
- 2D & 3D Spawning - Spawn particles at positions, blocks, or entities
- Scale Control - Customize particle size (1.0 = normal, 2.0 = double)
- Color Customization - Built-in color presets for particle tinting
- Player-Specific Particles - Show particles to specific players only
- Automatic Cleanup - Temporary particles auto-disappear, looping effects persist
SoundHelper
- 1,156+ Sound Events - Access to all Hytale sound effects by name
- 2D Sounds (UI/Global) - Play sounds to all players or specific players
- 3D Sounds (Positional) - Play sounds at world positions with distance attenuation
- Volume & Pitch Control - Customize sound playback (1.0 = normal)
- Sound Categories - SFX, MUSIC, AMBIENT, VOICE, MASTER
- Player-Specific Audio - Play sounds to individual players
ComponentHelper
- Type-Safe ECS - Safe component access with null handling
- Display Names - Easy entity name management
- Item Data - Extract item information from components
For Server Owners
This is a library mod - it doesn't do anything on its own. Install it only if another plugin requires it as a dependency.
Installation:
- Download HytaleDevLib JAR
- Place in your server's
Modsfolder - Install any plugins that depend on HytaleDevLib
- Restart your server
For Mod Developers
HytaleDevLib is designed to be a dependency library for your plugins. It provides the utilities you need without adding gameplay features, keeping your mod focused on what makes it unique.
Documentation
- Complete API Reference
- Helper Class Guides
- Code Examples & Use Cases
Support & Issues
- GitHub Issues: Report bugs or request features
- Wiki: Full documentation
- Source Code: View on GitHub
License & Credits
Author: ShaneeexD
License: MIT License
Version: 0.4.2
You may use this mod as a dependancy for any mod you develop, as long as the download remains hosted within the CurseForge ecosystem.
Последние версии
HYTALEDEVLIB-0.4.2.jar
Early Access
25.01.2026
163.5 КБ
HYTALEDEVLIB-0.4.1.jar
Early Access
21.01.2026
161.7 КБ
HYTALEDEVLIB-0.4.0.jar
Early Access
20.01.2026
151.4 КБ
HYTALEDEVLIB-0.3.5.jar
Early Access
19.01.2026
119.1 КБ
HYTALEDEVLIB-0.3.0.jar
Early Access
18.01.2026
97.0 КБ
Информация
Авторы:
Категории:
Версии игры:
Early Access
Создан: 16.01.2026
