Forgeport connector
Install the connector core and implement its game-server bridge
The Forgeport connector runs inside the game server process and opens an
outbound WebSocket connection to Forgeport. It provides live server data and
executes the operations implemented by the server's GameBridge.
This page is for L2J sources
This page and Architecture describe the L2J connector core, which runs
inside the game server process. An L2Off server running retail binaries has no source to compile
a bridge into — its connector is a separate process configured through portal.toml, described
in PTS / L2Off servers.
What Forgeport provides
| Component | Responsibility |
|---|---|
| Connector core JAR | Authentication, handshake, heartbeat, reconnects, and protocol messages |
minimal-json JAR | JSON dependency used by the connector core |
GameBridge interface | Contract between the connector core and the game server |
| Documentation examples | Complete aCis and Mobius bridges — the composition class and every helper, printed in full |
Forgeport does not provide an aCis or Mobius adapter. The game server administrator or developer owns the bridge implementation, including database queries, live-world operations, password verification, persistence, and grant idempotency.
Supported functions
- Game-account credential verification
- Character lists and PvP, PK, and level rankings
- Item and skill delivery
- Server status and online-player count
- Item and skill catalog search
- Optional account creation
- Optional character rename, gender change, and unstuck
Forgeport enables a function only when the installed bridge advertises its capability.
Installation
- Add the game server in Admin → Game Servers.
- Download the connector core and
minimal-jsonJAR files onto the game server's classpath. Requires Java 17 or newer. - Implement
GameBridgefor the exact game-server revision. - Start the connector with your bridge, and add a shutdown call:
PortalConnector.getInstance().start(new MyGameBridge()). - Download
portal.propertiesand place it inconfig/portal.properties. - Rebuild and start the game server.
- Confirm Connected, then run Connector check.
A bridge is a composition class plus roughly ten helper classes — the journal, the grant paths, and the SQL are the bulk of the work. Start with the complete aCis or Mobius example — each prints every class in full. For another source or a modified revision, follow Custom bridge.