Reject invalid framework/game combinations and offer a multi-framework bridge
Maintainer thường phản hồi trong vòng 1 ngày
Chưa có ai nhận issue này.
Đánh giá
- Độ khó
- 3/5
- Thời gian dự kiến
- 1-2 ngày
- Mức phù hợp với người mới
- 55/100
Hướng nghiên cứu
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.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
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
- Ngôn ngữ chính
- Python
- Star
- 7
- Fork
- 4
- Chỉ số merge pull request
- Không có pull request nào được merge trong 30 ngày
Chuẩn bị môi trường
- Không có Dockerfile hay tệp Docker Compose
- Không có mẫu pull request
- Đọc hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của TMHSDigital/CFX-Developer-Tools
-
help wanted severity: low tech-debt
Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 45/100
TMHSDigital/CFX-Developer-Tools#79 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
enhancement help wanted severity: low
Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 55/100
TMHSDigital/CFX-Developer-Tools#68 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
help wanted severity: low tech-debt
Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 35/100
TMHSDigital/CFX-Developer-Tools#66 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
dependencies severity: low
Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 65/100
TMHSDigital/CFX-Developer-Tools#62 · 2 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
-
enhancement severity: medium
Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 42/100
TMHSDigital/CFX-Developer-Tools#57 ·
Maintainer thường phản hồi trong vòng 1 ngày
Tất cả issue của TMHSDigital/CFX-Developer-Tools
Issue tương tự
-
A new VOLTTRON_HOME starts with agent isolation mode on (string comparison of a boolean default)Đang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 68/100
-
llm translation
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 82/100
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100
FAIRmat-NFDI/sand#239 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
bug P2
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 72/100
coco-research/coco#539 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
dependencies
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 62/100
JustBeanie/hass-volcano-hybrid#34 ·
Maintainer thường phản hồi trong vòng 1 ngày