Home & Teleport

Commands for faction home teleportation and escape.

Home & Teleport Commands

HyperFactions provides a faction home system that allows members to teleport to a shared location, plus a stuck command for escaping hostile territory.

Teleporting Home

Command	Description	Permission
`/f home`	Teleport to your faction's home location	`hyperfactions.teleport.home`

Teleport Process:

Command starts a warmup countdown
Player must not move or take damage
After warmup completes, teleportation occurs
Cooldown begins before next use

Info

Default warmup is 5 seconds. Default cooldown is 5 minutes. Both are configurable.

Setting Faction Home

Command	Description	Permission
`/f sethome`	Set the faction home to your current location	`hyperfactions.teleport.sethome`

Requirements:

Must be the Leader
Standing in faction-claimed territory
Saves exact position and rotation

Tip

Set your faction home inside a protected building within your claimed territory for safety.

Stuck Command

Command	Description	Permission
`/f stuck`	Teleport to nearby wilderness when trapped in hostile territory	`hyperfactions.teleport.stuck`

Behavior:

30-second warmup by default
5-minute cooldown by default
Cancelled by movement or damage
Teleports to nearest unclaimed chunk
Only works in territory you don't own

When to Use

Use /f stuck when you're trapped in enemy territory with no way to escape. The long warmup prevents combat abuse.

Stuck Configuration

Option	Default	Description
`stuck.warmupSeconds`	30	Warmup before teleport
`stuck.cooldownSeconds`	300	Cooldown between uses

Quick Reference

Command	Description	Role Required
`/f home`	Teleport to faction home	Member+
`/f sethome`	Set faction home location	Leader
`/f stuck`	Escape hostile territory	Member+

Teleport Configuration

The teleport system is highly configurable:

Option	Default	Description
`teleport.warmupSeconds`	5	Seconds before home teleport
`teleport.cooldownSeconds`	300	Seconds between home teleports
`teleport.cancelOnMove`	true	Cancel if player moves
`teleport.cancelOnDamage`	true	Cancel if player takes damage
`teleport.crossWorld`	true	Allow cross-dimension teleport

Permission Summary

Teleport Permissions

Permission	Description	Default
`hyperfactions.teleport.home`	Teleport to faction home	false
`hyperfactions.teleport.sethome`	Set faction home location	false
`hyperfactions.teleport.stuck`	Use stuck escape command	false
`hyperfactions.bypass.warmup`	Skip teleport warmup	false
`hyperfactions.bypass.cooldown`	Skip teleport cooldown	false

Examples

Setting Up Faction Home

Claim the area first:
```
/f claim
```
Stand where you want the home: Position yourself exactly where members should appear.
Set the home:
```
/f sethome
```
Test it:
```
/f home
```

Using Faction Home

/f home

Output: "Teleporting to faction home in 5 seconds. Don't move!"

After 5 seconds, you appear at the faction home.

Escaping Enemy Territory

/f stuck

Output: "Teleporting to wilderness in 30 seconds. Don't move or take damage!"

After 30 seconds, you appear at the nearest unclaimed chunk.

Strategic Home Placement

Good Locations

Inside a secure building - Protected from enemies
Central to your territory - Easy access to all claims
Near important resources - Farms, storage, etc.
Underground or hidden - Harder for enemies to camp

Bad Locations

Outside your claims - Cannot set home in unclaimed land
Exposed areas - Enemies can wait for teleports
Near territory borders - Risk of losing the home if overclaimed

Cross-Dimension Teleportation

When crossWorld is enabled:

Home can be in any dimension
Members teleport across dimensions
Useful for bases in different worlds

When crossWorld is disabled:

Home only works in the same dimension
Error message if in a different world

Warmup Cancellation

Teleportation is cancelled if:

Action	Config Key
Player moves	`cancelOnMove`
Player takes damage	`cancelOnDamage`

Warning

Stay perfectly still and avoid combat during the warmup to ensure successful teleportation.

Home vs Stuck Comparison

Feature	`/f home`	`/f stuck`
Destination	Faction home	Nearest wilderness
Requirement	Faction must have home set	Must be in non-owned territory
Warmup	5 seconds (default)	30 seconds (default)
Cooldown	5 minutes (default)	5 minutes (default)
Combat use	Can be used anywhere	For escaping only
Permission	`hyperfactions.teleport.home`	`hyperfactions.teleport.stuck`

VIP Bypass Permissions

Grant VIP players instant teleports:

/hp group setperm vip hyperfactions.bypass.warmup
/hp group setperm vip hyperfactions.bypass.cooldown