AgentSkillsCN

fivem-basics

FiveM 资源结构、fxmanifest、客户端/服务器脚本编写、事件处理。在创建或编辑 FiveM 资源、Lua 脚本,或当用户询问 FiveM 的运行机制时使用。

SKILL.md
--- frontmatter
name: fivem-basics
description: FiveM resource structure, fxmanifest, client/server scripting, events. Use when creating or editing FiveM resources or Lua scripts, or when the user asks how FiveM works.
author: germanfndez
version: 1.0.0
mcp-server: projecthub

FiveM basics

Best practices for FiveM — resources, manifest, client/server, events. Use this skill whenever you are dealing with FiveM code to obtain domain-specific knowledge.

When to use

  • User asks how FiveM resources or scripts work.
  • Editing or creating fxmanifest.lua, client_*.lua, or server.lua.
  • Questions about client/server, events, or exports.
  • Need to look up natives or detailed docs → point to https://docs.fivem.net/natives/ and https://docs.fivem.net/docs/.

How to use

Read individual rule files for detailed explanations and examples:

  • rules/structure.md — Resource structure and organization: scope, client/server separation, logical grouping, naming conventions.
  • rules/fxmanifest.md — Resource manifest (fxmanifest.lua): fx_version, game, client_scripts, server_script, files, dependencies.
  • rules/client-server.md — Client vs server scripts, shared code, communication patterns.
  • rules/events.md — Events in Lua: RegisterNetEvent, TriggerServerEvent, TriggerClientEvent, naming conventions, security.
  • rules/exports.md — Defining and consuming exports between resources.
  • rules/debugging.md — Server vs client (F8) logs; when to ask the user for F8 logs if there's no server-side error.
  • rules/optimization.md — Lua/FiveM optimization: locals, loops, natives (PlayerPedId, vector distance), state bags, security, readability, folder structure.
  • rules/reference-links.md — Official docs and natives reference.