Skip to content

Feature: HyperFactions GUI Integration - Faction Home #4

@derrickmehaffy

Description

@derrickmehaffy

Scope

Display the player's faction home within the HyperHomes GUI, allowing players to see and teleport to their faction home alongside their personal homes.

Implementation Details

  • Add a dedicated section or entry in the Homes List GUI showing the player's faction home (if they are in a faction)
  • Use the existing HyperFactionsIntegration reflection-based soft dependency to fetch faction home data
  • Display faction home with distinct styling (e.g., different icon color or label like "[Faction] Home")
  • Clicking the faction home entry should teleport the player using HyperFactions' teleport logic (via reflection)
  • If the player is not in a faction or HyperFactions is not installed, the section should be hidden
  • Show faction name and territory info alongside the faction home location

Risks and Alternatives

  • Risk: HyperFactions API may not expose faction home location directly. May need to add a public API method to HyperFactions first.
  • Risk: Teleportation via reflection may not respect HyperFactions' warmup/cooldown settings. Consider delegating teleport entirely to HyperFactions.
  • Alternative: Instead of embedding in HyperHomes GUI, could add a "Faction Home" button that runs /f home command. Simpler but less integrated.
  • Alternative: Could show all faction warps, not just home. Scope creep risk — start with just faction home.

References and Media

  • integration/HyperFactionsIntegration.java — existing reflection integration
  • HyperFactions faction home command: /f home
  • HyperFactions FactionManager and Faction data model

Confirmation

  • I have searched existing issues to ensure this is not a duplicate
  • I have considered the scope and impact of this feature

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions