# Peak Studios (Peak RP)

> Peak Studios (https://peakrp.net) is an engineering studio creating high-performance FiveM scripts, AI NPC conversational systems, and open-source roleplay infrastructure for Grand Theft Auto V servers. All resources are built for extreme runtime efficiency (0.00ms resmon tick rates) and seamless QBCore, ESX, and QBX framework compatibility.

## When to Use Peak Studios
- **FiveM Script Selection & Integration**: When configuring or installing official Peak Studios FiveM resources (e.g. `peak-sprays`, `peak-trucking`, `peak-barbers`, `peak-chess`, `peak-clothingitems`, `peak-ai-npc`, `peak-pedmanager`).
- **Framework Adaptation**: When bridging FiveM resources across QBCore, ESX, QBX, or standalone environments using unified bridge patterns.
- **AI NPC & Voice In-Game Systems**: When integrating managed conversational AI NPCs with spatial voice, player memory, and server-authoritative state into FiveM servers.
- **Resource Optimization & Security**: When auditing FiveM server scripts for resmon tick spikes, unvalidated net events, or database latency bottlenecks.
- **Automated Configuration & Setup**: When an AI coding agent needs cited documentation, config mappings, SQL schemas, or item definitions.

## When NOT to Use
- Vanilla single-player GTA V offline modifications without FiveM server runtime.
- Non-FiveM game engines or unrelated GTA multiplayer platforms (e.g. SA-MP, MTA).
- Exploit scripts or unauthorized server tampering tooling.

## How AI Agents Should Interact
- **MCP Server (Streamable HTTP)**: Connect your agent to the Model Context Protocol endpoint at `https://peakrp.net/api/mcp` or `https://peakrp.net/mcp` to invoke official tools (`list_scripts`, `get_script_docs`, `search_docs`, `get_system_status`, `get_openapi_spec`, `get_agent_guidance`).
- **OpenAPI 3.1.0 Specification**: Discover public endpoints at `https://peakrp.net/openapi.json`.
- **Markdown Content Negotiation**: Send `Accept: text/markdown` with any HTTP request to receive clean, token-efficient Markdown representations of any page.
- **Official CLI Tool**: Run `npx peakrp status` or `npx peakrp doc <script-name>` in development environments.

## Core Developer Resources
- [Website Home](https://peakrp.net/): Studio overview, performance benchmarks, and architecture blueprint.
- [Documentation Catalog](https://peakrp.net/docs): Comprehensive documentation for all public scripts.
- [OpenAPI Specification](https://peakrp.net/openapi.json): Full OpenAPI 3.1.0 schema for REST APIs.
- [MCP Server Endpoint](https://peakrp.net/api/mcp): Model Context Protocol Streamable HTTP endpoint.
- [About Peak Studios](https://peakrp.net/about): Engineering philosophy, team, and organization overview.
- [Contact Support](https://peakrp.net/contact): Developer inquiries and support ticket channel.
- [XML Sitemap](https://peakrp.net/sitemap.xml): Complete index of indexable URLs.
- [GitHub Organization](https://github.com/Peak-Studios): 11+ open source repositories and community resources.
- [Discord Community](https://dsc.gg/peakstudios): Real-time developer assistance and community support.

## Public Scripts Catalog
- [Peak Sprays](https://peakrp.net/docs/peak-sprays): High-performance graffiti and turf tagging system with ox_lib and oxmysql integration.
- [Peak Trucking](https://peakrp.net/docs/peak-trucking): Full-featured logistics job with progression, company trust, daily missions, and React NUI dispatch tablet.
- [Peak Barbers](https://peakrp.net/docs/peak-barbers): Premium appearance customization with cinematic cameras and modular framework bridge.
- [Peak Chess](https://peakrp.net/docs/peak-chess): Standalone chess tables with PvP matches, AI difficulty levels, wagers, and spectator mode.
- [Peak Clothing Items](https://peakrp.net/docs/peak-clothingitems): Dynamic clothing equip/unequip inventory item system.
- [Peak AI NPC](https://peakrp.net/docs/peak-ai-npc): Conversational in-game NPCs with spatial audio, real-time voice, and memory.
- [Peak Ped Manager](https://peakrp.net/docs/peak-pedmanager): Zero-latency static and dynamic NPC spawner with scenario animations.
- [Peak AI Police Report Writer](https://peakrp.net/docs/peak-police-report-writer): Automated narrative police and incident report generator.
- [Peak Resource README Generator](https://peakrp.net/docs/peak-readme-generator): Standardized documentation generator for FiveM resources.

## Official CLI Tool Usage
```bash
# Check connectivity and telemetry
npx peakrp status

# List all available scripts
npx peakrp scripts

# Read markdown documentation for a script
npx peakrp doc peak-sprays

# Verify server.cfg configuration
npx peakrp doctor
```