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
| Task | Command |
|---|---|
| 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:
- Learn about the Power System that controls how much land you can claim
- Understand Territories for strategic land control
- Set up Diplomacy with other factions
- Review all Commands for complete control
- Check the Permissions Reference to understand access control
Player Guides
For in-depth strategies:
- Starting a Faction - Tips for new faction leaders
- Growing Your Faction - Recruitment and expansion
- Diplomacy Strategy - Managing alliances
- Defending Territory - Protecting your claims