Settings Commands

Commands for configuring faction settings.

Settings Commands

These commands allow Leaders and Officers to configure faction settings like name, description, color, and membership policy.

Renaming Your Faction

Command	Description	Permission
`/f rename <name>`	Change your faction's name	`hyperfactions.faction.rename`

Requirements:

Must be the Leader
New name must follow naming rules (3-24 chars, alphanumeric)
Name must not be taken by another faction

Warning

Renaming is visible to everyone. Previous name references may become outdated.

Setting Description

Command	Description	Permission
`/f desc <text>`	Set your faction's description	`hyperfactions.faction.description`

Requirements:

Officer or Leader role
Description appears in /f info

Example:

/f desc Warriors of the Northern Realm. Recruiting active players!

Setting Faction Tag

Faction tags are short abbreviations shown in chat next to player names. Tags are configured through the faction settings GUI.

Access via:

/f settings → Tag section
/f gui → Settings → Tag

Requirements:

Must be the Leader
Tag must be 1-5 alphanumeric characters

Info

Tags help identify faction members quickly in chat without displaying the full faction name.

Setting Faction Color

Command	Description	Permission
`/f color <hex>`	Set your faction's display color	`hyperfactions.faction.color`

Format: Use hex color codes with or without #

Examples:

/f color #FF5500
/f color FF5500
/f color #00FF00

Color appears in:

Territory map
Faction chat
GUI elements
Faction info display

Color Codes

Use a color picker tool to find hex codes. Common colors:

Red: #FF0000
Blue: #0000FF
Green: #00FF00
Yellow: #FFFF00
Purple: #800080
Orange: #FF8000

Opening Membership

Command	Description	Permission
`/f open`	Allow anyone to join without invitation	`hyperfactions.faction.open`

Requirements:

Must be the Leader
Anyone can join with /f join FactionName

Info

Open factions are good for recruiting but provide less control over membership.

Closing Membership

Command	Description	Permission
`/f close`	Require invitations to join	`hyperfactions.faction.close`

Requirements:

Must be the Leader
Players must be invited to join

This is the default state for new factions.

Territory Permissions

Territory permissions are managed through the faction settings GUI. Access the settings page to configure what actions are allowed in your faction's claimed territory.

Access via:

/f settings → Territory Permissions tab
/f gui → Settings → Territory Permissions

Available flag categories:

Combat: pvp_enabled, friendly_fire, projectile_damage, mob_damage
Building: build_allowed, block_interact
Interaction: door_use, container_use, bench_use, processing_use, seat_use
Items: item_drop, item_pickup
Damage: fall_damage, environmental_damage

For Server Owners

Territory permission flags require the hyperfactions.faction.permissions permission node to modify. Server administrators can lock certain flags via configuration.

See Zones for detailed flag descriptions and defaults.

Disbanding

Command	Description	Permission
`/f disband`	Dissolve your faction permanently	`hyperfactions.faction.disband`

Requirements:

Must be the Leader
Requires confirmation

Permanent

Disbanding cannot be undone. All claims are released and all members are removed.

Quick Reference

Command	Description	Role Required
`/f rename <name>`	Change faction name	Leader
`/f desc <text>`	Set description	Officer+
`/f color <hex>`	Set faction color	Officer+
`/f open`	Allow free joining	Leader
`/f close`	Require invitations	Leader
`/f settings`	Open settings GUI (includes tags and territory flags)	Officer+
`/f disband`	Dissolve faction	Leader

Examples

Complete Faction Setup

Set a description:

/f desc Elite PvP faction. Must have 100+ hours.

Choose a color:
```
/f color #FF0000
```
Set a tag via the settings GUI:
```
/f settings
```
Navigate to the Tag section and enter your desired tag (e.g., "ELITE").
Keep it invite-only:
```
/f close
```

Rebranding

New name:
```
/f rename Phoenix
```

Updated description:

/f desc Risen from the ashes. Stronger than ever.

New color:
```
/f color #FF8800
```

Recruiting Phase

/f desc Looking for active players! Beginners welcome.
/f open

Now anyone can join. Close it after recruiting:

/f close

Permission Summary

Settings Permissions

Permission	Description	Default
`hyperfactions.faction.rename`	Rename the faction	false
`hyperfactions.faction.description`	Set faction description	false
`hyperfactions.faction.tag`	Set faction tag	false
`hyperfactions.faction.color`	Set faction color	false
`hyperfactions.faction.open`	Open faction membership	false
`hyperfactions.faction.close`	Close faction membership	false
`hyperfactions.faction.settings`	Open faction settings GUI	false
`hyperfactions.faction.disband`	Disband faction	false

Info

While these permissions allow attempting these actions, the role requirement (Leader/Officer) still applies.

Best Practices

Choosing a Good Name

Memorable - Easy to type and remember
Appropriate - Follows server rules
Unique - Stands out from others

Writing a Good Description

Informative - What is your faction about?
Recruiting info - Include requirements if applicable
Contact info - How to reach leadership

Color Selection

Visible - Avoid colors too close to UI elements
Unique - Try to differ from nearby factions
Thematic - Match your faction's identity

Settings Commands

Settings Commands

Renaming Your Faction

Setting Description

Setting Faction Tag

Setting Faction Color

Opening Membership

Closing Membership

Territory Permissions

Disbanding

Quick Reference

Examples

Complete Faction Setup

Rebranding

Recruiting Phase

Permission Summary

Settings Permissions

Best Practices

Choosing a Good Name

Writing a Good Description

Color Selection

Related Topics