Reference examples

Mobius CT_0 (Interlude)

Install the reference connector implementation for Mobius CT_0

This implementation targets stock Mobius CT_0. Modified revisions must be checked against their database schema and runtime API.

Requirements

  • Java 25
  • Mobius CT_0 source and build environment
  • MariaDB or MySQL access through DatabaseFactory
  • minimal-json-0.9.5.jar

Advertised capabilities

VERIFY_GAME_CREDENTIALS
GET_SERVER_STATUS
GET_ONLINE_COUNT
LIST_ACCOUNT_CHARACTERS
LIST_RANKINGS
SEARCH_GAME_CATALOG
SEARCH_SKILL_CATALOG
DELIVER_GRANT
CHARACTER_SERVICES
UNSTUCK_CHARACTER

CREATE_GAME_ACCOUNT and PLAYER_ONLINE_EVENT are not implemented.

Implementation behavior

  • Credentials use SHA-1 followed by Base64, matching stock Mobius CT_0.
  • Character and ranking queries use characters.charId.
  • Item and skill delivery requires the target character online.
  • Rename and gender change require the target character online.
  • Unstuck accepts only an offline character owned by the supplied account and moves it to the configured recovery coordinates.
  • The bridge creates and uses the portal_command table for idempotency.

Skill catalog requirement

Stock Mobius CT_0 does not expose all loaded skills. Add the SkillData.getAllSkills() accessor shown on the skill catalog page, or remove SEARCH_SKILL_CATALOG from MobiusGameBridge.capabilities().

Installation

The Mobius reference is provided as a complete source integration under org.l2jmobius.gameserver.portal. It includes its namespaced connector core; do not add the net.sf.l2j prebuilt core JAR to the same installation.

  1. Copy connector/mobius-ct0-interlude/src/org/l2jmobius/gameserver/portal/ into java/org/l2jmobius/gameserver/portal/.

  2. Place minimal-json-0.9.5.jar in the Mobius libs/ directory.

  3. Add the startup hook after world and data initialization:

    import org.l2jmobius.gameserver.portal.PortalConfig;
    import org.l2jmobius.gameserver.portal.PortalConnector;
    
    PortalConfig.load();
    PortalConnector.getInstance().start();
  4. Add best-effort cleanup to the shutdown sequence:

    try
    {
        org.l2jmobius.gameserver.portal.PortalConnector.getInstance().shutdown();
    }
    catch (Throwable ignored)
    {
    }
  5. Download portal.properties, set the bridge class, and place the file at game/config/portal.properties:

    Bridge=org.l2jmobius.gameserver.portal.MobiusGameBridge
  6. Add the skill catalog accessor or remove that capability.

  7. Build the server:

    ant compile
  8. Start the game server, confirm Connected, and run Connector check from Admin → Game Servers.

On this page