Capabilities

UNSTUCK_CHARACTER

Move an offline character to configured recovery coordinates

Bridge contract

String unstuck(String accountName, int characterId) throws Exception;

Return one of:

ResultMeaning
UNSTUCKSaved coordinates were updated
CHARACTER_ONLINEOperation refused because the character is online
NOT_FOUNDThe supplied account does not own the character
FAILEDThe operation could not be completed

Query by both account name and character ID. Update saved coordinates only when the character is offline.

The reference implementations use Giran:

private static final int TOWN_X = 82698;
private static final int TOWN_Y = 148638;
private static final int TOWN_Z = -3473;

Change these constants if the target revision uses a different recovery location.

Verification

Connector check runs the actual unstuck operation. An offline test character will be moved to the configured coordinates. An online character returns CHARACTER_ONLINE, which confirms the request completed without moving it.

On this page