World Actions

WorldActions covers world list queries, world type checks, hopper access, and RuneLite world-hop dispatch.

Read-only world-list snapshots and world-map coordinate helpers live in World SDK. Keep this page focused on result-aware WorldActions behavior.

Hopper And World Hop

InteractionResult result = WorldActions.hopTo(302);

• openHopper() / openLobbyWorlds() → asks the client to open the world hopper.
• isHopperOpen() → checks the world switcher container widget.
• loadWorlds() → returns success if the list is already loaded, otherwise opens the hopper and returns WORLD_NOT_FOUND to signal that loading was requested.
• hopTo(int worldId) → resolves the world from the loaded list and delegates to hopTo(World).
• hopTo(World) → calls client.hopToWorld(world) and returns SUCCESS when the hop request is queued.
• closeLobbyWorlds() → clicks the world switcher logout/close widget when visible.

Status codes:

Condition	Status
Not logged in	guard status (CLIENT_NOT_READY / NOT_LOGGED_IN)
Already on this world	SUCCESS
World not in list	WORLD_NOT_FOUND
Client throws during hop	WORLD_HOP_FAILED

Read and filter the current world list through World SDK, then pass the selected world ID or World to hopTo(...). World selection policy (membership, PvP, total-level, region, or population) belongs outside the action class.