beamng-modding
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| BEAMNG_MOD_ROOT | Yes | Required writable mod workspace | |
| BEAMNG_GAME_ROOT | No | Optional read-only BeamNG installation/content root | |
| BEAMNG_DOCS_CACHE | No | Optional documentation cache location | |
| BEAMNG_DOCS_TTL_HOURS | No | Cache freshness interval; defaults to 24 | 24 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| beamng_docs_searchA | Search the synchronized official BeamNG modding documentation and return cited sections. |
| beamng_docs_getA | Read a cached official page by document ID or approved documentation URL. |
| beamng_docs_syncB | Refresh the bounded local index from official BeamNG modding pages. |
| beamng_source_searchB | Search configured, read-only local BeamNG text files for APIs and real usage examples. |
| beamng_mod_scaffoldC | Create a safe minimal text-only mod structure under the configured workspace. |
| beamng_mod_write_filesA | Atomically write a bounded set of UTF-8 files inside the configured workspace. |
| beamng_mod_validateA | Statically validate mod structure, JBeam/JSON/materials, metadata, paths, and references. |
| beamng_mod_packageB | Validate and create a deterministic BeamNG-compatible ZIP archive. |
| beamng_best_practicesC | Return applicable evidence-backed guidance with explicit source classification. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| plan-beamng-mod | |
| review-beamng-mod | |
| diagnose-beamng-error | |
| prepare-beamng-release |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| beamng-best-practices | Evidence-backed rules shipped with the server. |
| beamng-templates | Text files generated for each supported mod type. |
| beamng-latest-validation |
TDQS
Scored across 9 tools
Most tools have clearly distinct purposes: docs search/get/sync act on documentation, source_search on local source files, and the mod_* tools form a scaffolding→writing→validation→packaging pipeline. The only mild overlap is between beamng_mod_scaffold and beamng_mod_write_files, but scaffold creates structure while write_files writes arbitrary file content, so they are separable.
Names follow a strong snake_case pattern with the beamng_ prefix, and most use a verb-noun construction (docs_search, source_search, mod_validate, mod_package). The slight outlier is beamng_best_practices, which is noun-only and breaks the verb-led pattern.
Nine tools is well within the ideal range for a focused modding server. Each tool contributes a distinct stage or capability: documentation access, source lookup, scaffolding, file writing, validation, packaging, and guidance, without unnecessary bloat.
The toolset covers the core mod creation lifecycle: research docs, scaffold, write files, validate, and package. Minor gaps include lack of a tool to list or read existing mod files in the workspace, and no explicit update/delete operations, but the workflow is otherwise complete for building a mod.