promotional bannermobile promotional banner

Hyssential

All-in-one server toolkit: ranks, teleportation, homes, warps, private messaging, and staff chat

File Details

Hyssentials-2.0.0.jar

  • R
  • Jan 15, 2026
  • 291.08 KB
  • 1.2K
  • Early Access

File Name

Hyssentials-2.0.0.jar

Supported Versions

  • Early Access

Changelog

[2.0.0]

Added

Rank System

  • Full rank-based configuration system - Create unlimited custom ranks with unique settings
  • In-game rank management UI (/hyssentials rank) - Create, edit, and delete ranks without touching config files
  • Player rank assignment UI (/hyssentials assign) - Easily assign ranks to players
  • Per-rank command settings - Configure each command individually per rank:
    • Enable/disable commands
    • Custom cooldowns
    • Custom warmup delays
  • Per-rank home limits - Set different max homes for each rank
  • Rank priority system - Higher priority ranks take precedence
  • Granted permissions - Ranks can grant additional permissions from other plugins

Commands

  • /rtp (Random Teleport) - Teleport to a random safe location
    • Aliases: /randomtp, /wild
    • Finds safe locations automatically (solid ground with air above)
    • Fully configurable per-rank cooldowns and warmups
  • /hyssentials setrank <player> <rank> - Assign a rank to a player
  • /hyssentials removerank <player> <rank> - Remove a rank from a player
  • /hyssentials playerinfo <player> - View player's rank information
  • /hyssentials reload - Reload configuration without restart
  • /hyssentials assign - Open player rank assignment UI
  • Command alias - /hys now works as shortcut for /hyssentials

Teleport System

  • Warmup delays - Configurable delay before teleport executes (per-rank, per-command)
  • Movement cancellation - Moving during warmup cancels the teleport
  • Chunk preloading - Destination chunks are loaded before teleporting to prevent crashes

Documentation

  • Comprehensive HTML documentation

Changed

  • Configuration structure - Moved from hardcoded VIP/regular system to flexible JSON-based ranks
  • Cooldown system - Now uses rank-based settings instead of config-wide values
  • Home limits - Now determined by player's rank instead of VIP permission
  • TPA timeout - Now configurable per-rank
  • Config version - Bumped to 4 (auto-migrates from v3)

Fixed

  • Chunk loading crashes - Teleporting to unloaded chunks no longer breaks the game
  • Cooldown bypass - hyssentials.cooldown.bypass permission now properly bypasses warmups too

Migration

  • Automatic migration - Existing configs are automatically migrated to the new format
  • Backwards compatibility - Old permissions (hyssentials.vip, etc.) still work and map to the VIP rank

New Configuration Files

  • ranks.json - Rank definitions (new file)

Default Ranks

Rank Max Homes Cooldowns Warmup
Default 5 60s 3s
VIP 10 None None

New Permissions

Admin Permissions

  • hyssentials.admin.ranks - Access rank management UI
  • hyssentials.admin.setrank - Assign/remove ranks from players
  • hyssentials.admin.playerinfo - View player rank info
  • hyssentials.admin.reload - Reload configuration

Rank Permissions

  • hyssentials.rank.<id> - Assigns a rank to a player (e.g., hyssentials.rank.vip)

[1.2.0]

Added

  • VIP Permissions System - Grant players VIP benefits like more homes and reduced cooldowns

    • hyssentials.vip - Full VIP benefits (homes + cooldowns)
    • hyssentials.vip.homes - Extended homes limit only
    • hyssentials.vip.cooldown - Reduced cooldowns only
    • hyssentials.cooldown.bypass - Completely bypass all cooldowns
  • New Config Options

    • VipMaxHomes - Maximum homes for VIP players (default: 10)
    • VipHomeCooldownSeconds - Home cooldown for VIP players (default: 0)
    • VipWarpCooldownSeconds - Warp cooldown for VIP players (default: 0)
    • VipSpawnCooldownSeconds - Spawn cooldown for VIP players (default: 0)
    • VipBackCooldownSeconds - Back cooldown for VIP players (default: 0)

Changed

  • Config version bumped to 3 (auto-migrates from v2)
  • /homes command now shows correct max homes based on VIP status

[1.1.0] - Previous Release

  • Added cooldown system for teleport commands
  • Added configurable cooldowns for home, warp, spawn, and back commands

[1.0.0] - Initial Release

  • TPA system (tpa, tpahere, tpaccept, tpdeny, tpcancel)
  • Homes system (sethome, home, delhome, homes)
  • Warps system (setwarp, warp, delwarp, warps)
  • Spawn system (setspawn, spawn)
  • Back command with death location tracking
  • Admin teleport commands (htp, htphere)