QUICKSTART-DEV.adoc

Game Server Admin — Developer Quickstart

Clone, build, test, contribute.

Table of Contents

• Prerequisites
• Setup
• Development Workflow
• Before Committing
• Contributing

Prerequisites

• Git 2.40+

• just (command runner)

• See just doctor output for language-specific requirements

Setup

git clone https://github.com/hyperpolymath/game-server-admin
cd game-server-admin
just doctor    # verify toolchain
just heal      # auto-install missing tools

Development Workflow

just tour       # understand the codebase
just help-me    # see available commands

# Build everything (ABI + FFI library + CLI executable)
just build

# Run the CLI
just run status              # system health + profiles
just run probe <host> [port] # fingerprint a game server

# Run tests
cd src/interface/ffi
zig build test               # unit tests
zig build test-integration   # integration tests
zig build test-smoke         # smoke tests

Before Committing

just assail    # run panic-attacker security scan

Contributing

See CONTRIBUTING.md for guidelines.