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

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions