Connect your Metin2 server
Run the standalone Forgeport connector against a Metin2 MySQL base
The Metin2 connector is a standalone Node process configured by one
portal.toml. It uses the base's MySQL databases for accounts, characters,
catalog search, rankings, online presence, the native item gift box, and
currency credits. No C++ game-core change is required.
Metin2 support is beta and has been validated on the old-metin2 TMP4 40250 lineage. Verify every enabled function against your own base before selling.
Prerequisites
- Node 22 or newer.
- MySQL access to the account, player, and log databases used by the profile.
- Outbound WSS access to
wss.forgeport.net:443. - A test account for portal linking and in-game delivery checks.
Connect the server
Add the server in Forgeport Admin
Open Admin → Game Servers → Add game server, choose Metin2, and name the server.
Download the two files
Download portal-connector-metin2-1.0.0.mjs and the generated
portal.toml. Keep the token in the profile private.
Adapt the profile
Set database names and credentials, choose the password format, and check
every SQL statement marked CHECK against your base. Remove optional
sections your schema does not support.
Start the connector
Put both files in one directory and run from that directory:
node portal-connector-metin2-1.0.0.mjsConfirm Connected and run Connector check
The server card should show Connected. Connector check sends small test requests through the production connection. It confirms configured SQL can respond, but it cannot verify the final state in the game client.
Verify the visible result
Link a real test account, confirm its characters, purchase one low-value item, and claim it from the in-game Item Shop storage. If currency is enabled, credit a small test amount and confirm the client shows it.
What you should see
- Admin reports Connected and connector
1.0.0. - Account linking and character listing match the game database.
- A purchased item reaches
item_awardand becomes claimable in game. - Enabled website data matches current MySQL data.