Lumo Bagh-Chal — installation guide

1. Dependencies

Resource	Required	Notes
oxmysql	yes	Any recent version
qb-core / qbx_core / es_extended	no	Detected at start. None = standalone mode
ox_target / qb-target	no	Without one, a built-in [E] Play Bagh-Chal prompt is used
object_gizmo + ox_lib	admins	Moves/rotates the table and chairs in /baghchaltables
ox_lib or qb-menu	no	Leaderboard menu (otherwise it prints to chat)
lumo-interact	no	Used for prompts if present

2. Install

1. Drop the lumo-baghchal folder into resources/ (any folder name works). Keep and the stream/ folder (the board and pieces).
2. Add the resource to server.cfg after the resources it detects:

   ensure oxmysql
   ensure ox_lib
   ensure qb-core          # or qbx_core / es_extended
   ensure ox_target        # or qb-target
   ensure object_gizmo
   ensure lumo-baghchal

3. Start the server. The console prints [lumo-baghchal] framework: qb (or qbx, esx, standalone). If it's wrong, set Config.Framework in config.lua.
4. lumo_baghchal_tables and lumo_game_stats are created on first start. sql/install.sql is only needed if your database user can't create tables.

3. Give yourself admin

Admins are the framework groups in Config.Admin.permissions, or anyone with the ACE in Config.Admin.ace (default command, which txAdmin admins already have).

• QBCore / Qbox: admin and god work out of the box.
• ESX: add 'superadmin' to Config.Admin.permissions if you use it.
• Standalone: add_ace group.admin command allow + add_principal identifier.license:xxxx group.admin.

4. Place a table

1. Go where the table should stand and run /baghchaltables.
2. + New table here spawns a ghost table with two chairs facing each other.
3. Pick a table model and chair model (or None to use a table or chairs already in the map).
4. Fly camera lets you fly around and aim, then press E to drop the table there. Move / rotate table opens the gizmo (W move, R rotate, Enter done). Use Chair 1/2 for one chair, or Auto-arrange chairs.
5. Save table. The board appears on it for everyone within spawnDistance.

5. Play

Walk up to the table, target it (or press E) → Play Bagh-Chal. Host as tigers or goats, or Practice vs Lumo AI. The second player Joins from the list, and others can Watch. Click a piece, then a highlighted point. Backspace twice leaves.

6. Tuning

• Seat height per chair model: Config.Admin.chairModels[n].sitZ.
• Camera: Config.Table3D.camHeight, camBack, camFov and overview.
• Board sinks into or floats above a table: Config.Table3D.surfaceOffset.
• Clicks hit the wrong point: debugPoints = true, then faceFlipU / faceFlipV.

7. Updating

Replace every file except config.lua (compare it for new options), restart the resource, and ask players to clear their cache if the board looks wrong. Placed tables and stats are kept in the database.