# KBVE

> Open-source software collective and game studio. Builds web infrastructure, Minecraft mods, multiplayer games, and developer tooling. Operates a Kubernetes-managed stack on Talos backing kbve.com.

KBVE runs the kbve.com website, a Discord community, multiple game projects (RareIcon, ChuckRPG, RentEarth, KBVE-MC), and the axum-kbve API. Source lives at https://github.com/KBVE/kbve.

## Projects

- [@kbve/devops — Proto-to-Zod Codegen and CI/CD Helper Library](https://kbve.com/project/devops/) — @kbve/devops is a DevOps helper library with proto-to-zod codegen, GitHub Actions helpers, sanitization, and CI registry management for the KBVE monorepo.
- [Agones Factorio — Managed Dedicated Server](https://kbve.com/project/agones-factorio/) — Agones-managed Factorio dedicated server with the KBVE scenario plus a lifecycle shim (Ready/Health, SIGTERM save flush) on the factoriotools rootless base.
- [Agones Factorio Relay](https://kbve.com/project/agones-factorio-relay/) — Rust sidecar for the Agones-managed Factorio server — tails the console log, speaks RCON, bridges chat to kbve IRC, and writes telemetry to ClickHouse.
- [Agones Unreal SDK — Server-Only GameServer Lifecycle Plugin](https://kbve.com/project/agones/) — Vendored Agones Unreal SDK plugin (server-only) drives GameServer lifecycle Ready, Health, and Shutdown through the Agones sidecar REST API on dedicated builds.
- [AR — Augmented Reality Glasses and SDK Research Notes](https://kbve.com/project/ar/) — KBVE augmented reality (AR) research notes covering AR glasses hardware such as the Nreal Air and their SDKs for building spatial and heads-up experiences.
- [ARC Runner — Custom GitHub Actions Runner Image](https://kbve.com/project/arc-runner/) — Custom GitHub Actions Runner image for the arc-runner-set scale set, baking git-lfs, unzip, jq, gh, kubectl, and dbmate into the actions/runner base.
- [Aria2 Proxy — KubeVirt Download Proxy Image](https://kbve.com/project/aria2-proxy/) — Alpine-based download proxy image for KubeVirt VM provisioning — bundles aria2 and a python3 HTTP file server with a tini PID 1 reaper.
- [ARPG Server — Authoritative Grid Game Host on Axum](https://kbve.com/project/arpg-server/) — ARPG Server is an authoritative grid game host — axum + tokio + simgrid headless Bevy sim on Agones, serving the ARPG isometric action RPG over WebSocket.
- [ARPG Web — Standalone Vite Game Client and CDN](https://kbve.com/project/arpg-web/) — Standalone Vite + React ARPG client served as static files at arpg.kbve.com, the single source of truth feeding the arcade page and Discord Activity embed.
- [Asset Marketplace](https://kbve.com/project/marketplace/) — Open marketplace for game assets — 3D, 2D, audio, VFX, tools, and complete projects — on a decoupled Rust/Axum API sharing KBVE identity with the Job Board.
- [Atlas — Autonomous Machine Learning Agent Concepts](https://kbve.com/project/atlas/) — Atlas is the KBVE machine learning agent project and glossary covering autonomous agents, model training, layered neural networks, and ML systems.
- [Bevy Battle — Turn-Based Combat Crate](https://kbve.com/project/bevy-battle-crate/) — Bevy turn-based battle crate — damage resolution, effects, class procs, and enemy AI as a pure Rust core plus an optional Bevy ECS plugin.
- [Bevy Cam — Isometric Camera Crate](https://kbve.com/project/bevy-cam-crate/) — Bevy isometric camera crate with pixel snapping, multiplicative zoom, and a two-stage render-to-texture pipeline for crisp pixel-art rendering.
- [Bevy NPC — Proto-Driven NPC Registry Crate](https://kbve.com/project/bevy-npc-crate/) — Bevy NPC crate that compiles npcdb.proto into typed Rust structs with a searchable NpcDb registry queryable by slug, ULID, type, rarity, or family.
- [Bevy Pathfinder — Flow Field Crate](https://kbve.com/project/bevy-pathfinder-crate/) — Bevy flow-field pathfinding crate with grid walkability, shared-goal BFS direction fields, and chokepoint detection. Pure Rust core, optional Bevy feature.
- [Bevy Player — Character Controller Crate](https://kbve.com/project/bevy-player-crate/) — Bevy kinematic character controller crate with Avian3D physics — gravity, jump, collision-aware movement, direction mapping, and fall-damage events.
- [bevy_behavior — Game-Agnostic Behavior Tree Engine for Bevy](https://kbve.com/project/bevy-behavior-crate/) — bevy_behavior is a game-agnostic behavior tree engine for Bevy with composable Selector/Sequence nodes, cooldown tracking, and observation traits for NPC AI.
- [bevy_chat — IRC Chat & Event Bridge Crate](https://kbve.com/project/bevy-chat-crate/) — bevy_chat is a headless async IRC client crate for MUD and game clients, unifying native tokio TCP and WASM WebSocket transports with an optional Bevy plugin.
- [bevy_db — Async Key-Value Persistence for Bevy](https://kbve.com/project/bevy-db-crate/) — bevy_db is a cross-platform async key-value persistence crate for Bevy — redb on native, IndexedDB on WASM, all I/O off the game thread via bevy_tasker.
- [bevy_inventory — Slot-Based Inventory Crate for Bevy](https://kbve.com/project/bevy-inventory-crate/) — bevy_inventory is a generic slot-based inventory crate with item stacking, transfer, search, and serde snapshots — pure Rust core, optional Bevy ECS.
- [bevy_items — Proto-Driven Item Registry Crate](https://kbve.com/project/bevy-items-crate/) — Proto-driven item definitions for Bevy games — compiles itemdb.proto into typed Rust structs with a searchable ItemDb registry.
- [bevy_kbve_net — Shared Lightyear Multiplayer Protocol Crate](https://kbve.com/project/bevy-kbve-net-crate/) — bevy_kbve_net is a Bevy 0.18 + lightyear 0.26 networking crate defining KBVE's shared multiplayer protocol — replicated components, inputs, and channels.
- [bevy_mapdb — Proto-Driven Map Registry Crate for Bevy](https://kbve.com/project/bevy-mapdb-crate/) — Game-agnostic Bevy crate that compiles mapdb.proto into typed Rust structs and wraps them in a searchable MapDb resource for zones, regions, and world objects.
- [bevy_quests — Proto-Driven Quest Registry for Bevy Games](https://kbve.com/project/bevy-quests-crate/) — bevy_quests compiles questdb.proto into typed Rust structs and wraps them in a searchable QuestDb Bevy resource queryable by slug, ULID, category, or tags.
- [bevy_skills — Skill Progression Crate for Bevy](https://kbve.com/project/bevy-skills-crate/) — bevy_skills is a Rust skill-progression crate — a pure-Rust core tracking per-entity XP, levels, and skill checks, with an optional Bevy ECS plugin and events.
- [bevy_statemachine — State Snapshot Bridge for Bevy](https://kbve.com/project/bevy-statemachine-crate/) — bevy_statemachine is a thread-safe state snapshot bridge for Bevy, exposing ECS resources to Tauri IPC, WASM JS, and lightyear via JSON and bincode.
- [bevy_supa — Agnostic Supabase PostgREST Client Crate](https://kbve.com/project/bevy-supa-crate/) — bevy_supa is a transport-agnostic Supabase (PostgREST) client crate with native reqwest+rustls HTTP, a WASM fetch stub, and optional Bevy ECS integration.
- [bevy_tasker — Cross-Platform Async Task Crate](https://kbve.com/project/bevy-tasker-crate/) — Cross-platform async task spawning for Bevy — web workers via microtask queue on WASM, thread pool on desktop, one API across targets.
- [Brackeys Game Jam — KBVE Godot + Rust Idle Space Shooter](https://kbve.com/project/brackeys/) — KBVE's Brackeys Game Jam entry — an idle Asteroids-style space shooter built in Godot with Rust (GDExtension) around the theme Nothing Can Go Wrong.
- [Charles — KBVE Internal Machine Learning GPU Cluster](https://kbve.com/project/charles/) — Charles is KBVE's internal machine-learning build — a multi-GPU deep-learning workstation with NVIDIA RTX 4090 cards and DDR5 memory on Proxmox.
- 82 more entries in this section — see [/llms-full.txt](https://kbve.com/llms-full.txt) for the full corpus

## Application Stack

- [Android](https://kbve.com/application/android/) — Android is an open source operating system based off of Linux that runs within the ARM architecture;
the primary use case is within the mobile/tablet eco-system but it has been expanding into server, desktop and embedables.
Android utilizes a modified Linux kernel optimized for low power devices and real time performance.
Furthermore, the system provides a robust framework for application development through the Android SDK and Java/Kotlin APIs.
Android's modular architecture allows hardware vendors to customize drivers, UI layers, and services for specific devices.
With the introduction of Project Treble and mainline updates, the OS now supports more consistent long-term maintenance and faster security patches.
Beyond consumer devices, Android has also evolved into specialized distributions such as Android TV, Android Auto, and Wear OS, extending its ecosystem across multiple platforms.
- [Ansible](https://kbve.com/application/ansible/) — DevOps software that handles the infrastructure of the backend through automation.
Ansible's main function(s) operate through a "playbook" system that exectues a collection of commands for the system admin, which becomes a pillar within the IaaC environment.
- [Application Navigator](https://kbve.com/application/) — The KBVE Tech Navigator is a comprehensive guide that maps out the diverse software technologies used in our projects, from foundational systems like Linux to cutting-edge applications in AI and game development, all designed to enhance collaboration and streamline workflows.
- [Appwrite](https://kbve.com/application/appwrite/) — Appwrite is an open-source backend server that provides developers with core APIs to build applications. It is self-hosted and can run on any operating system. Appwrite aims to simplify backend development for developers.
- [ArgoCD](https://kbve.com/application/argocd/) — ArgoCD is a declarative, GitOps continuous delivery tool for Kubernetes that syncs the desired state in Git
with the live cluster. This guide covers the architecture, CLI, sync policies, the KBVE annotation standard,
and troubleshooting.
- [Authelia](https://kbve.com/application/authelia/) — Authelia is an open-source authentication and authorization server that adds two-factor authentication (2FA) and single sign-on (SSO) to your applications through a reverse proxy. It acts as a firewall-like access portal, securing services outside the scope of the application itself.
- [Blender](https://kbve.com/application/blender/) — Blender is a powerful open-source 3D creation suite supporting the entire 3D pipeline—modeling, rigging, animation, simulation, rendering, compositing, motion tracking, and video editing.
The software provides professional-grade tools for artists, studios, and hobbyists across industries including game development, film production, architecture, and product visualization.
With Python scripting, extensive addon support, and active community development, Blender has become an industry-standard tool for 3D content creation.
- [CSS](https://kbve.com/application/css/) — CSS styles the web. From modern CSS features to TailwindCSS utilities and ready-to-use custom components.
- [CubeJS](https://kbve.com/application/cubejs/) — CubeJS is a headless business intelligence application for various forms of data, including SQL, Mongo and Snowflake. CubeJS can be extended to external data warehouses, such as, Google BigQuery, Amazon Athena and Presto.
- [Docker](https://kbve.com/application/docker/) — Docker packages applications and their dependencies into portable containers that run identically across
machines. This reference covers the Docker CLI cheatsheet, every Dockerfile instruction (FROM, RUN, CMD,
ENTRYPOINT, and more), GPU passthrough, BuildX, WatchTower, and container management scripts.
- [FlipperZero](https://kbve.com/application/flipperzero/) — Flipper Zero is a pen test multi-tool! Think of it as a Swiss Army knife for wireless hacking.
- [Flutter](https://kbve.com/application/flutter/) — Flutter is Google's open-source UI toolkit for building natively compiled apps for mobile, web, and desktop
from a single Dart codebase. This guide covers installing the SDK, running flutter doctor, the essential CLI
cheatsheet, the widget model, and where to find packages on pub.dev.
- [GCloud](https://kbve.com/application/gcloud/) — gcloud is the Google Cloud CLI for creating, configuring, and scaling Google Cloud resources — Compute
Engine VMs, load balancers, networking, and more. This guide covers the CLI structure, Compute Engine,
and building an HTTP load balancer with managed instance groups.
- [Git](https://kbve.com/application/git/) — Git is a distributed version control system designed to handle everything from small to very large projects with speed and efficiency.
Git allows multiple developers to collaborate, track changes, and manage project history effectively. Ideal for version tracking and collaboration.
- [Godot](https://kbve.com/application/godot/) — Godot is a cross-platform and open source game engine written in GDScript, C#, C++ and Rust.
Godot is a free and open source game engine that offers a unique and innovative way to create 2D and 3D games for various platforms, using a node and scene system, multiple programming languages, and a community-driven development model.
- [Intel NUC Talos Worker Nodes](https://kbve.com/application/intel-nuc-talos/) — Guide for adding Intel NUC devices as Talos Linux worker nodes to the existing KBVE cluster
- [iOS](https://kbve.com/application/ios/) — iOS is Apple's proprietary mobile operating system that powers iPhone, iPad, and iPod Touch devices.
Built on a Unix-based foundation, iOS provides a secure, tightly integrated ecosystem optimized for performance and user experience.
The platform enforces strict app sandboxing and code signing requirements through the Apple Developer Program.
iOS development utilizes Swift or Objective-C with the iOS SDK, Xcode IDE, and Apple's frameworks including UIKit, SwiftUI, and Foundation.
The platform's closed ecosystem ensures consistent hardware-software integration, enabling features like seamless iCloud sync, handoff between devices, and strict privacy controls.
iOS applications must be distributed through the App Store or via enterprise provisioning, requiring Apple Developer membership and adherence to App Store Review Guidelines.
- [Javascript](https://kbve.com/application/javascript/) — JS is a scripting language that enables dynamic content from client and server side.
- [Kubernetes](https://kbve.com/application/kubernetes/) — Kubernetes is a container orchestration system for VMs in a cloud.
- [Linux](https://kbve.com/application/linux/) — Linux has become the heartbeat of modern infrastructure, driving cloud servers, Kubernetes clusters, desktops, and even the tiniest embedded devices across the world.
It offers unmatched flexibility, security, and performance for developers, system administrators, and tinkerers alike.
Whether you're managing containers, automating infrastructure, or exploring the command line, Linux remains the foundation for innovation in the open-source ecosystem.
This section explores its distributions, tools, and best practices within the KBVE stack.
- [Longhorn](https://kbve.com/application/longhorn/) — Longhorn is a cloud-native, distributed block storage system for Kubernetes that delivers persistent,
replicated volumes with snapshots and backups. This guide covers the architecture, installation,
StorageClass configuration, and NFS setup.
- [Machine Learning & Artificial Intelligence](https://kbve.com/application/ml/) — Get ready to explore the exciting world of Machine Learning and Artificial Intelligence.
Our guide covers everything from basic principles and key algorithms to the latest models and tools.
Whether you're just starting out or already have some experience, you'll find valuable insights and practical tips to help you navigate this dynamic field.
Learn about the newest advancements, popular frameworks, and real-world applications.
Perfect for anyone eager to deepen their understanding and skills in AI and ML, this resource is your go-to for all things AI and ML.
- [n8n](https://kbve.com/application/n8n/) — n8n is a fair-code, node-based workflow automation tool that connects APIs, databases, and services without
writing glue code. This guide covers core concepts, self-hosting with Docker, building your first workflow,
and using AI agent nodes.
- [Nginx](https://kbve.com/application/nginx/) — Nginx is a high-performance web server, reverse proxy, and load balancer used to serve static content,
terminate TLS, and route traffic to upstream applications. This guide covers a minimal server block,
a wildcard virtual host, and the KBVE reverse-proxy configuration.
- [Nmap Cheatsheet: Commands, Examples & Tutorials](https://kbve.com/application/nmap/) — Nmap is a network scanner, port mapper, service fingerprinter and
NSE-driven security probe. Full cheatsheet with practical recipes.
- [Nomad](https://kbve.com/application/nomad/) — Nomad by HashiCorp is a lightweight, flexible workload orchestrator that deploys and manages containers,
binaries, and batch jobs across a cluster from a single binary. This guide covers the architecture,
installation, job specification, and the essential CLI compared to Kubernetes.
- [OBS Studio](https://kbve.com/application/obs/) — OBS Studio (Open Broadcaster Software) is a free, open-source application for screen recording and live
streaming to Twitch, YouTube, and beyond. This guide covers scenes and sources, encoder settings, streaming
setup, and extending OBS with plugins.
- [PHP](https://kbve.com/application/php/) — PHP (Hypertext Preprocessor) is a widely-used, dynamic, server-side scripting language for web development
that embeds directly into HTML and powers the classic LAMP stack. This guide covers install, syntax basics,
and reusable functions.
- [Pocketbase](https://kbve.com/application/pocketbase/) — PocketBase is an open-source backend in a single file — an embedded SQLite database with a realtime REST API,
authentication, file storage, and an admin dashboard. This guide covers installing it with Docker Compose,
the CLI, and Coolify, plus collections, auth, and the realtime API.
- [Portainer](https://kbve.com/application/portainer/) — Portainer is a user-friendly backend management tool for containerized applications, offering a visual interface for Docker and Kubernetes environments. 
Think of it as a backend panel that helps design and manage container infrastructure within Docker and Kubernetes.
It simplifies the deployment, monitoring, and scaling of containers, making it easier to manage complex infrastructure.
Thus, with Portainer, teams can streamline their workflows and gain full control over their containerized ecosystem.
This guide covers deploying Portainer on Docker, Docker Swarm, and Kubernetes, plus Edge agents and upgrades.
- 13 more entries in this section — see [/llms-full.txt](https://kbve.com/llms-full.txt) for the full corpus

## Game Design Documents

- [Audio and Sound Design](https://kbve.com/gdd/audio/) — Game audio fundamentals — the audio pipeline, adaptive/interactive music, spatialization, and the mix budget that keeps a soundscape readable.
Own-words reference cross-linked to KBVE projects.
- [Entity Component System](https://kbve.com/gdd/ecs/) — The ECS architecture — entities, components, and systems — and why data-oriented design wins for high-entity-count games.
Own-words reference cross-linked to KBVE's Unity DOTS and Bevy projects.
- [Game Design Documents](https://kbve.com/gdd/) — A collection of Game Design Documents (GDDs) covering game mechanics, systems design, narrative structures, and technical specifications.
GDDs serve as the foundational blueprint for game development projects, aligning teams on vision, scope, and implementation details.
- [Game Programming Patterns](https://kbve.com/gdd/patterns/) — Architecture patterns for game code — decoupling, sequencing, behavioral, and optimization patterns that keep a growing codebase maintainable.
Original summaries with intent, when-to-use, and trade-offs, cross-referenced to the KBVE game projects that apply them.
- [Netcode and Multiplayer](https://kbve.com/gdd/netcode/) — Networking models, replication, and latency-hiding for multiplayer games — authority, prediction, and the trade-offs between client-server and peer-to-peer.
Own-words reference cross-linked to KBVE's transport and server projects.
- [Shaders and Rendering](https://kbve.com/gdd/shaders/) — Real-time rendering and shader fundamentals for game projects — the GPU pipeline, shader stages, common techniques, and the performance budget that governs them.
Own-words reference cross-linked to the KBVE projects that ship custom rendering.
- [Spatial Partitioning and Pathfinding](https://kbve.com/gdd/spatial/) — Spatial acceleration structures (grids, quadtrees, BVH, R-trees, k-d trees, BSP) and pathfinding (A*, flow fields, nav meshes) — how games answer "what is near me?" and "how do I get there?" without touching every object.
Own-words reference cross-linked to KBVE projects.

## Engineering Journal

- [April: 01](https://kbve.com/journal/04-01/) — On April 1st, the world becomes my playground, a day when chaos and laughter intertwine, and everyone gets a taste of shaco's delight.
It's a glorious moment where pranks bloom like flowers in spring, a reminder to dance on the edge of madness and never, ever play it safe.
- [April: 02](https://kbve.com/journal/04-02/) — 2nd of April!
April 2nd arrives with a serene calm, the playful chaos of April Fool's Day having retreated into memory, leaving behind a day for reflection and the ordinary pace of life.
It's a day that bridges the light-heartedness of jest with the groundedness of routine, reminding us of life's delicate balance between joy and duty.
In this quiet aftermath, I find a renewed sense of purpose and a deeper appreciation for the unexpected moments of laughter and the comforting rhythm of the everyday.
- [April: 03](https://kbve.com/journal/04-03/) — 3rd of April.
In dat gentle embrace of the night, my dream wove a tapestry of April showers, where each raindrop whispered tales of renewal, hope and feelings of spiritual dope.
As dawn's first light peeked through, the world outside mirrored my dream, painting everything with dat fresh, dewy promise of a new beginning.
- [April: 04](https://kbve.com/journal/04-04/) — 4th of April
- [April: 05](https://kbve.com/journal/04-05/) — 5th of April. Godzilla has awaken.
- [April: 06](https://kbve.com/journal/04-06/) — 6th of April.
- [April: 07](https://kbve.com/journal/04-07/) — 7th of April.
- [April: 08](https://kbve.com/journal/04-08/) — 8th of April.
- [April: 09](https://kbve.com/journal/04-09/) — 9th of April.
- [April: 10](https://kbve.com/journal/04-10/) — 10th of April.
- [April: 11](https://kbve.com/journal/04-11/) — The season was filled with grey clouds, a hint of cold air with a dash of darkness.
I have this urge to find some red tea and a chicken sandwich, this itch must be resolved.
- [April: 12](https://kbve.com/journal/04-12/) — Dat April 12th.
- [April: 13](https://kbve.com/journal/04-13/) — 13th of Unlucky April.
- [April: 14](https://kbve.com/journal/04-14/) — 14th of April.
- [April: 15](https://kbve.com/journal/04-15/) — Uncle Sam. 15th of April.
- [April: 16](https://kbve.com/journal/04-16/) — April 16. The Dues
- [April: 17](https://kbve.com/journal/04-17/) — Daily Log for April 17th of each year.
- [April: 18](https://kbve.com/journal/04-18/) — Daily Log for April 18th of each year.
- [April: 19](https://kbve.com/journal/04-19/) — Daily Log for April 19th of each year.
- [April: 20](https://kbve.com/journal/04-20/) — Daily Log for April 20th of each year.
- [April: 21](https://kbve.com/journal/04-21/) — Daily Log for April 21st of each year.
- [April: 22](https://kbve.com/journal/04-22/) — Daily Log for April 22nd of each year.
- [April: 23](https://kbve.com/journal/04-23/) — Daily Log for April 23rd of each year.
- [April: 24](https://kbve.com/journal/04-24/) — Daily Log for April 24th of each year.
- [April: 25](https://kbve.com/journal/04-25/) — Daily Log for April 25th of each year.
- [April: 26](https://kbve.com/journal/04-26/) — Daily Log for April 26th of each year.
- [April: 27](https://kbve.com/journal/04-27/) — Daily Log for April 27th of each year.
- [April: 28](https://kbve.com/journal/04-28/) — Daily Log for April 28th of each year.
- [April: 29](https://kbve.com/journal/04-29/) — Daily Log for April 29th of each year.
- [April: 30](https://kbve.com/journal/04-30/) — Daily Log for April 30th of each year.
- 337 more entries in this section — see [/llms-full.txt](https://kbve.com/llms-full.txt) for the full corpus

## KBVE API

- [Interactive API reference](https://kbve.com/dashboard/api/) — Scalar-rendered live spec
- [OpenAPI 3.1 spec](https://kbve.com/api/openapi.json) — machine-readable JSON, generated by utoipa

### System

- `GET /api/status` — api_status
- `GET /health` — health

### Authentication

- `POST /api/v1/auth/game-token` — game_token_handler

### Profile

- `GET /api/v1/me` — GET /api/v1/me — Bearer-authed identity probe. Returns
`{user_id, username, is_staff}`. Used by the compose page to
gate the form (signed-in + has-username before submit) and by
any client surface that needs to mirror user state.
- `GET /api/v1/me/staff` — api_me_staff
- `GET /api/v1/profile/{username}` — Profile API endpoint — returns user profile data as JSON, enriched
from Discord / GitHub / Twitch / RentEarth when available.
- `GET /api/v1/profile/me` — Authenticated profile endpoint — returns the caller's profile.
Requires Bearer token in Authorization header.
- `POST /api/v1/profile/username` — Set username endpoint — creates username for authenticated user.
Validates at axum level, then defers to the proxy_add_username RPC.

### Forum

- `DELETE /api/v1/forum/c/{comment_id}` — DELETE /api/v1/forum/c/{comment_id} — staff remove.
axum checks staff at the JWT layer first, then forwards to the
`service_staff_remove_comment` RPC which re-checks at the SQL layer.
- `PATCH /api/v1/forum/c/{comment_id}` — PATCH /api/v1/forum/c/{comment_id} — author edit-own.
SQL `service_edit_comment` re-checks author ownership.
- `PATCH /api/v1/forum/c/{comment_id}/moderate` — PATCH /api/v1/forum/c/{comment_id}/moderate — staff overwrite body.
- `GET /api/v1/forum/spaces` — GET /api/v1/forum/spaces — JSON list of active spaces.
Drives the astro-kbve build-time spaces.json artifact.
- `POST /api/v1/forum/t/{slug_or_id}/comments` — POST /api/v1/forum/t/{slug_or_id}/comments — Bearer-authed comment.
- `GET /api/v1/forum/tags` — GET /api/v1/forum/tags — JSON list of popularity-sorted tags.
Drives the astro-kbve build-time top-tags fetch.
- `POST /api/v1/forum/threads` — POST /api/v1/forum/threads — Bearer-authed thread creation.
Body: `{ space_slug, title, body, thread_type }`.

### OSRS (Old School RuneScape)

- `GET /api/v1/osrs/{item_id}` — OSRS API endpoint — returns item price data as JSON.
Supports both numeric IDs and item names. Cache refreshes every 60s.

### Minecraft

- `GET /api/v1/mc/players` — MC players API endpoint — returns online player list with UUIDs and skin URLs.
Data is cached and refreshed every 15s via RCON background task.
- `GET /api/v1/mc/players/by-uuid/{uuid}` — MC player skin lookup by UUID — returns skin_url + texture hash for the
supplied Mojang UUID. Falls back to a live Mojang sessionserver query
when the player isn't currently online in the RCON cache.
- `GET /api/v1/mc/textures/{hash}` — MC texture proxy — fetches skin PNGs from textures.minecraft.net.
Hash must be 60-64 hex characters. Responses are immutably cached (24h).

### Telemetry

- `POST /api/v1/telemetry/report` — report_handler

### Dashboard

- `POST /dashboard/clickhouse/proxy` — clickhouse_logs_proxy_handler

### Market

- `GET /api/v1/market/listings` — `GET /api/v1/market/listings` — paged active listings, public/anon.
- `POST /api/v1/market/listings` — `POST /api/v1/market/listings` — create a listing. Returns the new
listing_id. Idempotent on `idempotency_key` — replays return the same id.
- `GET /api/v1/market/listings/{listing_id}` — `GET /api/v1/market/listings/:id` — listing detail + up to 50 recent bids.
- `POST /api/v1/market/listings/{listing_id}/bid` — `POST /api/v1/market/listings/:id/bid` — place a bid. Returns the new
bid_id. Bid funds are debited and held in escrow.
- `POST /api/v1/market/listings/{listing_id}/buy-now` — `POST /api/v1/market/listings/:id/buy-now` — buy a listing at its
`buy_now_price`. Returns the buyer ledger_id.
- `POST /api/v1/market/listings/{listing_id}/cancel` — `POST /api/v1/market/listings/:id/cancel` — cancel an active listing.
Seller-only. Refunds the current high bidder's escrow.
- `GET /api/v1/market/me/bids` — `GET /api/v1/market/me/bids` — caller's bids across listings.
- `GET /api/v1/market/me/listings` — `GET /api/v1/market/me/listings` — caller's listings (seller scope).

### Mc-lot

- `GET /api/v1/mc/lots/me/active` — `GET /api/v1/mc/lots/me/active` — caller-owned lots in `state IN (1, 2)`.
- `POST /api/v1/mc/lots/me/purchase` — `POST /api/v1/mc/lots/me/purchase` — buy a vacant lot.
- `POST /api/v1/mc/lots/me/queue-build` — `POST /api/v1/mc/lots/me/queue-build` — queue a schematic build on the caller's lot.
- `POST /api/v1/mc/lots/me/queue-demolish` — `POST /api/v1/mc/lots/me/queue-demolish` — queue a demolish of a built lot.
- `GET /api/v1/mc/lots/me/transitional` — `GET /api/v1/mc/lots/me/transitional` — caller-owned lots in `state IN (3, 4)`.
- `GET /api/v1/mc/lots/schematics` — `GET /api/v1/mc/lots/schematics` — public catalog.
- `GET /api/v1/mc/lots/vacant` — `GET /api/v1/mc/lots/vacant` — paginated vacant lots in a world.
- `GET /api/v1/mc/lots/viewport` — `GET /api/v1/mc/lots/viewport` — bounding-box map RPC.

### Mc-lot-service

- `POST /api/v1/mc/lots/service/claim` — `POST /api/v1/mc/lots/service/claim` — worker claim batch.
- `POST /api/v1/mc/lots/service/mark-applied` — `POST /api/v1/mc/lots/service/mark-applied` — worker success ACK.
- `POST /api/v1/mc/lots/service/mark-failed` — `POST /api/v1/mc/lots/service/mark-failed` — worker failure ACK.
- `POST /api/v1/mc/lots/service/requeue-stale` — `POST /api/v1/mc/lots/service/requeue-stale` — janitor recovery of orphaned claims.

### Mc-lot-staff

- `GET /api/v1/mc/lots/staff/{lot_id}` — `GET /api/v1/mc/lots/staff/{lot_id}` — raw admin view (owner UUID + timestamps).
- `GET /api/v1/mc/lots/staff/failed` — `GET /api/v1/mc/lots/staff/failed` — keyset list of failed build jobs.
- `POST /api/v1/mc/lots/staff/release-user` — `POST /api/v1/mc/lots/staff/release-user` — release all lots owned by a user.
- `POST /api/v1/mc/lots/staff/repair-orphan` — `POST /api/v1/mc/lots/staff/repair-orphan` — snap orphaned transitional lots back.
- `POST /api/v1/mc/lots/staff/retry` — `POST /api/v1/mc/lots/staff/retry` — re-queue a failed job.

### Rcon

- `POST /api/v1/rcon/{game}/{server}/exec` — `POST /api/v1/rcon/{game}/{server}/exec` — auth + allowlist + jedi::rcon.

### Wallet

- `GET /api/v1/wallet/me/balance` — `GET /api/v1/wallet/me/balance` — returns the caller's wallet balance.
Lazily provisions the wallet account + welcome coupon on first call.
- `GET /api/v1/wallet/me/coupons` — `GET /api/v1/wallet/me/coupons` — returns the caller's coupons
(unredeemed + history).
- `POST /api/v1/wallet/me/redeem-coupon` — `POST /api/v1/wallet/me/redeem-coupon` — redeem one of the caller's coupons.
Ownership-checked + idempotent at the coupon layer.
- `GET /api/v1/wallet/service/balance/{user_id}` — `GET /api/v1/wallet/service/balance/{user_id}` — read another user's
wallet balance from a trusted backend (mc server). Same response shape
as `/api/v1/wallet/me/balance`, but identity comes from the path
instead of the bearer's `sub`. Service-role only.
- `POST /api/v1/wallet/service/credit` — `POST /api/v1/wallet/service/credit` — credit a positive delta to any
account. Returns the resulting ledger id. Idempotent: replays with the
same `idempotency_key` return the original id; mismatched payloads on
the same key raise `409 replay_mismatch`.
- `POST /api/v1/wallet/service/credit-user` — `POST /api/v1/wallet/service/credit-user` — credit keyed on Supabase
user_id rather than wallet account_id. Resolves (or creates) the
account first via `wallet.proxy_ensure_user_account`, then runs the
regular service_credit path. Idempotent with the same key.
- `POST /api/v1/wallet/service/debit` — `POST /api/v1/wallet/service/debit` — deduct from an account. Raises
`402 insufficient_funds` if the balance would go negative.
- `POST /api/v1/wallet/service/redeem-coupon` — `POST /api/v1/wallet/service/redeem-coupon` — redeem a coupon on behalf
of any account. Service-side variant of the user proxy; useful for
admin grants or backend-initiated redemptions.
- `POST /api/v1/wallet/service/revoke-coupon` — `POST /api/v1/wallet/service/revoke-coupon` — admin clawback. Cannot
revoke a redeemed coupon (funds already out). Idempotent: revoking an
already-revoked coupon returns `{revoked: false}` without raising.
- `POST /api/v1/wallet/service/transfer` — `POST /api/v1/wallet/service/transfer` — atomic debit + credit. Locks
both accounts in canonical UUID order to eliminate the A↔B deadlock vector.
- `GET /api/v1/wallet/service/verify-balance/{account_id}` — `GET /api/v1/wallet/service/verify-balance/:account_id` — compare stored
balance vs ledger sum per currency. Run periodically or after suspected
corruption. `ok=true` means consistent.

## Optional

- [GitHub repository](https://github.com/KBVE/kbve)
- [Discord community](https://kbve.com/discord/)
- [llms-full.txt](https://kbve.com/llms-full.txt) — full doc corpus