Skip to main content
PluginsFeaturesChangelogDocsDownloadCommunity

Member Management

Commands for inviting, kicking, and managing faction members.

Member Management Commands

These commands let you manage your faction's membership - inviting new players, removing members, and managing the role hierarchy.

Inviting Players

CommandDescriptionPermission
/f invite <player>Send a faction invitation to a playerhyperfactions.member.invite

Requirements:

  • Player must be online
  • Player must not be in a faction
  • Faction must not be at member limit
  • Officer or Leader role required

Info

Invitations expire after a configurable time (default: 5 minutes). The player must accept before it expires.

Accepting Invitations

CommandDescriptionPermission
/f acceptAccept a pending faction invitationhyperfactions.member.join
/f join <faction>Join an open factionhyperfactions.member.join

For the invited player:

  • Must have a pending invitation (for accept)
  • Target faction must be open (for join)
  • Must not already be in a faction
  • Joins as Member role

Kicking Members

CommandDescriptionPermission
/f kick <player>Remove a player from your factionhyperfactions.member.kick

Kick Hierarchy:

Your RoleCan Kick
LeaderAnyone (Officers and Members)
OfficerMembers only
MemberNo one

Warning

You cannot kick someone of equal or higher rank. Officers cannot kick other Officers.

Promoting Members

CommandDescriptionPermission
/f promote <player>Promote a Member to Officerhyperfactions.member.promote

Requirements:

  • Must be the Leader
  • Target must be a Member
  • Target becomes an Officer

Tip

Only promote players you trust. Officers have significant power including diplomacy and kicking.

Demoting Officers

CommandDescriptionPermission
/f demote <player>Demote an Officer to Memberhyperfactions.member.demote

Requirements:

  • Must be the Leader
  • Target must be an Officer
  • Target becomes a Member

Transferring Leadership

CommandDescriptionPermission
/f transfer <player>Transfer faction leadership to another memberhyperfactions.member.transfer

Transfer Process:

  1. Target becomes the new Leader
  2. You become an Officer
  3. Takes effect immediately

Irreversible

Leadership transfer cannot be undone by you. The new Leader must transfer back if desired.

Quick Reference

CommandDescriptionRole Required
/f invite <player>Invite playerOfficer+
/f acceptAccept invitationNon-member
/f join <faction>Join open factionNon-member
/f kick <player>Remove playerOfficer+
/f promote <player>Promote to OfficerLeader
/f demote <player>Demote to MemberLeader
/f transfer <player>Transfer leadershipLeader

Examples

Inviting a New Player

/f invite NewPlayer

NewPlayer receives: "You've been invited to join Warriors! Type /f accept to join."

# NewPlayer runs:
/f accept

NewPlayer is now a Member of Warriors.

Promoting a Trusted Member

/f promote TrustedPlayer

TrustedPlayer is now an Officer with expanded permissions.

Kicking a Problem Member

/f kick ProblemPlayer

ProblemPlayer is removed from the faction.

Handling Leadership Transition

/f transfer NewLeader

NewLeader is now the Leader. You're now an Officer.

Permission Summary

Member Management Permissions

PermissionDescriptionDefault
hyperfactions.member.inviteInvite playersfalse
hyperfactions.member.joinJoin factions / accept invitesfalse
hyperfactions.member.kickKick membersfalse
hyperfactions.member.promotePromote membersfalse
hyperfactions.member.demoteDemote officersfalse
hyperfactions.member.transferTransfer leadershipfalse
hyperfactions.member.leaveLeave factionsfalse

Workflow Examples

New Faction Setup

  1. Create faction: /f create MyFaction
  2. Invite friends: /f invite Friend1, /f invite Friend2
  3. They accept: /f accept
  4. Promote trusted players: /f promote Friend1

Dealing with Inactivity

  1. Check who's inactive via /f info
  2. Kick inactive members: /f kick InactivePlayer
  3. Invite active replacements: /f invite ActivePlayer

Leadership Succession

  1. Choose a trusted Officer (or promote someone first)
  2. Transfer: /f transfer NewLeader
  3. You remain as Officer under the new leadership

Best Practices

For Leaders

  • Vet new members - Check their history before promoting
  • Communicate promotions - Let the faction know about role changes
  • Plan succession - Have a backup plan for leadership

For Officers

  • Coordinate kicks - Discuss with Leader before kicking
  • Responsible inviting - Only invite players who fit the faction

For Everyone

  • Be active - Inactive members may be kicked
  • Follow rules - Respect the faction's guidelines
  • Communicate - Use faction chat to stay in touch

Related Topics

Edit this page on GitHub