Reject invalid framework/game combinations and offer a multi-framework bridge
Mantenedores costumam responder em até 1 dia
Ninguém assumiu esta issue ainda.
Avaliação
- Dificuldade
- 3/5
- Tempo estimado
- 1-2 dias
- Facilidade para iniciantes
- 55/100
Direção de pesquisa
Start in mcp-server/tools/manifest_common.py at VALID_* and validate_inputs (around lines 21-44) to see how framework, game and language are checked independently. The templates/qbox and templates/vorp fxmanifest.lua headers state the game pinning rule that should become a FRAMEWORK_GAMES map. Run the MCP server per the issue and confirm vorp+gta5 and qbox+rdr3 are rejected while valid combinations still pass. The bridge part (snippets/lua/framework-bridge.lua) is larger design work and can be split out.
Escrita pelo modelo de indexação a partir do texto da issue.
Descrição
Summary
validate_inputs checks game, language and framework independently, so the scaffold and manifest tools accept combinations that cannot load, such as framework="vorp", game="gta5" or framework="qbox", game="rdr3". There is also no scaffold option for a multi-framework bridge, which is how many public resources are built.
Where
mcp-server/tools/manifest_common.py:21-44(VALID_*,validate_inputs)templates/qbox/fxmanifest.lua:2(games { 'gta5' } -- Qbox is FiveM-only),templates/vorp/fxmanifest.lua:2examples/*/server/main.lua:1-15(hand-written ESX/QB bridge, repeated per example)mcp-server/server.py:45(framework docstring)
Details
- The repo's own templates pin ESX/QBCore/Qbox/ox_core to
gta5and VORP/RSG tordr3, but this rule lives only in template comments. - The only multi-framework pattern is a hand-written
GetResourceState(...) == 'started'bridge repeated in the examples, covering ESX and QB only. The scaffold can target only one framework.
Impact
The agent can generate resources that depend on a core that does not exist for the chosen game. Authors of publicly released resources, which commonly support several frameworks, get no scaffolding help.
Suggested fix
- Add a
FRAMEWORK_GAMESmap (esx, qbcore, qbox, oxcore: gta5; vorp, rsg: rdr3; standalone: any) and return an error (or a clear warning) fromvalidate_inputsfor mismatches, includinggame="both"with a single-game framework. - Add
framework="bridge"to the scaffold, plus asnippets/lua/framework-bridge.lua, generating abridge/module withGetPlayer,AddMoney,RemoveMoneyandNotifyfor the supported frameworks, selected at runtime withGetResourceState.
Acceptance criteria
-
scaffold_resource_toolandgenerate_manifest_toolreject (or warn on)vorp+gta5andqbox+rdr3. - Valid combinations are unchanged.
- A
bridgescaffold produces a resource that loads under at least ESX, QBCore and standalone.
Getting started
- Relevant files:
mcp-server/tools/manifest_common.py,mcp-server/tools/scaffold.py,snippets/lua/ - How to run checks: there is no test suite yet; run the MCP server with
cd mcp-server && pip install -r requirements.txt && python server.py, and CI checks live in.github/workflows/validate.yml - Related docs:
skills/framework-detection/SKILL.md,skills/resource-scaffolding/SKILL.md
Filed by repo-audit/full-audit at 701824d. Severity: medium. Effort: S. audit-key: enhancement|mcp-server/tools/manifest_common.py|validate_inputs
- Linguagem predominante
- Python
- Estrelas
- 7
- Forks
- 4
- Métricas de merge de PRs
- Nenhum PR com merge em 30d
Preparar o ambiente
- Sem Dockerfile nem arquivo Docker Compose
- Sem modelo de pull request
- Ler o guia de contribuição
Primeiros passos
- Leia a issue inteira e depois o guia de contribuição do projeto.
- Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
- Faça um fork do repositório e trabalhe em uma branch.
- Abra um pull request que referencie o número da issue.
Mais de TMHSDigital/CFX-Developer-Tools
-
help wanted severity: low tech-debt
Dificuldade 3/5 1-2 dias Facilidade para iniciantes 45/100
TMHSDigital/CFX-Developer-Tools#79 ·
Mantenedores costumam responder em até 1 dia
-
enhancement help wanted severity: low
Dificuldade 3/5 1-2 dias Facilidade para iniciantes 55/100
TMHSDigital/CFX-Developer-Tools#68 ·
Mantenedores costumam responder em até 1 dia
-
help wanted severity: low tech-debt
Dificuldade 4/5 3-5 dias Facilidade para iniciantes 35/100
TMHSDigital/CFX-Developer-Tools#66 ·
Mantenedores costumam responder em até 1 dia
-
dependencies severity: low
Dificuldade 3/5 1-2 dias Facilidade para iniciantes 65/100
TMHSDigital/CFX-Developer-Tools#62 · 2 comentários ·
Mantenedores costumam responder em até 1 dia
-
enhancement severity: medium
Dificuldade 4/5 3-5 dias Facilidade para iniciantes 42/100
TMHSDigital/CFX-Developer-Tools#57 ·
Mantenedores costumam responder em até 1 dia
Todas as issues de TMHSDigital/CFX-Developer-Tools
Issues semelhantes
-
hive size:simple
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 78/100
Mantenedores costumam responder em até 1 dia
-
A new VOLTTRON_HOME starts with agent isolation mode on (string comparison of a boolean default)Aberta
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 68/100
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 70/100
painted-porch/marcus#977 ·
Mantenedores costumam responder em até 1 dia
-
llm translation
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 82/100
Mantenedores costumam responder em até 1 dia
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 78/100
FAIRmat-NFDI/sand#239 ·
Mantenedores costumam responder em até 1 dia