Skip to content

Feature: HyperWarps GUI Integration #3

@derrickmehaffy

Description

@derrickmehaffy

Scope

Integration between HyperHomes and HyperWarp GUIs, allowing players to seamlessly switch between viewing their homes and warps from either plugin's GUI.

Implementation Details

  • Add a navigation button/tab in the HyperHomes GUI that opens the HyperWarp GUI
  • Add a corresponding button in HyperWarp's GUI to switch back to HyperHomes
  • Use reflection-based soft dependency (same pattern as HyperFactions integration) so neither plugin hard-depends on the other
  • If HyperWarp is not installed, the navigation button should be hidden
  • Navigation should preserve context where possible (e.g., remember which page the player was on)

Risks and Alternatives

  • Risk: HyperWarp API may change, breaking reflection calls. Mitigated by fail-open design.
  • Alternative: Instead of direct GUI switching, could use a unified teleportation GUI that combines both. However, keeping them separate with cross-navigation is simpler and more maintainable.
  • Alternative: Could use chat commands to switch instead of GUI buttons, but in-GUI navigation is more user-friendly.

References and Media

  • HyperFactions integration pattern in integration/HyperFactionsIntegration.java serves as the template for reflection-based soft dependency
  • HyperWarp GUI pages: WarpListPage, WarpDetailPage

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