Syn_Sit — Manual

Sistema de sentar, deitar e encostar: cadeiras e camas do mundo viram assentos com target, mais “sentar em qualquer lugar” e “encostar na parede”.

Sumário

1. Dependências
2. Instalação
3. Configuração
4. Comandos e teclas
5. Assentos por objeto (config.lua)
6. Assentos customizados (customize_seats.lua)
7. Assentos por zona (polyseats.lua)
8. Sentar em qualquer lugar
9. Encostar na parede
10. Modo debug — criando assentos
11. Estrutura de arquivos

Dependências

O recurso é client-only e não usa framework (QBCore/ESX).

Instalação

1. Copie a pasta Syn_Sit para resources/.
2. Adicione ao server.cfg:

   ensure Syn_Sit
3. Ajuste Config.TargetSytem em config.lua para o target que você usa ('OX' ou 'QB').
4. Desligue o modo debug em produção — Config.Debug vem como true no repositório. Veja Modo debug.

Não há SQL nem itens de inventário.

O fxmanifest.lua declara escrow_ignore para todos os arquivos Lua e da NUI — ou seja, eles ficam abertos mesmo se o recurso for empacotado.

Configuração

Opções gerais no topo de config.lua.

Config.AnimDescriptions aceita duas formas:

-- Scenario: chave = nome do scenario
["PROP_HUMAN_SEAT_CHAIR"] = { title = "Assento de Cadeira", description = "Animação de assento para cadeiras." },
 
-- Animação: chave = dicionário, sub-chave = nome da animação
['anim@gangops@morgue@table@'] = {
    ['ko_front'] = { Title = 'Lie Still', description = 'play dead.' }
},

Comandos e teclas

Comandos adicionais existem apenas com Config.Debug = true — veja Modo debug.

Assentos por objeto (config.lua)

Config.objects liga um modelo de objeto do mundo a uma lista de animações de assento. O target é adicionado ao modelo (addModel / AddTargetModel).

{ objName = "v_med_bed2", Animations = {
    { right_left_X = 0.0, forward_backwards_Y = 0.0, up_down_z = 1.2, Heading = 290.0, anim = 'WORLD_HUMAN_PICNIC' },
    { right_left_X = 0.0, forward_backwards_Y = 0.0, up_down_z = -0.6, Heading = 0.0, dict = 'anim@gangops@morgue@table@', anim = 'ko_front' },
    { anim = 'PROP_HUMAN_SEAT_CHAIR', right_left_X = 0.2, forward_backwards_Y = 0.0, up_down_z = 0.4, Heading = 90.0, IsSittingAnim = true, skipExitScene = false },
} },

Campos de cada animação:

Objetos com múltiplos assentos

Quando Animations é uma tabela indexada ([1] = {...}, [2] = {...}) e existe multiSeat, cada índice vira um lugar independente e o nome vem de multiSeat[i]:

multiSeat = {
    "lado Direito",
    "Centro",
    "lado Esquerdo",
}

Assentos customizados (customize_seats.lua)

Config.custom_seats tem exatamente o mesmo formato de Config.objects. É o lugar para registrar props de MLOs e mobília que não é nativa do GTA V, mantendo config.lua limpo. O arquivo já traz exemplos (cadeira de taverna, banquinho do Vanilla Unicorn, bancos em L e em U do Burger Shot).

Assentos por zona (polyseats.lua)

Config.PolySeats cria assentos em coordenadas fixas do mundo, sem depender de um objeto — útil para muretas, degraus, o letreiro de Vinewood etc.

Sentar em qualquer lugar

O comando /sit clona o personagem com transparência, tocando a primeira animação de Config.SitAnyWhereAnims. O clone acompanha a mira da câmera; o jogador escolhe onde e como sentar antes de confirmar.

Controles do modo de posicionamento (exibidos na tela):

Cada entrada de Config.SitAnyWhereAnims tem:

Encostar na parede

A tecla J (comando _SynSit_Lean, remapeável) faz o personagem encostar na parede mais próxima. O recurso:

1. Detecta a parede e a normal dela.
2. Sorteia um conjunto de animações compatível com o gênero do ped (mp_m_freemode_01 / mp_f_freemode_01).
3. Escolhe a animação de entrada correta conforme o ângulo da parede.

Só funciona com o jogador a pé, vivo, parado (não correndo, nadando ou em combate corpo a corpo). Os conjuntos de animação ficam no topo de client/lean.lua.

Modo debug — criando assentos

Com Config.Debug = true, ficam disponíveis:

A saída dos comandos é exibida na NUI (html/index.html). O arquivo client/seat_maker.txt traz notas do autor sobre o processo de criação.

Deixe Config.Debug = false em produção: os comandos ficam abertos a qualquer jogador e os markers de debug são desenhados na tela.

Estrutura de arquivos

Syn_Sit/
├── client/
│   ├── client.lua           — registro do target (ox/qb), menus de contexto, entrada/saída do assento, câmera de cadeira
│   ├── utils.lua            — funções auxiliares (raycast de câmera, arredondamento)
│   ├── lean.lua             — encostar na parede: conjuntos de animação, detecção de parede, keybinding J
│   ├── sitanywhere.lua      — comando /sit: clone translúcido, seleção de animação e posicionamento
│   ├── debug.lua            — comandos de criação de assento (só com Config.Debug)
│   └── seat_maker.txt       — notas do autor sobre como criar assentos
├── config.lua               — opções gerais, descrições de animação, animações do /sit e Config.objects
├── customize_seats.lua      — Config.custom_seats: assentos de props de MLO / não nativos
├── polyseats.lua            — Config.PolySeats: assentos por coordenada, sem objeto
├── html/
│   ├── index.html           — painel usado pelo modo debug para exibir coordenadas e blocos de config
│   ├── init.js              — recebe as SendNUIMessage do debug
│   └── jquery.js
└── fxmanifest.lua