# Bem-vindo ao tutorial do BlockyCRAFT! Este tutorial foi criado para guiar você por todas as mecânicas e sistemas exclusivos dentro do jogo. Aqui você aprenderá como proteger seus terrenos, criar grupos, colocar recompensas na cabeça de seus inimigos e muito mais. --- ## Autenticação Para garantir a segurança da sua conta e dos seus itens, utilizamos um sistema de autenticação próprio e sincronizado com o website do BlockyCRAFT. ::: info Sua conta dentro do jogo e no site do BlockyCRAFT **são as mesmas**. Se o usuário `zukerman` criou a senha `123456`, o usuário e senha na hora de logar no site serão exatamente esses. Caso troque a senha, também será trocado **automaticamente** no site. ::: #### Comandos Principais - `/registrar <senha>` - Registra sua conta. Use isso na primeira vez que entrar. - `/entrar <senha>` - Faz login na sua conta. - `/mudarsenha <nova-senha>` - Altera sua senha atual. Necessário estar autenticado! #### Importante - Você tem **3 tentativas de login** antes de ser expulso. - Seu inventário é salvo e protegido. Ninguém pode acessar seus itens enquanto você não estiver logado. - Movimentação, chat e interações são bloqueados até a autenticação do jogador. ### Recuperação de senha Ao registrar pela primeira vez você receberá um código de recuperação no chat do jogo. Salve este código de recuperação em um local seguro ele o único método para recuperar sua conta caso não tenha registrado seu e-mail no site. ::: warning Nós não realizamos resets de contas ou senhas, sua conta é sua responsabilidade! ::: #### Comandos de recuperação - `/recuperar <codigo>` - Recupera sua conta usando o codigo de recuperacao. - `/novasenha <senha>` - Define uma nova senha apos validar o codigo. - `/gerarcodigo` - Gera um novo codigo de recuperacao. --- ## Depósito de Itens Em um mundo sem _keep inventory_ e com diversos grupos rivais, depositar seus itens valiosos é uma ótima estratégia. Depositar itens também garante a possibilidade de vendê-los no <a href="https://craft.blocky.com.br/markets/" target="_blank">Mercado</a>. Além disso, ter um grande patrimônio faz seu grupo subir no ranking global. #### Comandos - `/depositar tudo` - Deposita todos os itens do seu inventário que são permitidos. - `/depositar` - Deposita apenas o item que está na sua mão. - `/depositar tudo mao` - Deposita todos os itens do inventário que forem iguais aos itens da sua mão. - `/depositar fundo` - Deposita itens diretamente para a carteira do tesoureiro do seu grupo. > [!NOTE] > Para depositar no fundo do seu grupo, basta adicionar o parâmetro `fundo` em qualquer comando de depósito. Por exemplo: `/depositar mao tudo fundo`. Ao fazer um depósito, os itens são transferidos do seu inventário e podem ser acessados na sua <a href="https://craft.blocky.com.br/dashboard/" target="_blank">Carteira</a>. --- ## Proteção de Terrenos (_Claims_) Proteja suas construções e itens de outros jogadores usando nosso sistema de terrenos (_claims_). Ao criar um terreno, ele ficará exposto no <a href="https://craft.blocky.com.br/map/" target="_blank">Mapa</a>. ::: warning Uma vez que um terreno é criado, ele não poderá ser excluído. Para se desfazer de um terreno, você deve vendê-lo a outro jogador. Terrenos podem ser ocupados por 30% de seu valor, **caso o dono fique inativo por 90 dias ou mais**. ::: #### Blocos de Proteção Antes de poder criar seu terreno, você deverá adquirir **blocos de proteção**. A moeda de transação para os terrenos é a barra de ouro, onde **1 barra de ouro = 15 blocos de proteção**, logo, se você tiver 10 barras de ouro, poderá comprar 150 blocos para seu terreno. Para comprar blocos de proteção, tenha suas barras de ouro no inventário e use o comando `/claim comprar <quantidade-de-ouros>`. ::: info Para entender o motivo por trás de "1 barra de ouro = 16 blocos de proteção", acesse: **[O Valor da Sua Terra — Por Bernardo Zukerman](./O_Valor_da_Sua_Terra.pdf)** ::: #### Como Criar uma Proteção Após comprar seus blocos de proteção, é hora de criar o terreno propriamente dito: 1. Tenha um **graveto** em mãos. 2. Clique com o botão direito em dois blocos para definir os cantos da sua área (diagonal). 3. Use o comando `/claim confirmar <nome-do-terreno>` para finalizar a compra. <video width='60%' controls autoplay loop muted> <source src="/Tutorial/Portugu%C3%AAs/ClaimCreate.webm" type="video/webm"> </video> > Embora o vídeo esteja com os comandos em inglês, você poderá utilizar os comandos do seu idioma. #### Gerenciamento - `/claim saldo` - Vê quantos blocos de proteção você ainda tem disponíveis. - `/claim list` - Lista todos os seus terrenos. - `/confiar <jogador>` - Permite que outro jogador construa no seu terreno. - `/desconfiar <jogador>` - Remove a permissão de um jogador. - `/claim unificar <novo-nome>` - Unifica claims sobrepostas em uma só. #### Mercado de Terrenos - `/claim anunciar <preço>` - Coloca o terreno atual à venda. - `/claim desanunciar`- Tira o terreno atual do mercado. - `/claim adquirir <novo-nome>` - Compra um terreno que está à venda. - `/claim ocupar <novo-nome>` - Ocupa um terreno abandonado por um preço reduzido. ::: warning **Integração com grupos**: se você faz parte de um grupo, **todos os membros do seu grupo têm permissão automática em seus terrenos**. Não é necessário usar `/confiar` para eles. ::: --- ## Grupos Junte-se a outros jogadores, domine o servidor e suba no ranking! Seu grupo pode ser desde uma nação, até uma empresa especializada no mercado. Caso crie ou participe de um grupo existente, seus terrenos são confiados a todos os membros do grupo enquanto você pertenceer a ele. Entrar ou sair de um grupo não altera a posse dos seus terrenos, eles permanecem sua propriedade individual. :::success Participe de um bom grupo para que subam juntos no <a href="https://craft.blocky.com.br/scoreboard/" target="_blank">Scoreboard</a>. ::: #### Comandos Básicos - `/grp criar <tag> <nome>` - Cria um novo grupo. - `/grp convidar <jogador>` - Convida alguém para seu grupo. - `/grp entrar <nome-do-grupo>` - Aceita um convite. - `/grp sair` - Sai do grupo atual. - `/gc <mensagem>` - Envia uma mensagem no chat do grupo. #### Gerenciamento - `/grp promover <jogador> <cargo>` - Promove ou rebaixa membros - `/grp expulsar <jogador>` - Remove um jogador do grupo. - `/grp setbase` - Define a base do grupo onde os membros podem se teletransportar. - `/grp pvp <on/off>` - Ativa ou desativa o fogo amigo entre membros. #### Ranking e Base - `/grp rank` - Vê os grupos mais ricos do servidor baseado no patrimônio. - `/grp base` - Teletransporta para a base do grupo (30s de cooldown se estiver em combate). --- ## Duelos Resolva suas desavenças ou prove ser o mais forte na Arena. O sistema de duelos permite que dois jogadores se enfrentem em arenas isoladas com suas próprias apostas, garantindo que ninguém interfira na luta (1v1 justo). #### Fases do Duelo Um duelo ocorre em diferentes etapas para garantir que ambos os lados estejam preparados: 1. **Desafio**: Um jogador envia o pedido de duelo, definindo a arena. 2. **Apostas (Betting)**: Após aceitar, a fase de apostas é aberta. Qualquer espectador pode apostar suas barras de ferro em quem acha que vai ganhar. Ao final do duelo a quantia apostada entre os vencedores é dividida, com uma parcela (taxa) indo para a arena. 3. **Preparação**: Ambos os jogadores devem digitar `/duelo iniciar` para confirmar que estão prontos. Se demorarem mais de 7 dias, o duelo expira e as apostas retornam aos seus donos. 4. **Combate**: Apenas os dois jogadores e suas habilidades soltos na arena. Quem quitar ou morrer, perde. ::: warning Não é possível iniciar um combate contra um membro do seu próprio grupo se a configuração de **Fogo Amigo** (PvP) do grupo estiver desativada, e nenhum oficial poderá desativá-la enquanto houver um duelo ativo rolando entre vocês. ::: #### Comandos Básicos - `/duelar <jogador> <arena>` - Desafia um jogador para um duelo na arena específica. - `/duelo aceitar` - Aceita o último desafio pendente recebido. - `/duelo recusar` - Recusa o último desafio pendente recebido. - `/duelo iniciar` - Marca que você está pronto em um duelo já aceito. O combate iniciará quando ambos digitarem o comando. - `/duelo desistir` - Cancela um duelo na fase de apostas antes que ele se inicie, reembolsando todos os espectadores. #### Comandos de Apostas & Arenas - `/apostar <jogador> <quantia>` - Aposta suas barras de ferro em um dos lutadores (O duelo precisa estar na fase de apostas). - `/apostas` - Mostra a central de apostas abertas com as taxas, prêmios e multiplicadores ativos (_odds_). #### Arenas A arena é o palco do duelo. **Apenas os líderes dos grupos** podem criar e gerenciar a infraestrutura de uma arena para seu grupo. Para criar e lucrar com uma arena, siga os requisitos: 1. O líder deve possuir uma proteção (terreno) no local escolhido. 2. Posicionar-se adequadamente no local e usar `/arena criar <nome>`. Isso definirá aquele terreno protegido como a arena, permitindo que os duelistas sejam teletransportados para ela. 3. (Opcional) Determine uma taxa de entrada para a sua arena usando `/arena taxa <nome> <valor>`. Esse valor em `%` variando de `0 a 100` dita a porcentagem da aposta total que será transferida para a carteira (fundo) do grupo dono da arena ao final do duelo. --- ## Recompensas Quer ver alguém eliminado? Coloque um preço na cabeça dele! #### Comandos - `/bounty <jogador> <quantidade>` - Coloca uma recompensa pela morte do jogador. - `/bounty list` - Vê a lista de jogadores procurados. - `/bounty remover <jogador>` - Remove uma recompensa que você colocou e recupera seu ferro. #### Detalhes - Se você matar um jogador com recompensa, a recompensa vai direto para o seu inventário. :::danger Você não pode colocar recompensas em membros do seu próprio grupo, e matar membros procurados do seu grupo não lhe dá recompensa. ::: --- ## Ajuda Precisa se lembrar de algum comando? - `/ajuda` - Abre o menu de ajuda com a lista de comandos do servidor. - `/ajuda <página>` - Navega pelas páginas de ajuda. --- ## Bolsa de Valores A economia do BlockyCRAFT gira em torno da Bolsa de Valores. É aqui que você pode multiplicar seu patrimônio, negociando itens (commodities) em tempo real com outros jogadores. A moeda base para todas as trocas principais é a **Barra de Ferro (IRON)**.  ### Visão Geral da Interface A interface é dividida em painéis que fornecem informações vitais para suas negociações: 1. **Par de Negociação (Topo):** Mostra qual item está sendo negociado (ex: `DIAM/IRON` significa Diamantes por Ferro). 2. **Gráfico de Preços (Centro):** Um gráfico de velas (candlestick) mostrando a valorização ou desvalorização do item ao longo do tempo. 3. **Livro de Ofertas (Esquerda):** Lista de todas as ordens de compra e venda abertas. 4. **Painel de Ordens (Abaixo do gráfico):** Onde você realiza suas operações de compra ou venda. 5. **Lista de Mercados (Direita):** Outros itens disponíveis para troca (Ouro, Carvão, Pedregulho, etc.). 6. **Histórico de mercados (Direita inferior):** Mostra todo o histórico daquele mercado. ### Livro de Ofertas (Order Book) O "Order Book" é o coração do mercado. Ele mostra a intenção dos jogadores.  - **Vermelho (Parte superior):** Ordens de **Venda**. Jogadores querendo vender o item e pedindo um preço por ele. - **Verde (Parte inferior):** Ordens de **Compra**. Jogadores querendo comprar o item e oferecendo um preço. - **Diferença (Spread):** É a diferença entre o preço de venda mais barato e o preço de compra mais caro. ::: info No exemplo da imagem, há duas ordens de compra e duas ordem de venda, tendo uma diferença de 2.88% em seus preços (spread). ::: ### Como Comprar e Vender No painel central inferior, você encontra as boletas de negociação.  #### Tipos de Ordem Você pode negociar de duas formas, selecionando as abas **Mercado** ou **Limite**: - **Mercado:** Compra ou vende **imediatamente** pelo melhor preço disponível no livro de ofertas. É rápido, mas você não escolhe o preço exato. - **Limite:** Você define o **Preço** que quer pagar ou receber. Sua ordem ficará no livro de ofertas esperando alguém aceitar. #### Preenchendo a Ordem 1. **Preço:** Quanto custa cada unidade (apenas na ordem Limite). 2. **Quantidade:** Quantos itens você quer negociar (ex: quantos Diamantes). 3. **Total:** O valor total da transação em Barras de Ferro. ::: info Use a barra deslizante abaixo dos campos para preencher automaticamente uma porcentagem do seu saldo disponível (ex: usar 50% do seu Ferro para comprar Diamantes). ::: ### Histórico e Outros Mercados No lado direito, você pode monitorar o que está acontecendo em tempo real.  - **Lista de Instrumentos:** Clique em um par (ex: `GOLD/IRON`) para trocar de mercado e ver o gráfico daquele item. - **Histórico de Trade:** Mostra as últimas transações realizadas com sucesso, permitindo ver por quanto o item está saindo de verdade. --- ## BMM (Blocky Market Maker) Para os jogadores mais avançados que desejam fornecer liquidez ao mercado e lucrar com o _spread_, disponibilizamos o **[BMM](https://github.com/zukrmn/BlockyMarketMaker)**. Este é um bot de código aberto, desenvolvido em Python, que automatiza suas negociações na Bolsa de Valores do BlockyCRAFT. O bot opera com estratégias de **Market Making**, colocando ordens de compra e venda simultaneamente para capturar a diferença de preço (spread), garantindo liquidez para o servidor e lucro para o operador. ::: danger **Aviso de Risco:** O uso de bots envolve riscos financeiros. Uma configuração errada pode drenar seu saldo de FERRO ou de itens rapidamente. Teste com valores baixos antes de operar pesado. Não utilize as configurações padrões do bot e modifique por sua conta e risco. ::: ### Funcionalidades - **Market Making Automatizado:** Mantém ordens de compra e venda ativas. - **Auto-Hedge e Rebalanceamento:** Ajusta preços automaticamente baseado no mercado. - **Integração via WebSocket:** Reage a trades em tempo real (baixa latência). - **Dashboard Web Local:** Interface visual para acompanhar seus lucros e status. - **Circuit Breaker:** Pausa negociações automaticamente se a volatilidade for extrema ou se a API falhar. ### Para criar seu próprio bot de Market Making, segue abaixo links úteis: - <a href="https://craft.blocky.com.br/docs/" target="_blank">Documentação API</a> - <a href="https://craft.blocky.com.br/docs/llms.txt" target="_blank">Prompt inicial para LLM</a> - <a href="https://pypi.org/project/blockypy/" target="_blank">Pacote PyPi</a> ---