Skip to content

Tutorial Wiki

Jump to bottom
Pratea edited this page Jul 19, 2026 · 1 revision

======================================================== LUMERIA TERRITORIES - TUTORIAL E REFERENCIA DE COMANDOS

Este documento explica como usar o mod Lumeria Territories: conceitos, passo a passo para criar terrenos, e a lista completa de comandos, permissoes e flags. Pode ser usado como base para uma wiki.

  1. CONCEITOS BASICOS

TERRITORIO E a unidade "dona" de tudo: nome, tipo, dono, membros, permissoes, flags, preco de venda. Um territorio nao tem uma area propria - a area dele e formada por uma ou mais REGIOES.

REGIAO Um retangulo simples, definido por dois pontos (cantos), marcado com a vara de selecao. Cada regiao pertence a exatamente um territorio (vinculo por ID, nao por nome). Um territorio pode ter varias regioes separadas - por exemplo, uma cidade pode ser formada por dezenas de pequenos retangulos que, juntos, cobrem ruas, praca, muralha etc, mas contam como um unico territorio.

IMPORTANTE: cada regiao e uma caixa 3D (X, Y e Z), nao so uma area no chao. Se voce marcar os cantos numa faixa de altura estreita, a protecao so vale dentro dessa faixa. Para proteger um predio inteiro, marque um canto bem embaixo (ex: no alicerce) e outro bem em cima (ex: acima do telhado).

TIPO DE TERRITORIO Categoria do territorio (casa, cidade, fazenda, banco, igreja, etc), definida em arquivos JSON de datapack (data/lumeriaterritories/territory_types/*.json). Cada tipo pode ter uma cor (usada no mapa visual) e permissoes/flags padrao. O mod ja vem com tipos de exemplo: lumeriaterritories:example_house (Casa, azul) lumeriaterritories:example_city (Cidade, cinza) lumeriaterritories:example_farm (Fazenda, verde) lumeriaterritories:example_bank (Banco, amarelo) lumeriaterritories:example_church (Igreja, roxo) Voce tambem pode usar qualquer id inventado (ex: meumod:padaria) mesmo sem JSON cadastrado - so nao vai ter cor/permissoes padrao definidas (cor gerada automaticamente).

HIERARQUIA (TERRITORIO PAI) Um territorio pode estar "dentro" de outro (ex: uma Casa dentro de uma Cidade). Quando um jogador esta numa regiao mais especifica (a Casa), as regras da Casa tem prioridade sobre as da Cidade. Se a Casa nao definir uma regra especifica, o sistema sobe e usa a regra da Cidade (o pai). Ao criar um territorio, se a selecao estiver totalmente dentro de outro territorio existente, o pai e detectado automaticamente; tambem da pra forcar com "parent ".

PAPEIS (ROLES) OWNER (dono), CO_OWNER (co-dono), MEMBER (membro), VISITOR (visitante - qualquer jogador que nao esta na lista de membros e nao e o dono). O papel e por territorio: ser membro da cidade nao torna alguem membro automatico de uma casa dentro dela.

PERMISSOES Acoes controladas por papel dentro de um territorio (quebrar bloco, abrir bau, etc). Ver lista completa na secao 5.

FLAGS Interruptores gerais do territorio, independentes de quem esta jogando (ex: "PVP permitido aqui: sim/nao"). Ver lista completa na secao 6.

DONO NAO E AUTOMATICO Criar um territorio NAO te torna o dono dele. O dono so e definido quando alguem compra (/territory buy) ou quando e transferido manualmente (/territory transfer). Um territorio recem-criado nao tem dono ate um desses dois acontecerem.

  1. PRIMEIROS PASSOS - CRIANDO UM TERRENO

  1. Pegue a vara de selecao (precisa ser operador): /territory wand

  2. Marque os dois cantos da area no mundo: clique ESQUERDO num bloco = canto 1 clique DIREITO num bloco = canto 2 (os dois cliques podem ser em qualquer lugar, contanto que estejam na mesma dimensao; lembre-se da altura - ver secao 1)

  3. Crie o territorio: /territory create Exemplo: /territory create casa1 lumeriaterritories:example_house

    Isso cria o territorio E a primeira regiao dele de uma vez, usando a selecao que voce acabou de marcar.

    Para forcar um territorio pai especifico: /territory create casa1 lumeriaterritories:example_house parent cidade

  4. (Opcional) Adicione mais regioes ao mesmo territorio: marque uma nova selecao com a vara e rode: /territory addregion casa1

  5. Veja o resultado: /territory info casa1 /territory gui (abre o mapa visual)

  1. LISTA COMPLETA DE COMANDOS

Comandos marcados com (OP) exigem permissao de operador (nivel 2). Comandos marcados com (OP ou dono/co-dono) podem ser usados por quem tem esse cargo no territorio, alem de operadores.

/territory wand (OP) Da a voce a vara de selecao.

/territory create [parent ] (OP) Cria um territorio novo usando a selecao ativa da vara como a primeira regiao. "parent" e opcional (auto-detectado se omitido).

/territory addregion (OP ou dono/co-dono) Adiciona a selecao ativa da vara como mais uma regiao de um territorio ja existente.

/territory removeregion (OP ou dono/co-dono) Remove uma regiao pelo indice (veja os indices com /territory info ).

/territory delete (OP) Apaga um territorio e todas as suas regioes.

/territory duplicate (OP) Cria uma copia do territorio (mesmo tipo, flags e permissoes; sem dono/membros/venda) com todas as regioes clonadas na mesma posicao - a copia comeca sobreposta ao original.

/territory info [] Mostra nome, tipo, dono, membros, se esta a venda, quantidade de regioes, area total, e a lista de regioes com coordenadas e indice. Sem nome, mostra o territorio da posicao onde voce esta.

/territory list Lista todos os territorios existentes.

/territory gui Abre o mapa visual (ver secao 4).

/territory setflag <true|false> (OP ou dono/co-dono) Define uma flag do territorio.

/territory permission <true|false> (OP ou dono/co-dono) Define uma permissao para um papel especifico (OWNER, CO_OWNER, MEMBER ou VISITOR) naquele territorio.

/territory member add (OP ou dono/co-dono) Adiciona um jogador como MEMBER ou CO_OWNER.

/territory member remove (OP ou dono/co-dono) Remove um jogador da lista de membros.

/territory sell (OP ou dono/co-dono) Marca o territorio como a venda por um preco (um tipo de item por vez).

/territory buy Qualquer jogador. Compra um territorio que esteja a venda, se tiver os itens necessarios no inventario.

/territory transfer (Somente o dono, ou OP) Transfere a propriedade do territorio para outro jogador.

/territory abandon (Somente o dono, ou OP) Remove o dono do territorio e o coloca a venda automaticamente de novo, pelo mesmo preco que estava configurado antes (assim ele nunca fica travado sem dono e sem poder ser comprado).

/territory tax enable /territory tax disable (OP ou dono/co-dono) Ativa/desativa a cobranca de imposto.

/territory tax amount (OP ou dono/co-dono) Define quanto se cobra por ciclo (um item por vez).

/territory tax scheduledays (OP ou dono/co-dono) O imposto vence a cada N dias do Minecraft.

/territory tax graceperiod (OP ou dono/co-dono) Prazo extra (em dias) APOS o vencimento pra ainda dar tempo de pagar antes de contar como falta. Ex: vence a cada 5 dias com prazo de 5 = o dono pode pagar do dia 5 ao dia 10. Pagar a qualquer momento sempre renova o prazo a partir do dia do pagamento (nao precisa esperar vencer pra pagar de novo).

/territory tax pay Qualquer jogador que seja o DONO do terreno. Paga o imposto agora, se tiver os itens necessarios. Este e o UNICO jeito de o imposto ser cobrado - nada e descontado automaticamente do inventario. Pode tambem ser pago pelo botao "Pagar Imposto" na GUI, ou por outro mod (ex: um NPC) chamando TerritoryApi.payTax(player, territorioId) em Java.

/territory tax scheduleseason (OP ou dono/co-dono) Vence a cada N ocorrencias da estacao escolhida (SPRING, SUMMER, AUTUMN ou WINTER); o prazo pra pagar e o resto da propria estacao. Exige o mod Serene Seasons instalado no servidor - sem ele, o imposto nesse modo simplesmente nunca vence (sem erro).

/territory tax policy <NONE|BLOCK|LOSE> (OP ou dono/co-dono) Define o que acontece apos vencimentos seguidos sem pagamento (ou seja, o prazo passou e ninguem pagou): NONE = so acumula a contagem de faltas sem fazer nada; BLOCK = o dono perde os privilegios de OWNER (vira tratado como visitante) ate pagar; LOSE = perde o territorio, que volta a venda (igual ao abandon).

/territory tax info Mostra a configuracao atual do imposto (incluindo o prazo e a data de vencimento), faltas acumuladas e se esta bloqueado.

  1. MAPA VISUAL (/territory gui)

Abre uma tela com o terreno real do mundo (256x256 blocos ao redor de onde voce esta), com as regioes desenhadas por cima em cores por tipo de territorio, com transparencia.

  • Clique numa regiao colorida no mapa para selecionar o territorio e abrir o painel lateral.
  • O painel mostra: nome, tipo, dono, quantidade de regioes, area total, status do imposto, id, membros (com botao de remover), campo para adicionar membro, permissoes de Quebrar bloco/Colocar bloco/ Abrir porta/Abrir bau (para visitantes), flags, e os botoes Comprar (se a venda), "Pagar Imposto" (se voce for o dono e tiver imposto ativo), "Imposto: ... (configurar)", Editar, Duplicar e Excluir Territorio (com confirmacao).
  • "Imposto: ... (configurar)" abre um painel pra ativar/desativar, definir item+quantidade, escolher entre cobranca por dias ou por estacao, o prazo de pagamento (carencia), e a politica de inadimplencia - tudo pela GUI, sem precisar de comando. Pagar o imposto em si e feito pelo botao "Pagar Imposto" (fora desse painel), nunca automatico.
  • Passe o mouse sobre os botoes de permissao/flag/imposto pra ver uma explicacao do que cada um faz (tooltip).
  • "Editar" permite mudar nome e tipo do territorio pela propria tela.
  • A matriz completa de permissoes por papel (OWNER/CO_OWNER/MEMBER/ VISITOR x todas as permissoes) ainda e so por comando (/territory permission) - a tela mostra apenas quebrar/colocar bloco e abrir porta/bau para visitantes.
  • Sem zoom/pan nesta versao (planejado para o futuro).
  1. PERMISSOES DISPONIVEIS

Usadas em /territory permission

break_blocks Quebrar blocos place_blocks Colocar blocos open_containers Abrir bau/barril/dispenser/etc open_doors Abrir portas/alcapoes/portoes use_buttons Usar botoes use_levers Usar alavancas use_buckets Usar baldes use_redstone Interagir com repetidor/comparador use_furnaces Usar fornalhas use_enchanting Usar mesa de encantamento interact_entities Interagir com entidades em geral mount_animals Montar em animais/veiculos sleep Dormir em camas

Papeis validos: OWNER, CO_OWNER, MEMBER, VISITOR

  1. FLAGS DISPONIVEIS

Usadas em /territory setflag

allow_pvp Permitir PVP no territorio allow_explosions Permitir explosoes (danificarem blocos) allow_fire Permitir espalhamento de fogo allow_monster_spawn Permitir spawn natural de monstros allow_plant_growth Permitir crescimento de plantas/colheitas allow_redstone (reservado para uso futuro mais amplo) allow_teleport (reservado para uso futuro)

  1. OBSERVACOES E LIMITACOES DESTA VERSAO
  • Criar territorio nao torna voce o dono automaticamente - use /territory transfer ou /territory buy.
  • Regioes sao caixas 3D (com altura). Cuidado com a faixa de Y ao selecionar com a vara.
  • O mapa visual nao tem zoom/pan ainda, e mostra area fixa ao redor de onde voce esta.
  • A matriz completa de permissao por papel so e editavel por comando.
  • Nao ha botao para remover regiao pela GUI ainda - use /territory removeregion.
  • Precos de venda (/territory sell) e de imposto (/territory tax amount) aceitam um unico item por vez.
  • O imposto NUNCA e cobrado automaticamente do inventario. O dono precisa pagar ativamente com /territory tax pay, o botao "Pagar Imposto" na GUI, ou outro mod chamando TerritoryApi.payTax (ex: um NPC de cobranca). Se o prazo (vencimento + carencia) passar sem pagamento, conta como falta.
  • Cobranca por estacao (scheduleseason) exige o mod Serene Seasons instalado no servidor; sem ele, territorios nesse modo nunca vencem.

Clone this wiki locally