Sistema VIP automatizado por datas e keys
Sumário
1- Introdução e objetivo
2- Comandos do plugin
3- Permissões (permission nodes)
4- Download do plugin
5- Configurando o plugin pela primeira vez
6- Imagens
7- Configuração padrão do plugin
8- Exemplo de uso in-game (dentro do jogo) do plugin
9- Wikis de referência
10- Créditos
11- Informações úteis
12- ChangeLog
13- Items e poções customizáveis, exp, dinheiro e comandos
14- Mudando a linguagem do plugin de inglês para português
1- Introdução e objetivo
- Spoiler:
Este plugin foi criado para facilitar a administração dos VIPs e sua validade, tendo como pontos altos o uso de KEYS e o sistema automático de datas.
Possuindo um sistema para dar itens junto ao código de uso facilitado mas com as maiores possibilidades de customização.
2- Comandos do plugin
- Spoiler:
(ADMIN) /gerarkey <dias> - Gera uma key de 10 dígitos com validade de X dias.
(ADMIN) /keys - Vê todas as keys disponíveis e o tempo de validade delas.
(ADMIN) /apagarkeys - Remove todas as keys não usadas (são listadas no /keys).
(ADMIN) /tirarvip <nome> - Tira o VIP de um jogador.
/usarkey <key> - Comando para obter o VIP.
/tempovip - Comando para mostrar o vencimento do VIP.
/vipzero - Mostra os comandos do plugin.
3- Permissões (permission nodes)
- Spoiler:
vipzero.keys - Permissão para uso dos comandos admin sem OPerador do servidor.
4- Download do plugin
- Spoiler:
- Antes de baixar o plugin: É essencial que você possua um plugin de permissões compatível com nosso plugin.
Os plugins de permissões compatíveis no momento são:
- GroupManager (junto ao Essentials[plugin])
- PermissionsEX
- Vault (meio de comunicação com outros plugins de permissões)
Se você já possuía o VipZero antes, é recomendável que delete a pasta dele.
Pois o plugin costuma bugar, já que eu, na maioria das vezes, mudo o arquivo de configuração e os de linguagem.
Se você já possui algum desses plugins, baixe o plugin pelo site:
DevBukkit: DevBukkit - VipZero
Mediafire: [Tens de ter uma conta e sessão iniciada para poderes visualizar este link]
5- Configurando o plugin pela primeira vez
- Spoiler:
- Você deve, inicialmente, colocar o plugin na pasta 'Plugins' de seu servidor, iniciar e desligar o servidor para a pasta com o arquivo de configuraçãos er criada.
1- Mude o 'vip_group' para o nome do grupo de usuários VIPs de seu servidor, ou seja, mudar o 'vip' para o nome correto.
2- Mude o 'default_group' para o nome do grupo de usuários normais de seu servidor, ou seja, mudar o 'default' para o nome correto.
3- Mude o 'check_time' para o tempo (em minutos) para realizar a checagem nos players (se o VIP expirou), coloque 0 para desabilitar.
4- Mude o 'usekey_global' para true se quiser que todos vejam quando alguém ativar uma key VIP.
5- Mude o 'vip_items' para os itens que você deseja que recebam, há 2 exemplo já inseridos e para adicionar é só lembrar que cada item é dado dessa forma:
- DIAS, ITEM_ID, QUANTIDADE, ENCHANTS
Dias = Dias mínimos necessários de VIP para receber o item.
Item_ID = ID do item na wiki de items que está no tópico de referências.
Quantidade = Quantidade daquele item, máximo 64.
Enchants = Encantamentos do item, caso não possua coloque 'none', caso possua deverá seguir o exemplo:
sharpness-1-knockback-2
Ou seja, sharpness nivel 1 e knockback 2. Quer outro exemplo?
protection-4
Ou seja, protection nivel 4.
** O nome dos enchants deve ser igual a wiki de enchants no tópico de referência, retirando os espaços.
** Novo sistema para dar poções e itens customizados, ver no tópico 13!
6- Imagens
- Spoiler:
7- Configuração padrão do plugin
- Spoiler:
- MySQL:
Host: 'localhost'
Port: 3306
Username: 'test'
Password: '123'
Database: 'minecraft'
plugin:
language: en
type: 'flatfile'
usekey_global: false
check_time: 10
vip_group: 'vip'
default_group: 'default'
vip_items:
- '0,264,1,none'
- '10,276,1,sharpness-1-knockback-2-name-&4Legendary-desc-&5Diamonds!'
- '0,35:3,1,none'
- '0,35,1,none'
- '0,potion:poison:true:10:1,1,blindness-10:1'
- '0,$,1000,none'
- '0,xp,10,none'
- '0,comando,say @player Muito bom!'
8- Exemplo de uso in-game (dentro do jogo) do plugin
- Spoiler:
- Admin: /gerarkey 15
Server: Key: XXXXXXXXXX - Y dia(s) de VIP.
Usuario: /usarkey XXXXXXXXXX
Server: Adquirido Y dia(s) de VIP com sucesso!
Server: -Função- Dando itens com de acordo com os dias do VIP
9- Wikis de referência
- Spoiler:
- Wiki com o ID dos itens: [Tens de ter uma conta e sessão iniciada para poderes visualizar este link] - Atualizando ainda
Wiki com o nome dos enchants: [Tens de ter uma conta e sessão iniciada para poderes visualizar este link]
10- Créditos
- Spoiler:
- Desenvolvimento: SubZero0
Agradeço aos membros do fórum que me ajudaram com dicas para serem utilizadas no plugin.
11- Informações úteis
- Spoiler:
- Versão 0.9.1 até 0.9.6:
- Bukkit 1.4.7-R1.0
- PermissionsEx 1.19.5
- GroupManager 2.9.6
- Vault 1.2.22
- Java 7
Versão 0.9:
- Bukkit 1.4.7-R0.1
- PermissionsEx 1.19.5
- GroupManager 2.9.6
- Java 7
12- ChangeLog
- Spoiler:
- 13/02/2013 - 00:33 (V0.9.6):
- Corrigida falha ao dar VIP em servidores Linux.
- Suporte ao Vault como sistema de permissões adicionado.
11/02/2013 - 18:05 (V0.9.5):
- Adicionada maneria de enviar comandos ao console quando ativar o VIP
- Adicionado suporte a MySQL
- Ao usar uma key VIP válida pode ser mudado para mandar globalmente ou apenas para o jogador
- Bug no /vipzero que só ficava inglês arrumado
10/02/2013 - 15:08 (V0.9.4):
- Acentos dos arquivos de linguagem retirados (prevenir problemas com Linux)
- Carácter para colocar cor do nome ou descrição mudado de § para & (prevenir problemas com Linux)
09/02/2013 - 14:52 (V0.9.3):
- Controle sobre a checagem para perda de VIPs (em minutos, 0 = desativado)!
08/02/2013 - 14:44 (V0.9.2):
- Você pode dar EXP agora aos VIPs!
- Você pode dar dinheiro aos VIPs, se tiver o Vault!
- Você pode dar poções customizadas aos VIPs! (Nome[cor], efeitos e descrição[cor])
- Você pode dar itens customizados aos VIPs! (Nome[cor] e descrição[cor])
- Você pode alterar a linguagem do plugin! ('br' e 'en')
07/02/2013 - 14:49 (V0.9.1):
- Adicionado uso de blocos especiais nos itens vips!
- Compilado com o Bukkit 1.4.7-R1.0
07/02/2013 - 13:22 (V0.9):
- Publicado o plugin, compilado com o Bukkit 1.4.7-R0.1
13- Itens e poções customizados, exp, dinheiro e comandos
- Spoiler:
Dando itens customizados, podemos usar o exemplo:
- '10,276,1,sharpness-1-knockback-2-name-&4Legendary-desc-&5Diamonds!'
Explicação: Dará uma 1 espada de diamante (276) com Sharpness 1, Knockback 2, com nome, vermelho, Legendary e com descrição, em roxo, Diamonds! O VIP precisa ter no mínimo 10 dias na key para receber.
Para você dar outro item, siga o exemplo:
- diasMinimos, ItemID, quantidade,name-NomeCustom-desc-Descricao
** Para usar cor coloque antes do nome: § seguido de um número ou letra. Como: &1, &2, &3, ...
Dando poções customizadas, podemos usar o exemplo:
- '0,potion:poison:true:10:1,1,blindness-10:1-name-&7OMG!'
Explicação: Dará uma poção Poison jogável com 10 segundos de duração e amplificador 1 (nível poção 2), além de ter também Blindness com duração 10 segundos com amplificador 1 e também mudará o nome da poção para OMG! na cor branca.
Para você dar outra potion, siga o exemplo:
- 'diasMin, potion:TIPO:SPLASH:TEMPO:LEVEL,1,TIPO2-TEMPO:LEVEL'
TIPO = Tipos de poções que você ter (fireresistance, instantdamage, instantheal, invisibility, nightvision, poison, regen, slowness, speed, strength, water, weakness)
SPLASH = Se é de jogar ou não, deve ser true ou false
TEMPO = Quanto tempo, em segundos, o efeito dura
LEVEL = Level da poção
** Você pode usar a explicação do uso de itens customizados nas potions (nome descrição)!
** Você pode dar + do que 2 efeitos em uma poção, só seguir o exemplo
Dando dinheiro:
- '0,$,1000,none'
Explicação: Dará R$1000 ao VIP que pegar uma key com no mínimo 0 dias.
OBS: Você precisa ter o plugin VAULT para utilizar esse recurso.
Dando exp (levels):
- '0,xp,10,none'
Explicação: Dará 10 níveis de Exp ao VIP que pegar uma key com no mínimo 0 dias.
Executando comandos no console:
- '0,comando,say @player muito bom!'
Explicação: Executará o comando no console: 'say NOME muito bom'.
14- Mudando a linguagem do plugin de inglês para português
- Spoiler:
- Vá no arquivo 'config.yml' e mude de:
- Código:
language: en
- Código:
language: br