Towny: o plugin de cidades e nações

O que é o Towny

O Towny Advanced (normalmente chamado só de Towny) é um plugin de proteção de terrenos que adiciona um sistema político e econômico completo a um servidor de Minecraft. Em vez de claims individuais como no GriefPrevention, o Towny organiza os jogadores em cidades, e cada cidade administra coletivamente uma área de terra dividida em plots.

A história do plugin remonta a 2010, o que o torna um dos plugins com mais tempo de desenvolvimento em toda a história do Minecraft. Ao longo dos anos, virou o padrão para servidores de sobrevivência com uma dose de política e economia. Você o encontra na grande maioria dos servidores "towny survival" ou "economy survival" do mundo todo.

O Towny tem quatro níveis de estrutura política:

• Resident (residente): todo jogador do servidor. Um residente pode entrar em uma cidade ou fundar a sua
• Town (cidade): um grupo de jogadores que dividem uma área sob a liderança de um prefeito
• Nation (nação): uma aliança de cidades sob um único rei. Dá bônus e cuida da política entre as cidades
• World (mundo): cada dimensão (o Overworld, o Nether, o End) pode ter suas próprias configurações do Towny

Você pode baixar o plugin de graça no repositório oficial no GitHub. Ele exige Java 17+ e roda no Paper/Spigot 1.16.5+. Para ter todos os recursos de economia, precisa do Vault e de um plugin de economia (por exemplo o EssentialsX).

Criando uma cidade

Fundar uma cidade é o primeiro passo para qualquer jogador que quer terra própria. Antes de digitar o comando, confira se você tem dinheiro suficiente: o admin pode definir um custo para fundar uma cidade (normalmente $500-$5000).

/t new TownName        # funda uma nova cidade no local onde você está
/t claim               # pega o chunk em que você está (custa dinheiro)
/t unclaim             # devolve o chunk à natureza
/t claim outpost       # cria um posto avançado remoto

A cidade é fundada no chunk em que você está quando digita o comando. Esse chunk vira o homeblock, o coração da cidade. O spawn da cidade (/t spawn) é definido ali automaticamente. O homeblock não pode ser movido sem mover o ponto de spawn inteiro, então escolha o local com cuidado.

Depois de fundar a cidade, você pode comprar aos poucos os chunks vizinhos com /t claim. Cada chunk custa uma taxa única (definida pelo admin) e conta para o limite de plots da cidade. O limite base costuma ser de 8 a 16 plots, mas cresce com o número de residentes: cada novo residente adiciona um bônus ao total de plots disponíveis.

A fórmula base da configuração padrão:

Max plots = (residents + 1) * bonus_per_resident

Por exemplo, uma cidade com 10 residentes e um bônus de 8 plots por residente pode pegar 88 chunks. É uma área enorme, e por isso recrutar residentes é uma estratégia fundamental.

Também vale planejar o formato da cidade. Os chunks precisam encostar uns nos outros (ou ser postos avançados). Não é possível ter ilhas soltas de claims espalhadas: todo chunk novo precisa fazer fronteira com um que você já pegou. A exceção são os postos avançados (/t claim outpost), que podem ficar longe do resto, mas custam bem mais.

Gerenciando plots

Cada chunk pego é um plot. Por padrão, todos os plots de uma cidade pertencem à cidade e são administrados pelo prefeito. Mas você pode atribuir um plot a um residente específico ou dar a ele um tipo especial.

Tipos de plot

O Towny define vários tipos de plot, cada um com permissões padrão diferentes:

• Default: o plot padrão da cidade. As permissões são controladas pelas configurações da cidade
• Shop: um plot comercial. Defina com /plot set shop. Jogadores de fora podem negociar aqui mesmo que o resto da cidade esteja fechado
• Embassy: um plot que um jogador de outra cidade, ou até sem cidade, pode comprar ou alugar. Útil para montar distritos comerciais
• Farm: um plot agrícola. Jogadores de fora podem colher plantações, mas não podem destruir as estruturas da farm
• Arena: um plot de PvP. O PvP fica sempre ativo aqui, independentemente das configurações gerais do servidor e da cidade
• Wilds: um plot tratado como terra fora da cidade, com liberdade total para destruir
• Inn: permite que jogadores sem cidade definam o spawn neste plot
• Jail: um plot para onde são enviados os residentes punidos da cidade

/plot set shop         # muda o tipo do plot para loja
/plot set embassy      # muda o tipo do plot para embaixada
/plot set farm         # muda o tipo do plot para farm
/plot set arena        # muda o tipo do plot para arena de PvP
/plot set name Name    # dá um nome personalizado ao plot
/plot forsale 500      # coloca o plot à venda por $500
/plot notforsale       # tira o plot do mercado

Permissões nos plots

Cada plot tem permissões independentes para quatro grupos: Resident (residentes da cidade), Nation (jogadores da mesma nação), Ally (aliados) e Outsider (todos os outros). As permissões são de quatro tipos: Build (construir), Destroy (destruir), Switch (usar alavancas, botões, baús) e ItemUse (usar itens, como baldes).

/plot perm set outsider build off    # impede que forasteiros construam
/plot perm set resident switch on    # residentes podem usar botões
/plot perm set ally destroy on       # aliados podem destruir neste plot

Nações

A nação é um nível de organização acima das cidades. Um jogador (o rei) funda a nação e convida outras cidades. Uma nação pode fazer diplomacia: formar alianças com outras nações, declarar inimigos e organizar esforços de guerra conjuntos.

/n new NationName        # funda uma nação (o prefeito paga o custo de fundação)
/n add TownName          # convida uma cidade para a nação
/n kick TownName         # remove uma cidade da nação
/n ally add NationName   # envia uma proposta de aliança a outra nação
/n enemy add NationName  # declara um inimigo (necessário para guerra em alguns modos)
/n spawn                 # teletransporta para a capital da nação
/n deposit amount        # deposita no banco da nação
/n withdraw amount       # saca do banco da nação (só o rei)

As vantagens de fazer parte de uma nação são concretas. Toda cidade de uma nação ganha um bônus no número máximo de plots: por padrão +10 plots por estar em uma nação, mais chunks extras pelo tamanho da nação. Nações grandes, com muitas cidades, podem dar a cada cidade um bônus de 50 a 100 plots extras.

A nação tem um banco compartilhado (o nation bank), com o qual o rei pode financiar guerras e diplomacia ou subsidiar cidades menores. Manter uma nação custa uma certa quantia por dia. Se o banco secar, a nação colapsa e todas as suas cidades voltam a ser independentes.

Estrutura de poder em uma nação

• King (rei): o fundador ou líder designado da nação. Controle total sobre o banco, a diplomacia e a estrutura
• Nation Assistant (assistente da nação): pode gerenciar cidades e diplomacia, mas não tem acesso ao banco
• Capital: a cidade do rei. Dá bônus a toda a nação. Mude a capital com /n set capital TownName

Cargos e permissões

O Towny tem um sistema de cargos embutido, independente do LuckPerms. Cada cidade pode criar seus próprios cargos personalizados com qualquer conjunto de permissões do Towny.

Cargos padrão em uma cidade

• Mayor (prefeito): controle total da cidade. Pode pegar plots, cobrar impostos, expulsar jogadores e nomear assistentes e cargos. Um por cidade
• Assistant (assistente): pode gerenciar residentes, plots e configurações da cidade. Não pode pegar nem liberar plots fora da área atribuída
• VIP: um exemplo de cargo personalizado. O admin pode definir quaisquer cargos com quaisquer permissões
• Novo residente (Nomad/default): um residente comum, sem permissões especiais além das concedidas pela cidade

/t rank add Player RankName      # dá um cargo a um jogador na cidade
/t rank remove Player RankName   # remove o cargo
/t set mayor Player              # passa o título de prefeito para outro jogador

Os cargos personalizados são configurados em plugins/Towny/settings/townyperms.yml. Você pode criar cargos como "Construtor", "Guarda" ou "Comerciante", cada um com seu próprio conjunto de comandos do Towny que o jogador pode executar.

Permissões nos seus plots e nos dos outros

Cada residente pode definir permissões nos plots que pertencem diretamente a ele (atribuídos pelo prefeito). Nos plots da cidade (não atribuídos), só o prefeito ou um assistente define as permissões. Essa é uma diferença importante: o jogador pode ter o "seu" plot e controle total sobre ele, mesmo que formalmente pertença à cidade.

Economia e impostos

O Towny adiciona um amplo sistema financeiro. Cada cidade tem seu próprio banco, que recebe os impostos dos residentes e depósitos manuais. O banco da cidade paga a manutenção dela (um custo diário) e as despesas de guerra.

Impostos

/t set taxes 50          # define um imposto diário de $50 para cada residente
/t set taxes 5%          # um imposto percentual sobre o saldo do jogador (em vez de um valor fixo)
/t set plottax 10        # um imposto sobre cada plot atribuído (diário)
/t set plotprice 200     # o preço para um residente comprar um plot
/t set shoptax 20        # um imposto extra sobre plots do tipo loja

Os impostos são cobrados automaticamente uma vez por dia (no horário do "new day" do Towny, que o admin pode configurar). Se o jogador não consegue pagar o imposto, ele pode ser expulso da cidade automaticamente. Isso depende da configuração do admin.

Banco da cidade e depósitos

/t deposit 1000          # deposita $1000 da sua carteira no banco da cidade
/t withdraw 500          # saca do banco (só o prefeito ou um assistente)
/t balance               # mostra o saldo do banco da cidade

O banco da cidade é separado das carteiras dos jogadores. O dinheiro do banco pertence à cidade: mesmo que o prefeito saia, o banco fica. Quando um novo prefeito assume a cidade, o banco vai junto.

Manutenção (upkeep)

Toda cidade paga uma manutenção diária proporcional ao número de plots, ou uma taxa fixa definida pelo admin. Se o banco da cidade não cobrir a manutenção, a cidade cai: todos os plots voltam à natureza e os residentes ficam sem cidade. É um mecanismo que força a atividade e a contribuição para o banco.

As nações também pagam a própria manutenção. Nações grandes, com muitas cidades, pagam mais, o que é um freio natural à expansão e um incentivo para construir impérios ativos em vez de mortos.

Guerra (Towny War)

O Towny oferece vários modos de guerra. Por padrão, os servidores rodam o Towny sem guerras ativas, e o admin escolhe a mecânica que combina com o conceito do servidor.

Modos de conflito

• Sem guerras (Off): proteção total, sem PvP ligado ao sistema político. Adequado para servidores familiares
• Towny War Event: eventos de guerra recorrentes, anunciados por um admin ou executados automaticamente. Por um período definido (um fim de semana, por exemplo), as cidades podem atacar plots inimigos
• Town Sieges: um modo moderno do add-on oficial Towny-Sieges. Os jogadores sitiam uma cidade por um tempo definido, e o resultado do cerco decide quem assume o controle
• Flag War: um modo de bandeira. Os atacantes precisam fincar uma bandeira em um plot inimigo e defendê-la por um tempo definido para capturá-lo

Como funciona a Siege War

A Siege War (disponível como plugin separado para o Towny) é o modo de guerra mais popular em servidores modernos. Um cerco funciona assim:

1. Um jogador atacante (que precisa ser de uma nação inimiga) coloca um estandarte perto do centro da cidade atacada
2. A contagem regressiva do cerco começa (3 dias por padrão). Os dois lados podem marcar pontos matando inimigos na zona do cerco
3. Quando o tempo acaba, se os atacantes tiverem mais pontos, a cidade paga reparações de guerra. Opcionalmente, ela pode ser absorvida pela nação atacante
4. Um cerco pode ser repelido: os defensores precisam juntar mais pontos que os atacantes

A Siege War não apaga cidades automaticamente. Ela é mais uma alavanca política (forçar reparações, mudar alianças) do que um mecanismo de conquista total. Isso mantém os servidores com Siege War dinâmicos sem serem destrutivos.

Comandos

Comandos do jogador: cidade

Comandos do jogador: nação

Comandos de admin

/ta town new TownName Player      # cria uma cidade para um jogador sem custo
/ta town delete TownName          # exclui uma cidade
/ta nation new NationName Player  # cria uma nação
/ta givebonus TownName 20         # dá a uma cidade um bônus de +20 plots
/ta regenerate TownName           # restaura o terreno depois de uma destruição
/ta unclaim circle 5              # libera os plots em um raio de 5 chunks
/ta reload                        # recarrega a configuração do Towny

Configuração

O Towny guarda sua configuração no diretório plugins/Towny/settings/. Os arquivos principais são:

• config.yml: a configuração central: custos, limites, impostos, intervalos, mecânicas
• townyperms.yml: permissões do Towny para grupos de jogadores e para cargos em cidades e nações
• language/: todos os textos do plugin, disponíveis para edição

Os parâmetros mais importantes do config.yml

# Custos
new_town_price: 1000.0           # custo de fundar uma cidade
new_nation_price: 5000.0         # custo de fundar uma nação
claim_price: 200.0               # preço para pegar um chunk
claim_price_per_plot: true       # se o preço aumenta a cada claim

# Manutenção, cobrada uma vez por dia
town_upkeep: 100.0               # custo base da manutenção da cidade
town_upkeep_multiplied: false    # se true: upkeep * número_de_plots
nation_upkeep: 1000.0            # custo da manutenção da nação

# Limites de plots
max_plots_per_resident: 8        # quantos plots um residente pode atribuir a si mesmo
default_town_plots: 8            # número inicial de plots de uma cidade nova
plots_per_resident: 8            # bônus de plots por residente

# Towny new day (quando impostos e manutenção são cobrados)
new_day_time: "0:00"             # horário do servidor do novo dia

# Proteção
prevent_explosions: true         # bloqueia explosões dentro das cidades
prevent_fire_spread: true        # bloqueia a propagação do fogo
prevent_mob_damage_blocks: true  # mobs não destroem blocos nas cidades

# PvP
town_pvp: false                  # PvP padrão em cidades novas (DESATIVADO)
nation_zone_pvp: false           # PvP na zona da nação

Configuração da moeda e integração com o Vault

O Towny detecta o Vault automaticamente e usa o plugin de economia que estiver conectado a ele. Confira se o Vault está instalado, porque o Towny verifica isso quando o servidor inicia.

Towny Chat

Os canais de chat vêm do TownyChat, o add-on oficial de chat do Towny (um plugin separado):

• /tc: chat da cidade (só os residentes da sua cidade veem)
• /nc: chat da nação (todas as cidades da nação)

O formato das mensagens de cada canal é configurado no chatconfig.yml. Você pode adicionar placeholders como {townname}, {nationname} e {rank} aos formatos de chat.

Dicas para admins

Primeira inicialização

Antes de os jogadores entrarem no servidor, revise o config.yml e defina custos que combinem com a sua economia. Os erros mais comuns são custos baixos demais (todo jogador funda uma cidade no primeiro dia) ou altos demais (ninguém funda uma cidade por uma semana). Um bom equilíbrio é um custo de fundação equivalente a 2 ou 3 dias de jogo ativo.

• Defina a manutenção acima de zero: sem manutenção, cidades mortas poluem o mapa para sempre. A manutenção força a atividade ou o declínio das cidades inativas
• Ative o deny_unclaim_when_bankrupt: sem ele, os jogadores podem liberar plots quando o banco está vazio para fugir da dívida. Bloqueie isso
• Limite o quanto as cidades podem se aproximar umas das outras: o parâmetro min_distance_from_town_homeblock impõe uma distância mínima entre cidades. 5 chunks é o mínimo padrão; aumente para 10-15 para ter margens maiores
• Ative o town_ruin_time: em vez de excluir na hora uma cidade falida, ela pode entrar em estado de "ruínas" por alguns dias, mantendo as estruturas. Os jogadores podem recomprá-la, ou ela é excluída quando o tempo acaba
• Use o /ta regenerate com cuidado: a regeneração do terreno depois de uma destruição é irreversível. Sempre faça um backup

Integrações com outros plugins

• Vault: obrigatório. A economia do Towny não funciona sem ele
• EssentialsX: o sistema de economia mais usado compatível com o Vault
• LuckPerms: integra-se aos cargos do Towny pelo contexto towny_rank. Você pode dar cargos do LuckPerms automaticamente com base em um cargo do Towny (por exemplo, o prefeito recebe o prefixo "Prefeito")
• Dynmap-Towny: um add-on do Dynmap que desenha as fronteiras de cidades e nações no mapa online. Muito popular em servidores de Towny: os jogadores veem a política do mundo sem precisar entrar
• ShopGUI+ / QuickShop Hikari: lojas que usam a economia do Vault funcionam muito bem com os impostos do Towny. Os jogadores ganham nas lojas e gastam para manter as cidades funcionando

Problemas comuns e soluções

• Jogadores não conseguem pegar plots: confira o limite de plots (/t mostra usados/máximo). Aumente o bônus com /ta givebonus ou reduza o max_plots_per_resident para liberar mais espaço
• Os impostos não estão sendo cobrados: confira se o servidor está ligado no horário definido em new_day_time. Se o servidor reinicia nesse momento, ele pode pular a cobrança
• Uma cidade some depois de reiniciar: provavelmente é um problema de banco de dados. O Towny pode usar flatfile (arquivos yml) ou MySQL/MariaDB. Em servidores grandes use sempre o MySQL, porque o flatfile pode corromper
• Erros "Town already exists": procure dados antigos em plugins/Towny/data/. Às vezes sobram arquivos de cidades excluídas

Backup dos dados do Towny

Os dados do Towny (se você usa flatfile) ficam em plugins/Towny/data/. Faça backup dessa pasta junto com o resto do servidor. Se você usa MySQL, os dumps padrão do banco de dados bastam. O Towny também faz os próprios backups em plugins/Towny/backups/, e o número de backups mantidos é definido com backup_count.

Artigos relacionados: EssentialsX, Vault, LuckPerms, catálogo de plugins.