Agent Skills
› NeverSight/learn-skills.dev
› beamng-mods
beamng-mods
GitHub用于构建和调试BeamNG.drive及BeamMP的Lua模组与插件。支持服务端、客户端及纯游戏扩展开发，提供代码脚手架、事件处理规范及官方文档参考，旨在实现高效、模块化的模组开发流程。
Trigger Scenarios
用户提及BeamNG模组制作或BeamMP服务器插件开发
涉及modScript.lua、extensions.load或MP.RegisterEvent等特定API的使用
需要构建Resources/Server或Resources/Client目录结构
Install
npx skills add NeverSight/learn-skills.dev --skill beamng-mods -g -y
SKILL.md
Frontmatter
{
"name": "beamng-mods",
"source": "local",
"license": "MIT",
"description": "Build and debug BeamNG.drive and BeamMP mods\/resources using Lua. Use this skill whenever the user mentions BeamNG modding, BeamMP server plugins, `Resources\/Server`, `Resources\/Client`, `modScript.lua`, `extensions.load`, `MP.RegisterEvent`, `AddEventHandler`, or client\/server event wiring."
}
BeamNG + BeamMP Modding
Build, scaffold, and debug:
- BeamMP server plugins
- BeamMP client mods (
modScript.lua+ GE extension) - BeamNG Lua extensions (
common/ge/vehicle)
Keep responses concise and implementation-first. Prefer small working patches.
First Decision
Choose one target before writing code:
beammp-serverbeammp-clientbeamng-only
If target is unclear, ask one short clarifying question.
Progressive Loading
Load only what is needed.
For beammp-server:
references/layouts.mdreferences/beammp-server-api.mdexamples/beammp-server-main.lua(when scaffolding code)
For beammp-client:
references/layouts.mdreferences/beammp-client-api.mdexamples/beammp-client-extension.luaexamples/modScript.lua
For beamng-only:
references/layouts.mdreferences/beamng-extension-api.mdexamples/beamng-ge-extension.lua(or adapt for common/vehicle VM)
Core Rules
- Namespace custom events as
pluginName:eventName. - Use JSON payloads for client/server boundaries and validate inputs.
- Keep event handlers short; avoid long blocking loops/sleeps.
- Prefer one small, testable feature per iteration.
- If any local stubs are provided, treat them as helper hints only; prefer official docs on conflicts.
Output Format
When implementing/scaffolding, include:
- Target type (
beammp-server,beammp-client, orbeamng-only) - Final file tree
- Code changes
- Quick test steps
Sources
Prefer official docs first:
- https://docs.beammp.com/scripting/server/latest-server-reference/
- https://docs.beammp.com/scripting/mod-reference/
- https://docs.beammp.com/guides/mod-creation/server/getting-started/
- https://docs.beamng.com/modding/programming/extensions/
- https://docs.beamng.com/modding/programming/virtualmachines/
Optional local sources (only if present in the current repo):
- BeamMP/BeamNG Lua stubs
Version History
- e0220ca Current 2026-07-05 22:09
