Shared rules for permission-gated entries, priority, groups, conditions, and plugin hooks.

Permissions and conditions

Several BitAspire configs use the same matching pattern: define multiple entries, give each entry a permission or condition, and let priority decide the winner.

Common matching keys

Key	Meaning
`permission`	Permission required for this entry. Empty or missing often means fallback behavior.
`priority`	Higher numbers win when several entries match.
`group`	Optional grouping label used by features that resolve rank-like entries.
`conditions.permissions`	List of permissions that can select a profile.
`default`	Feature-specific fallback flag.
`enabled`	Master toggle for a section or entry.

Typical profile pattern

profiles:
  default:
    priority: 0
    conditions: {}

  staff:
    priority: 100
    conditions:
      permissions:
        - "example.staff"

In this model, staff wins over default only when the permission condition matches.

Typical permission entry pattern

join:
  default:
    public: '&7Welcome &e{player}&7!'

  staff:
    permission: join.staff
    priority: 100
    public: '&cStaff &f{player} &7joined.'

Use the fallback entry for everyone, then add higher-priority entries for staff, members, or special groups.

Plugin hooks

Some sections depend on optional plugins. Common examples:

Plugin	Common role
PlaceholderAPI	External placeholders in text.
Vault	Permission groups, chat metadata, prefixes, suffixes, and economy/chat integrations.
DiscordSRV or webhooks	Discord-facing output.
AuthMe, nLogin, OpeNLogin	Login-aware join/spawn flow.
SuperVanish, PremiumVanish, CMI, Essentials	Vanish-aware behavior.

Optional means the plugin can load without it, but the related hook may not do anything until the plugin is present.

Operational advice

Keep one fallback entry with low priority.
Give special entries explicit permissions.
Avoid equal priorities unless the feature documents deterministic tie-breaking.
Prefer descriptive permission nodes such as sirplus.scoreboard.staff.
Test with a real player account that has only the target permissions.

Permissions & Conditions