Integrations

HyperPerms integrates seamlessly with other plugins to provide enhanced functionality. Most integrations are automatic - just install both plugins and they'll work together.

Info: Integrations are detected automatically at server startup. No configuration is required for basic functionality, but you can customize behavior in config.json.

Supported Plugins

VaultUnlocked

Since v2.4.5 - Economy and chat prefix/suffix integration.

HyperPerms is the first Hytale permission plugin with full VaultUnlocked support. When VaultUnlocked is installed, HyperPerms automatically registers as a permission and chat provider, exposing prefix, suffix, and group data to any plugin that reads from Vault.

  • Zero configuration required - automatic registration on startup
  • Economy provider compatibility for shop and reward plugins
  • Chat prefix/suffix passthrough for chat formatting plugins

View VaultUnlocked Integration Guide

[HyperPerms] Detected VaultUnlocked - registering as permission and chat provider

PlaceholderAPI

Since v2.8.0 - Placeholder expansion for use in scoreboards, tab lists, chat, and more.

Available placeholders include:

  • %hyperperms_group% - Player's primary group name
  • %hyperperms_prefix% - Player's effective prefix
  • %hyperperms_suffix% - Player's effective suffix
  • %hyperperms_rank% - Player's rank display name
  • %hyperperms_groups% - Comma-separated list of all groups
  • %hyperperms_faction% - Player's faction name (requires HyperFactions)
[HyperPerms] Detected PlaceholderAPI - registering placeholder expansion

MysticNameTags

Since v2.8.3 - Tag cache synchronization for name tag display.

When MysticNameTags is installed, HyperPerms automatically syncs prefix and suffix changes with the name tag cache, ensuring that name tags update immediately when a player's group or prefix changes.

[HyperPerms] Detected MysticNameTags - enabling tag cache sync

WerChat

Since v2.5.0 - Chat channel integration.

When WerChat is detected, HyperPerms defers chat formatting to WerChat and provides permission data through its chat channel system. This prevents conflicts between the two plugins' chat handlers.

  • HyperPerms provides prefix/suffix data to WerChat channels
  • Chat handling is deferred to WerChat when installed
  • Channel-specific permissions supported
[HyperPerms] Detected WerChat - deferring chat handling to WerChat

HyperFactions

Faction permissions and chat integration with automatic prefixes, ranks, and placeholders.

View HyperFactions Integration Guide

HyperHomes

Since v2.3.5 - Permission aliasing for home management.

HyperPerms maps HyperHomes permission nodes (such as hyperhomes.gui) to the corresponding Hytale permission nodes, allowing server administrators to manage home permissions through the standard HyperPerms interface.

[HyperPerms] Detected HyperHomes - enabling permission aliasing

EssentialsPlus

Since v2.8.3 - Provider ordering compatibility.

When EssentialsPlus is installed, HyperPerms registers itself as the primary permission provider, ensuring that permission lookups are handled correctly even when multiple permission-aware plugins are present.

[HyperPerms] Detected EssentialsPlus - registering as primary provider

How Integrations Work

Automatic Detection

When HyperPerms starts, it checks for supported plugins. If a plugin is found, the integration is automatically enabled. You'll see messages in the console for each detected integration.

Configuration

Each integration has its own section in config.json. You can enable/disable specific features or customize formats without disabling the entire integration.

Placeholders

Integrations often add new placeholders for chat formatting. These work just like built-in placeholders and can be used in your chat format configuration.

Requesting Integrations

Want HyperPerms to integrate with another plugin? Let us know! We prioritize integrations based on community demand. Join our Discord to discuss integration ideas with the community.

Have an integration request or found an issue? Send us feedback or Join our Discord