kovagoadi/openttd-client

Fork 0

Files

History

kovagoadi 0a8271d57c

Continuous Integration / lint-and-security (pull_request) Successful in 31s

Details

Continuous Integration / tests-and-coverage (pull_request) Successful in 25s

Details

Add vehicle listing support to admin client

The Admin Network has no native packet for listing individual vehicles,
so list_vehicles() sends a "list_vehicles" command over the existing
GameScript JSON channel and relies on a companion server-side script to
reply with vehicle data via ServerGamescript. Requires subscribing to
Gamescript updates (documented in docs/PROTOCOL.md) to receive the reply.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

2026-07-16 20:44:44 +02:00

__init__.py

Add admin port support with other major refactorations

2026-06-29 19:47:48 +02:00

client.py

Add vehicle listing support to admin client

2026-07-16 20:44:44 +02:00

decorators.py

Add admin port support with other major refactorations

2026-06-29 19:47:48 +02:00

protocol.py

Fixed ruff issues

2026-06-29 19:58:16 +02:00

README.md

Initialized openttd-client repo

2026-06-05 23:18:09 +02:00

README.md

Internal Package: openttd

This directory contains the core implementation of the OpenTTD network client.

Modules

__init__.py: Exposes the high-level OpenTTDClient API.
client.py: Implementation of the OpenTTDClient class. Manages the connection lifecycle, PAKE state, map synchronization, and keep-alive.
protocol.py: Implementation of the OpenTTDProtocol class. Handles low-level binary packet serialization, AEAD stream encryption, and static packet parsing.

Design Goals

Encapsulation: The user should never need to manually handle bytes or encryption keys.
Robustness: Gracefully handle server errors and unknown packet types.
Efficiency: Use asyncio for non-blocking I/O and monocypher for fast cryptographic operations.