DRS Server Guide

ensure drs_serverguide

Config.Content = {
    pt = {
        {
            icon = "🚀", title = "Primeiros Passos",
            items = {
                { title = "Bem-vindo à cidade", text = "Começa por tirar o cartão de cidadão na câmara municipal." },
                { title = "Pedir ajuda", text = "Usa /report para falar com a staff." },
            },
        },
    },
    en = { --[[ as mesmas secções em inglês ]] },
}

Config = {}

-- Idioma / Language: 'pt' ou 'en'
Config.Locale = 'pt'

-- Comandos para abrir o guia / Commands that open the guide
Config.Commands = { 'guia', 'guide' }

-- Tecla opcional ('' = sem tecla) / Optional key ('' = no key)
Config.DefaultKey = 'F9'

-- Abrir automaticamente na primeira vez que o jogador entra / Open automatically on the player's first join
Config.OpenOnFirstJoin = true

-- Evento de "personagem carregado": 'auto' deteta QBCore/Qbox/ESX/ox_core, ou mete o nome do evento; false = standalone
-- "Character loaded" event: 'auto' detects QBCore/Qbox/ESX/ox_core, or set the event name; false = standalone
Config.PlayerLoadedEvent = 'auto'

-- Espera depois de o personagem carregar, em ms / Delay after the character loads, in ms
Config.FirstJoinDelay = 4000

-- Animação de segurar um tablet enquanto o guia está aberto / Hold-a-tablet animation while the guide is open
Config.TabletAnim = true

-- Nome e cor do servidor no topo do tablet / Server name and accent color at the top of the tablet
Config.ServerName = 'O Meu Servidor'
Config.AccentColor = '#6366f1'

-- Conteúdo do guia por idioma. Cada secção: icon, title, items (lista de { title, text })
-- Todo o texto é um exemplo: adapta as regras, comandos e ligações ao teu servidor.
-- Guide content per language. Each section: icon, title, items (list of { title, text })
-- All text is an example: adapt the rules, commands and links to your server.
Config.Content = {
    pt = {
        {
            icon = "🚀", title = "Primeiros Passos",
            items = {
                { title = "Bem-vindo à cidade", text = "Acabaste de chegar. Começa por tirar o cartão de cidadão na câmara municipal e procura o teu primeiro emprego." },
                { title = "Dinheiro inicial", text = "Recebes uma quantia inicial no banco. Usa-a com cabeça: comida, bebida e transporte primeiro." },
                { title = "Telemóvel", text = "O telemóvel é a tua ferramenta principal: contactos, mensagens, banco, GPS e redes sociais da cidade." },
                { title = "Fome e sede", text = "Come e bebe com regularidade. Encontras lojas de conveniência espalhadas pelo mapa (ícone no mapa)." },
                { title = "Pedir ajuda", text = "Tens dúvidas? Pergunta no Discord ou usa /report dentro do jogo para falar com a staff." },
            },
        },
        {
            icon = "📜", title = "Regras Gerais",
            items = {
                { title = "Respeito acima de tudo", text = "Trata todos os jogadores e membros da staff com respeito. Insultos fora do roleplay, racismo e assédio dão ban." },
                { title = "Batota e exploits", text = "É proibido usar mod menus, macros ou aproveitar bugs. Se encontrares um bug, reporta-o à staff." },
                { title = "Uma conta por pessoa", text = "Não é permitido usar contas alternativas para contornar castigos ou ganhar vantagem." },
                { title = "Idade mínima", text = "O servidor é para maiores de 16 anos. A staff pode pedir confirmação em caso de dúvida." },
                { title = "Decisões da staff", text = "As decisões da staff são para cumprir no momento. Se discordares, abre um ticket no Discord depois." },
            },
        },
        {
            icon = "🎭", title = "Roleplay",
            items = {
                { title = "Mantém a personagem", text = "Fica sempre em personagem. Assuntos de fora do jogo tratam-se no Discord, não na cidade." },
                { title = "Metagaming", text = "Não uses informação que a tua personagem não sabe (streams, Discord, chamadas fora do jogo)." },
                { title = "Powergaming", text = "Não forces ações impossíveis nem deixes os outros sem hipótese de reagir. Dá sempre espaço ao roleplay." },
                { title = "Valoriza a tua vida", text = "Age como se a tua vida valesse. Com uma arma apontada, colabora em vez de arriscar tudo." },
                { title = "Nova vida", text = "Se morreres e não fores reanimado, esqueces o que levou à tua morte e não voltas ao local." },
            },
        },
        {
            icon = "🔫", title = "Combate e Crime",
            items = {
                { title = "RDM", text = "Matar sem motivo de roleplay (Random Death Match) é proibido. Tem de haver sempre uma interação antes." },
                { title = "VDM", text = "Usar o carro como arma sem motivo (Vehicle Death Match) é proibido." },
                { title = "Assaltos", text = "Cada assalto tem um número mínimo de polícias online. Confirma antes de começar." },
                { title = "Reféns", text = "Os reféns devem ser tratados com roleplay. Não uses amigos combinados como reféns falsos." },
                { title = "Zonas seguras", text = "Hospitais, esquadras e o centro de emprego são zonas seguras: nada de crimes lá dentro." },
            },
        },
        {
            icon = "🚗", title = "Veículos e Condução",
            items = {
                { title = "Stand", text = "Compra o teu carro no stand da cidade. Os preços e o stock mudam ao longo do tempo." },
                { title = "Garagens", text = "Guarda o carro na garagem antes de sair. Carros abandonados vão para o parque de apreensão." },
                { title = "Seguro", text = "Faz seguro ao teu veículo na seguradora. Sem seguro, recuperar um carro apreendido fica mais caro." },
                { title = "Combustível", text = "Atesta nas bombas de gasolina. Um carro sem combustível para no meio da estrada." },
                { title = "Condução realista", text = "Conduz de forma credível: nada de saltos impossíveis ou subir montanhas com carros desportivos." },
            },
        },
        {
            icon = "🚓", title = "Polícia e Emergência",
            items = {
                { title = "Chamar a polícia", text = "Usa o telemóvel para ligar para o 112 e descrever a situação." },
                { title = "Colaborar numa abordagem", text = "Numa operação STOP ou abordagem, segue as indicações do agente. Fugir tem consequências." },
                { title = "INEM", text = "Se ficares ferido, espera pelo INEM. Não te levantes nem saias do local sem tratamento." },
                { title = "Direitos", text = "Tens direito a advogado e a saber do que és acusado. Pede-o em roleplay." },
                { title = "Candidaturas", text = "Queres entrar para as forças de segurança ou para o INEM? As candidaturas são feitas no Discord." },
            },
        },
        {
            icon = "💼", title = "Empregos",
            items = {
                { title = "Centro de emprego", text = "Na câmara municipal encontras os empregos civis: camionista, lixeiro, taxista, entregas e outros." },
                { title = "Empregos com chefia", text = "Mecânicos, restaurantes e empresas têm chefes que contratam. Vai ao local e pede uma oportunidade." },
                { title = "Salário", text = "O salário é pago a cada período de tempo enquanto estás de serviço. Não te esqueças de entrar em serviço." },
                { title = "Progressão", text = "Com o tempo e bom trabalho podes subir de cargo e ganhar mais. A chefia decide as promoções." },
                { title = "Criar uma empresa", text = "Tens uma ideia de negócio? Fala com a staff no Discord para saber os requisitos." },
            },
        },
        {
            icon = "💰", title = "Economia e Negócios",
            items = {
                { title = "Banco", text = "Guarda o dinheiro no banco. O dinheiro vivo pode ser roubado se fores assaltado." },
                { title = "Transferências", text = "Podes transferir dinheiro para outros jogadores pelo banco ou pelo telemóvel." },
                { title = "Faturas", text = "Empresas e serviços podem passar-te faturas. Paga-as a tempo para evitar problemas." },
                { title = "Casas", text = "Podes comprar ou arrendar casa para guardar roupa e objetos. Fala com a imobiliária." },
                { title = "Comércio entre jogadores", text = "Vendas entre jogadores são permitidas, mas trocas de dinheiro real por itens do jogo são proibidas." },
            },
        },
        {
            icon = "⌨️", title = "Comandos",
            items = {
                { title = "/guia", text = "Abre este guia a qualquer momento (ou tecla F9)." },
                { title = "/me e /do", text = "/me descreve uma ação da tua personagem; /do descreve o ambiente ou o resultado de uma ação." },
                { title = "/report", text = "Envia uma mensagem à staff online quando precisares de ajuda." },
                { title = "/fps", text = "Abre o menu de desempenho para ganhar FPS se o teu PC tiver dificuldades." },
                { title = "Teclas", text = "Podes mudar as teclas dos scripts em Definições > Teclas > FiveM." },
            },
        },
        {
            icon = "🛡️", title = "Staff e Denúncias",
            items = {
                { title = "Como denunciar", text = "Usa /report no jogo ou abre um ticket no Discord com o máximo de detalhe possível." },
                { title = "Provas", text = "Grava o teu ecrã sempre que possível. Uma denúncia com vídeo é resolvida muito mais depressa." },
                { title = "Não resolvas sozinho", text = "Se alguém quebrar as regras, continua o roleplay e denuncia depois. Não respondas com mais regras quebradas." },
                { title = "Castigos", text = "Os castigos vão de avisos a banimentos, conforme a gravidade e o historial do jogador." },
                { title = "Recursos", text = "Achas que um castigo foi injusto? Podes recorrer através de ticket no Discord." },
            },
        },
        {
            icon = "🔗", title = "Ligações",
            items = {
                { title = "Discord", text = "discord.gg/o-teu-convite: anúncios, candidaturas, suporte e comunidade." },
                { title = "Loja", text = "loja.o-teu-servidor.com: apoia o servidor e recebe benefícios VIP." },
                { title = "Regras completas", text = "A versão completa das regras está no canal #regras do Discord." },
                { title = "Redes sociais", text = "Segue-nos para saberes de eventos e novidades." },
                { title = "Sugestões", text = "Tens uma ideia para melhorar a cidade? Deixa-a no canal #sugestões do Discord." },
            },
        },
    },
    en = {
        {
            icon = "🚀", title = "Getting Started",
            items = {
                { title = "Welcome to the city", text = "You have just arrived. Start by getting your ID card at city hall and look for your first job." },
                { title = "Starting money", text = "You get some starting money in the bank. Spend it wisely: food, drinks and transport first." },
                { title = "Phone", text = "Your phone is your main tool: contacts, messages, bank, GPS and the city's social networks." },
                { title = "Hunger and thirst", text = "Eat and drink regularly. Convenience stores are spread around the map (map icon)." },
                { title = "Ask for help", text = "Questions? Ask on Discord or use /report in game to talk to staff." },
            },
        },
        {
            icon = "📜", title = "General Rules",
            items = {
                { title = "Respect above all", text = "Treat every player and staff member with respect. Out-of-character insults, racism and harassment mean a ban." },
                { title = "Cheats and exploits", text = "Mod menus, macros and bug abuse are forbidden. If you find a bug, report it to staff." },
                { title = "One account per person", text = "Alt accounts to dodge punishments or gain an advantage are not allowed." },
                { title = "Minimum age", text = "The server is 16+. Staff may ask for confirmation when in doubt." },
                { title = "Staff decisions", text = "Follow staff decisions in the moment. If you disagree, open a Discord ticket afterwards." },
            },
        },
        {
            icon = "🎭", title = "Roleplay",
            items = {
                { title = "Stay in character", text = "Always stay in character. Out-of-game matters belong on Discord, not in the city." },
                { title = "Metagaming", text = "Do not use information your character does not know (streams, Discord, out-of-game calls)." },
                { title = "Powergaming", text = "Do not force impossible actions or leave others no chance to react. Always leave room for roleplay." },
                { title = "Value your life", text = "Act as if your life matters. With a gun pointed at you, cooperate instead of risking everything." },
                { title = "New life", text = "If you die and are not revived, you forget what led to your death and do not return to the scene." },
            },
        },
        {
            icon = "🔫", title = "Combat and Crime",
            items = {
                { title = "RDM", text = "Killing without a roleplay reason (Random Death Match) is forbidden. There must always be an interaction first." },
                { title = "VDM", text = "Using your car as a weapon without a reason (Vehicle Death Match) is forbidden." },
                { title = "Robberies", text = "Each robbery needs a minimum number of police online. Check before you start." },
                { title = "Hostages", text = "Hostages must be roleplayed. Do not use friends as fake hostages." },
                { title = "Safe zones", text = "Hospitals, police stations and the job center are safe zones: no crime inside." },
            },
        },
        {
            icon = "🚗", title = "Vehicles and Driving",
            items = {
                { title = "Dealership", text = "Buy your car at the city dealership. Prices and stock change over time." },
                { title = "Garages", text = "Park your car in a garage before logging off. Abandoned cars go to the impound." },
                { title = "Insurance", text = "Insure your vehicle at the insurance company. Without it, getting an impounded car back costs more." },
                { title = "Fuel", text = "Fill up at gas stations. A car with no fuel stops in the middle of the road." },
                { title = "Realistic driving", text = "Drive believably: no impossible jumps or climbing mountains in sports cars." },
            },
        },
        {
            icon = "🚓", title = "Police and Emergency",
            items = {
                { title = "Calling the police", text = "Use your phone to call 911 and describe the situation." },
                { title = "Traffic stops", text = "During a stop, follow the officer's instructions. Running away has consequences." },
                { title = "EMS", text = "If you are injured, wait for EMS. Do not get up or leave the scene without treatment." },
                { title = "Rights", text = "You have the right to a lawyer and to know your charges. Ask for it in roleplay." },
                { title = "Applications", text = "Want to join the police or EMS? Applications are made on Discord." },
            },
        },
        {
            icon = "💼", title = "Jobs",
            items = {
                { title = "Job center", text = "City hall has the civilian jobs: trucker, garbage, taxi, deliveries and more." },
                { title = "Company jobs", text = "Mechanics, restaurants and companies have bosses who hire. Go there and ask for a chance." },
                { title = "Salary", text = "Salary is paid every period while you are on duty. Do not forget to go on duty." },
                { title = "Promotions", text = "With time and good work you can move up and earn more. Management decides promotions." },
                { title = "Start a company", text = "Have a business idea? Talk to staff on Discord to learn the requirements." },
            },
        },
        {
            icon = "💰", title = "Economy and Business",
            items = {
                { title = "Bank", text = "Keep your money in the bank. Cash can be stolen if you get robbed." },
                { title = "Transfers", text = "You can transfer money to other players through the bank or your phone." },
                { title = "Invoices", text = "Companies and services can bill you. Pay on time to avoid trouble." },
                { title = "Houses", text = "You can buy or rent a house to store clothes and items. Talk to the real estate agency." },
                { title = "Player trading", text = "Player-to-player sales are allowed, but real money for in-game items is forbidden." },
            },
        },
        {
            icon = "⌨️", title = "Commands",
            items = {
                { title = "/guide", text = "Opens this guide at any time (or the F9 key)." },
                { title = "/me and /do", text = "/me describes your character's action; /do describes the surroundings or the result of an action." },
                { title = "/report", text = "Sends a message to online staff when you need help." },
                { title = "/fps", text = "Opens the performance menu to gain FPS if your PC struggles." },
                { title = "Keys", text = "You can change script keys in Settings > Key Bindings > FiveM." },
            },
        },
        {
            icon = "🛡️", title = "Staff and Reports",
            items = {
                { title = "How to report", text = "Use /report in game or open a Discord ticket with as much detail as possible." },
                { title = "Evidence", text = "Record your screen whenever you can. A report with video is solved much faster." },
                { title = "Do not retaliate", text = "If someone breaks the rules, keep roleplaying and report it later. Do not answer with more broken rules." },
                { title = "Punishments", text = "Punishments range from warnings to bans, depending on severity and the player's history." },
                { title = "Appeals", text = "Think a punishment was unfair? You can appeal through a Discord ticket." },
            },
        },
        {
            icon = "🔗", title = "Links",
            items = {
                { title = "Discord", text = "discord.gg/your-invite: announcements, applications, support and community." },
                { title = "Store", text = "store.your-server.com: support the server and get VIP perks." },
                { title = "Full rules", text = "The full rules are in the #rules channel on Discord." },
                { title = "Social media", text = "Follow us to hear about events and news." },
                { title = "Suggestions", text = "Have an idea to improve the city? Leave it in the #suggestions channel on Discord." },
            },
        },
    },
}

exports.drs_serverguide:Open()