Skip to main content

First Setup

Create your first faction and learn the basics.

First Setup

This guide walks you through creating your first faction, claiming land, and inviting members.

For Server Owners

Before players can use factions, permissions must be configured. HyperFactions denies all access by default. See the Permissions Reference for setup instructions.


Creating Your First Faction

Step 1: Create a Faction

Use the create command with your desired faction name:

/f create MyFaction

Info

Faction names must be 3-24 characters and can only contain letters, numbers, and underscores.

Congratulations! You're now the Leader of your new faction.

Step 2: Open the Faction GUI

Access the main faction interface:

/f

or

/f menu

This opens the interactive GUI where you can:

  • View faction statistics
  • Manage members
  • Access the chunk map
  • Configure faction settings

Claiming Your First Territory

Step 3: Claim Land

Stand in the chunk you want to claim and run:

/f claim

Chunk Size

Each claim covers one chunk (32x32 blocks).

Step 4: View the Map

Open the chunk management GUI to see your territory:

/f map

The map shows a 15x15 chunk grid with your claims highlighted in your faction color.

Step 5: Set Your Faction Home

While standing where you want your faction's home to be:

/f sethome

Now faction members can teleport here with /f home.

Inviting Members

Step 6: Invite a Player

To invite someone to your faction:

/f invite PlayerName

The invited player will receive a notification and can accept with:

/f accept

Info

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

Step 7: Manage Members

As the Leader, you can:

Promote to Officer:

/f promote PlayerName

Demote to Member:

/f demote PlayerName

Kick a Member:

/f kick PlayerName

Understanding Roles

Your faction has three roles with different permissions:

Leader (You)

  • Full control over the faction
  • Set faction home
  • Promote/demote members
  • Transfer leadership
  • Disband faction
  • Manage all diplomatic relations
  • Configure faction territory permissions

Officer

  • Invite new players
  • Kick Members (not Officers)
  • Manage diplomatic relations
  • Claim/unclaim territory
  • Use overclaim

Member

  • Claim territory (with permission)
  • Use faction home
  • View faction info
  • Participate in chat

Setting Up Diplomacy

Ally Another Faction

To form an alliance:

/f ally OtherFaction

The other faction's leader must also run /f ally YourFaction to confirm.

Allied factions get:

  • No friendly fire between members
  • Shared land access (if configured)
  • Alliance chat communication

Declare an Enemy

To mark a faction as an enemy:

/f enemy OtherFaction

Enemy factions:

  • Full PvP enabled
  • Can be overclaimed (if enabled)
  • Marked in red on maps

Customizing Your Faction

Set a Description

/f desc This is our faction's description!

Set a Faction Color

/f color #FF5500

The color appears on maps and in chat.

Open/Close Membership

Allow anyone to join:

/f open

Require invitations:

/f close

Configure Territory Permissions

Faction leaders (and Officers if allowed) can configure what actions are allowed in their territory using the settings command:

/f settings

This opens a GUI where you can toggle various flags for building, interaction, combat, and more. See Factions for details on territory permissions.

Quick Reference

TaskCommand
Create faction/f create <name>
Open menu/f
Claim chunk/f claim
View map/f map
Set home/f sethome
Go home/f home
Invite player/f invite <player>
View faction info/f info
List all factions/f list
Escape hostile territory/f stuck

Next Steps

Now that you have a faction:

  1. Learn about the Power System that controls how much land you can claim
  2. Understand Territories for strategic land control
  3. Set up Diplomacy with other factions
  4. Review all Commands for complete control
  5. Check the Permissions Reference to understand access control

Player Guides

For in-depth strategies: