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

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions