Documentação/Produtos

Sistema de Cinema

Configure fuso horário, economia, inventário, ingressos, sessões, salas, catálogo de filmes, bomboniere e traduções.

Pasta do resource
[TS]Cinema
Arquivo de configuração
[SistemaDeCinema]/[TS]Cinema/Config.lua

Antes de instalar

Se você está começando agora, siga esta ordem. Ela evita a maior parte dos erros de ativação, permissão e dependência.

1. Proteção pronta Instale o módulo MTAX:SA, cadastre o IP e coloque sua KEY no Config.lua.
2. Pasta correta Mantenha o resource com o nome esperado: [TS]Cinema.
3. Dependências ligadas Inicie inventário, notificação, blur, banco ou utilitários citados nesta página antes do produto.
4. Debug limpo Reinicie o resource e confira o console. Se aparecer erro, corrija antes de liberar aos jogadores.
Permissão do resource Se o mod precisar de permissão no ACL, adicione o resource ao grupo correto usando o nome exato da pasta. Para este produto, a referência é resource.[TS]Cinema.
Objeto ACL do resource
resource.[TS]Cinema
Este produto usa comunicação externa Libere também function.fetchRemote no ACL do servidor. Sem essa permissão, a validação pode falhar mesmo com a KEY correta.

Abrir guia completo de instalação e ativação

Como ler os códigos nesta página

Config.lua Arquivo principal onde você altera KEY, permissões, comandos, valores, cores, posições e integrações.
Blocos grandes Servem para localizar a parte correta no arquivo. Não cole o bloco inteiro por cima do seu arquivo sem revisar.
Trechos curtos Podem ser comandos, exports ou exemplos de ACL. Copie apenas quando a legenda disser que é para usar.
Video do produto Sistema de Cinema na loja TioSam Scripts.

Fuso horário

Ajuste obrigatórioO fuso precisa corresponder à localização real da hospedagem. Caso contrário, sessões podem iniciar fora do horário ou ser rejeitadas como antigas.
Hospedagem no Brasil
config = {
    serverTimezone = 'BRT',
    timezoneOffset = -3, -- usado apenas com CUSTOM
}

Valores disponíveis

  • BRT: Brasil, UTC-3.
  • AST: República Dominicana, UTC-4.
  • WET: Portugal.
  • EST: EUA, Nova York.
  • PST: EUA, Los Angeles.
  • UTC: horário universal.
  • CUSTOM: usa timezoneOffset.

Integrações

O cinema integra dinheiro, notificações, inventário e efeito de blur diretamente no Config.lua. Ajuste somente os nomes usados pelo seu servidor.

Dinheiro e inventário
getCash = function(player)
    return getElementData(player, 'moneycoins') or 0
end,

requireBlur = true,

getItem = function(player, itemName)
    return exports['inventario']:getItem(player, itemName) or 0
end,

Pontos de adaptação

moneycoins
Troque pela element data usada como saldo na sua base.
dxmessages
Troque pelo resource de notificações, caso utilize outro.
requireBlur
Use false quando o resource Blur não estiver ativo.
inventario
Troque pelo nome do seu sistema e mantenha as operações de consultar, entregar e remover item.

Administração e categorias

Os comandos e ACLS administrativas estão reunidos no mesmo bloco. As categorias organizam os filmes no tablet e definem o intervalo das sessões automáticas.

ACLS e categorias
acls = {'Console', 'Youtuber'},

movieCategories = {
    {
        name = 'Geral',
        offset = 0,
        movies = {},
    },
    {
        name = 'Animação',
        offset = 0,
        movies = {1, 2, 3, 4, 5},
    },
}
Categoria GeralMantenha Geral como primeira categoria e deixe movies = {} para incluir todo o catálogo.

Ingressos e área aberta

Controle de entrada
needItem = false,
itemName = 'ingresso',
needACL = false,
buyAcls = {'VIP'},
openAirAutoValidation = true,
openAirMarkerVisible = false,
openAirMarkerRadius = 60,

Opções

needItem
Exige item de ingresso no inventário.
needACL / buyAcls
Restringe a compra a grupos específicos.
openAirAutoValidation
Valida automaticamente a entrada nas salas abertas.
openAirMarkerRadius
Raio da área de validação em metros.

Traduções

Selecione o idioma em config.traducoes.idiomaSelecionado. O arquivo já inclui blocos para português, inglês e espanhol.

Idioma do painel
traducoes = {
    idiomaSelecionado = "pt-BR",
    ["pt-BR"] = {
        -- mensagens e textos da interface
    },
}
Documentação baseada no Config.lua e no meta.xml presentes na cópia local analisada.