v2.0.0

Portlight Trade. Sail. Prosper.

A trade-first maritime strategy game where you build a merchant career across 20 ports, 5 regions, and 43 routes — with 9 captain types, 4 pirate factions, and 4 victory paths.

Get started Read the Handbook

Install

pip install portlight

Play

portlight new "Captain Hawk" --type merchant

Trade

portlight market && portlight buy grain 10

Features

A living world of merchant adventure.

Living Economy

Prices react to your trades. 20 ports, 18 goods, 43 routes across 5 regions with scarcity-driven pricing. Every port has clear import/export identity.

Nine Captains

Merchant, Smuggler, Navigator, Privateer, Corsair, Scholar, Merchant Prince, Dockhand, Bounty Hunter. Each starts differently, sees different contracts, and leans toward a different path.

Contracts & Provenance

22 contract templates across 6 families. Trust-gated access. Provenance-validated delivery. Real deadlines with real consequences.

Reputation & Heat

Four axes — commercial trust, customs heat, regional standing, underworld connections. Honest play opens doors. Risky play pays more but draws attention.

Combat & Factions

Personal combat with stance triangle, 14 weapons, regional fighting styles. Naval combat. 4 pirate factions controlling different waters.

1,832 Tests

14 cross-system invariants, 9 compound stress scenarios, 7-bot balance harness. The game never enters an illegal state.

Quick Start

Install

pip install portlight
# or: npx @mcptoolshop/portlight

Start a game

portlight new "Captain Hawk" --type merchant

Trade

portlight market
portlight buy grain 10
portlight sail al_manar
portlight advance
portlight sell grain 10

Build your career

portlight map
portlight milestones
portlight contracts
portlight print-and-play