Updates and connector check
Update the connector core and verify advertised capabilities
Version status
The connector handshake reports adapterVersion. Forgeport compares this
value with the connector release catalog and displays one of the following
states in Admin → Game Servers:
- Core up to date
- Core update available
- Unsupported core build
Pack name, chronicle, and revision are not part of protocol v1.
Update a JAR installation
- Download the latest connector core from Admin → Game Servers.
- Stop the game server.
- Remove the previous
portal-connector-core-<version>.jar. - Add the new JAR.
- Rebuild if the pack bundles dependencies during compilation.
- Start the game server and confirm the reported version.
- Run Connector check.
Keep only one connector core version on the classpath.
A new core may add an interface method. Compile the bridge against the new JAR before deploying it, and advertise a new capability only after its method is implemented.
Update the Mobius source integration
The Mobius reference carries its connector core as source under
org.l2jmobius.gameserver.portal.
- Stop the game server.
- Replace
PortalConnector.java,PortalConfig.java,GameBridge.java, andGrantResult.javawith files from one connector release. - Review bridge changes required by that release.
- Rebuild with
ant compile. - Start the game server, confirm the reported version, and run Connector check.
Do not mix core source files from different connector versions.
Connector check coverage
The check uses the capabilities reported by the connected bridge.
| Capability | Check |
|---|---|
GET_SERVER_STATUS | Confirms an active, ready connection |
GET_ONLINE_COUNT | Confirms that a heartbeat contains an online count |
VERIFY_GAME_CREDENTIALS | Submits a non-existent account and expects a clean rejection |
LIST_ACCOUNT_CHARACTERS | Requests a non-existent account and accepts an empty list |
LIST_RANKINGS | Requests one PvP ranking row |
SEARCH_GAME_CATALOG | Searches the item catalog |
SEARCH_SKILL_CATALOG | Searches the skill catalog |
DELIVER_GRANT | Delivers one Adena to the selected online character |
CHARACTER_SERVICES | Sets the selected online character's gender to its current value |
UNSTUCK_CHARACTER | Runs the configured unstuck operation for the selected character |
DELIVER_GRANT, CHARACTER_SERVICES, and UNSTUCK_CHARACTER require a game
account and character ID.
State-changing checks
The grant check adds one Adena. The unstuck check moves an offline character to the recovery coordinates configured in the bridge. Use a designated test character.
CREATE_GAME_ACCOUNT is not exercised by Connector check.
PLAYER_ONLINE_EVENT has no protocol v1 message and must not be advertised.