BukkitWiki

Welcome to the BukkitWiki!

This Wiki is home to Bukkit's documentation and regulations surrounding the Bukkit Project and it's services. Want to help out? We would love to have you! Signup to get started!

READ MORE

BukkitWiki
(Apenas traduzi a página original para o português.)
 
Line 1: Line 1:
  +
Warmly congratulate XCRailway team's creation in minecraft have exceed 40,000 chunks!<br/><h1>What is XCRailway Team?</h1>XCRailway is the focus of the Minecraft creation.XCRailway is the origin of the railway associations.XCRailway, a non-commercial non-profit Minecraft and Vocaloid railway creation team, founded on January 31, 2015, under the efforts of the founder xiaocao2015, has received extensive praise from the railway fans. XCRailway have created many fantastic works in many place. XCRailway have already had 1.5 million fans in China.<br/><h1>XCRailway Energy</h1>Whether under the void, or the unbuildable area that above the world height limit; Whether in the disordered Far Land, or land that is difficult to exploit, XCRailway are never stop exploring and building. XCRailway, disseminated railway to every corner of the Minecraft and Vocaloid world. We believe that railways can create miracles. We believe that we have the ability to promote the spirit of XCRailway. Through the creation of various works on the railway, the fans and members of XCRailway can get the energy of the divine railway.<br/><h1>Creations</h1>XCRailway, except for our minecraft world, created more than 40 pieces of music related to XCRailway; created more than 30 railway lines and locomotives in Railwork; XCRailway have received a wide range of praise all the time. XCRailway, in all walks of life, each dimension, each platform has a lot of excellent works.<br/><h1>Explorations</h1>In the exploration of the unknown dimension, XCRailway team summed up a set of track characteristics of creative planning and methods. Since its inception to March 2017, a large number of fans and members of XCRailway support us. XCRailway members, like Xionglong , Yudian Xuehua, etc. have contributed greatly to the creation of XCRailway. So far, XCRailway has more than 1 million subscribers in weibo.XCRailway team will continue to flourish with the support of everyone.<br/><h1>In the end</h1>XCRailway, will overturn all the obstacles along the way forward, efforts to advance, continue to create, to promote the XCRailway team - specific spirit of the railway, keep healthy and vigorous developing, create more excellent works, create miracle in the railway world,in the every dimensions!<br/><h1>Contact/Join Us</h1>Zhihu : www.zhihu.com/people/XCRailway/activities<br/>Weibo : weibo.com/xiaocao2015<br/>Bilibili : space.bilibili.com/66261012<br/>Telephone: ( 86) 135 0452 3672 (use Chinese only)
Quando Bukkit carrega um plugin, ele precisa saber algumas informações básicas sobre ele. Ele lê essas informações de um arquivo YAML, 'plugin.yml'. Este arquivo é composto por um conjunto de atributos, cada um definido em uma linha e sem recuo.
 
 
{| cellspacing="0" cellpadding="4" border="1" class="wikitable"
 
|+ Attributes
 
|-
 
! Atributo
 
! Requerido?
 
! Descrição
 
! Exemplo
 
! Notas
 
|- style="font-weight: bold;"
 
| name
 
| sim
 
| O nome de seu plugin
 
| <code>name: MeuPlugin</code>
 
|
 
*Deve conter apenas caracteres alfanuméricos e sublinhado (a-z,A-Z,0-9, _)
 
*Usado para determinar a pasta de dados do plugin. As pastas de dados são colocados na pasta ./plugins/ por padrão.
 
*É recomendado colocar o mesmo nome na jar, por exemplo 'MeuPlugin.jar'
 
 
|- style="font-weight: bold;"
 
| version
 
| sim
 
| A versão de seu plugin
 
| <code>version: 1.4.1</code>
 
|
 
*Version é uma seqüência arbitrária, no entanto, o formato mais comum é LançamentoMaior.LançamentoMenor.Construção (ex: 1.4.1).
 
*Normalmente você vai aumentar esse valor a cada vez que você lançar um novo recurso ou correção de bug.
 
*É exibido quando um usuário digita <code>/version NomeDoPlugin</code>
 
 
|-
 
| description
 
| não
 
| Uma descrição sobre a funcionalidade que seu plugin proporciona
 
| <code>description: Esse plugin permite que você se coloque em chamas.</code>
 
|
 
*A descrição pode conter várias linhas.
 
*É exibida quando um usuário digita <code>/version NomeDoPlugin</code>
 
 
|-
 
| load
 
| não
 
| Especifica quando seu plugin será carregado. Se não for definido, o padrão será POSTWORLD.
 
| <code> load: STARTUP </code>
 
| Tem 2 valores possíveis.
 
* STARTUP
 
* POSTWORLD
 
|-
 
| author
 
| não
 
| Identifica quem desenvolveu o plugin.
 
| <code>author: CaptainInflamo</code>
 
|
 
*Dá credito ao desenvolvedor.
 
*Usado em algumas mensagens de erro para fornecer comentários úteis sobre quem contatar quando ocorre um erro.
 
*É recomendado usar seu nick do bukkit.org ou seu endereço de e-mail.
 
*É exibido quando um usuário digita <code>/version NomeDoPlugin</code>
 
 
|-
 
| authors
 
| não
 
| Permite listar vários autores, se for um trabalho coletivo. Veja author.
 
| <code>authors: [Cogito, verrier, EvilSeph]</code>
 
|
 
*Você pode definir tanto o autor e os autores, porém eles serão mesclados em um lista interna.
 
 
|-
 
| website
 
| não
 
| O website do plugin ou do autor.
 
| <code>website: http://forums.bukkit.org/threads/MyPlugin.31337/</code>
 
|
 
*Se você não tem site dedicado, é recomendado usar um link para o post no fórum Bukkit onde este plugin está listado.
 
*É exibido quando um usuário digita <code>/version NomeDoPlugin</code>
 
 
|- style="font-weight: bold;"
 
| main
 
| sim
 
| Aponta a classe que você usa 'extends JavaPlugin'
 
| <code>main: org.bukkit.plugin.MyPlugin</code>
 
|
 
*Note que isso deve conter o endereço completo para a classe, incluindo o nome da classe.
 
*Se seu namespace for <code>org.bukkit.plugin</code>, e sua classe se chama <code>MyPlugin</code> então isso deve ser <code>org.bukkit.plugin.MyPlugin</code>
 
 
|-
 
| database
 
| não
 
| Marque true se seu plugin usa uma base de dados.
 
| <code>database: false</code>
 
|
 
*Utilizar um banco de dados não é tão comum. See [[Plugin_Databases]]
 
 
|-
 
| depend
 
| não
 
| Uma lista de plugins que o seu plugin requer para carregar.
 
| <code>depend: [UmPlugin, OutroPlugin]</code>
 
|
 
*O valor deve estar em um formato de lista YAML (Veja http://pt.wikipedia.org/wiki/YAML#Listas )
 
*Use o atributo "name" do plugin necessário para especificar a dependência.
 
*Se algum plugin listado aqui não for encontrado o seu plugin não irá carregar.
 
*Se você definir uma lista de vários plugins e eles forem dependentes uns aos outros, todos irão falhar ao carregar.
 
*(Veja: Wiki: Plugin_Dependencies)
 
|-
 
| prefix
 
| não
 
| O nome a ser usado para exibir no log do console, em vez do nome do plugin.
 
| <code>prefix: prefixo-exibido</code>
 
|
 
|-
 
| softdepend
 
| não
 
| Uma lista de plugins que são necessários para o seu plugin para ter uma funcionalidade completa.
 
| <code>softdepend: [UmPlugin, OutroPlugin]</code>
 
|
 
*O valor deve estar em um formato de lista YAML (Veja http://pt.wikipedia.org/wiki/YAML#Listas )
 
*Use o atributo "name" do plugin necessário para especificar a dependência.
 
*Seu plugin irá carregar depois dos plugins listados aqui.
 
*softdepend's circulares são carregados de forma arbitrária.
 
*(Veja: Wiki: Plugin_Dependencies)
 
 
|-
 
| loadbefore
 
| não
 
| Uma lista de plugins que devem ser carregados após o seu plugin.
 
| <code>loadbefore: [UmPlugin, OutroPlugin]</code>
 
|
 
*O valor deve estar em um formato de lista YAML (Veja http://pt.wikipedia.org/wiki/YAML#Listas )
 
*Seu plugin será tratado como softdepend dos plugins listados.
 
*Use o atributo "name" do plugin necessário para especificar a dependência.
 
*Seu plugin irá carregar antes de todos plugins listados aqui.
 
*softdepend's circulares são carregados de forma arbitrária.
 
*(Veja: Wiki: Plugin_Dependencies)
 
 
|-
 
| commands
 
| não
 
| Os comandos que o plugin quer registrar, e também uma lista opcional de atributos.
 
|
 
<code>
 
commands:
 
flagrate:
 
[atributos opcionais de comandos]
 
</code>
 
 
|
 
*O comando não pode conter o iniciante '/' que deve ser colocado para emitir um comando.
 
*Você pode escolher o nome que você deseja para o comando no entanto, comandos 'comuns' como <code>/kick</code> muitas vezes já estão registrados. Use o atributo 'alias' para registrar comandos alternativos. @TODO: nós estamos felizes com isso.
 
 
|-
 
| permissions
 
| não
 
| Permissões que o plugin deseja registrar. Cada node representa uma permissão para se registrar. Cada permissão pode ter atributos adicionais.
 
| <pre>permissions:
 
inferno.*:
 
[atributos opcionais de permissões]
 
inferno.flagate:
 
[atributos opcionais de permissões]
 
inferno.burningdeaths:
 
[atributos opcionais de permissões]</pre>
 
|
 
*O registro de permissões é opcional, também pode ser feito a partir do código.
 
*O registro de permissões permite que você defina as descrições, padrões e permissões pai e filhas.
 
*Nomes de permissão devem ser mantidas no estilo de &lt;nome do plugin&gt;.[categoria].[categoria].&lt;permissão&gt;
 
 
|}
 
 
 
 
Um bloco de comando inicia com o nome do comando, e em seguida a lista de atributos.
 
 
{| cellspacing="0" cellpadding="4" border="1" class="wikitable"
 
|-
 
! Atributo
 
! Requerido?
 
! Descrição
 
! Exemplo
 
! Notas
 
|-
 
| description
 
| não
 
| Uma curta descrição do que seu comando faz.
 
| <code>description: Coloca fogo em si mesmo.</code>
 
|
 
*Pode ser utilizado em conjunto com /help
 
 
|-
 
| aliases
 
| não
 
| Nomes de comandos alternativos que um usuário pode usar no lugar do comando original.
 
|
 
<code>aliases: combust_me</code> OU
 
<code>aliases: [combust_me, combustMe, cm]</code>
 
 
|
 
*Você pode especificar nenhuma, 1 ou mais aliados.
 
*Se você especificar mais que 1 aliado, eles devem estar em um formato de lista YAML (Veja http://pt.wikipedia.org/wiki/YAML#Listas )
 
 
|-
 
| permission
 
| não
 
| O node de permissão mais básico requerido para usar o comando.
 
|
 
<code>permission: inferno.flagrate</code>
 
 
|
 
*Este node de permissão pode ser usado para determinar se um player deve ser capaz de ver o comando
 
*Alguns plugins podem usar isso para fazerem um /help personalizado.
 
|-
 
| permission-message
 
| não
 
| Uma mensagem para quando não há permissão.
 
| <code>permission-message: Você não tem a permissão /&lt;permission&gt;</code>
 
|
 
*Exibito a um player que tenta usar o comando, mas não tem a permissão associada.
 
*&lt;permission&gt; e um macro que é substituído com o node de permissão que é necessário para usar o comando.
 
*Você pode usar aspas vazias para indicar nada deve ser exibido.
 
 
|-
 
| usage
 
| não
 
| Uma curta descrição de como deve ser usado o comando.
 
| <code>usage: Esso de sintaze! Talvez você queira dizer /&lt;command&gt; NomeDoPlayer?</code>
 
|
 
*Exibido para quem emitiu o comando quando o handler de comando do plugin (tipicamente onCommand) retorna com return false.
 
*&lt;command&gt; é uma macro que é substituída pelo comando emitido onde quer que ocorra.
 
*Para usar a string "Uso:" (ex: <code>usage: Uso: /god [player]</code>, coloque o texto após ''usage:'' entre aspas duplas: <br> <code>usage: "Uso: /god [player]"</code>
 
 
|}
 
 
 
Um bloco de permissão começa com o nome da permissão, e em seguida uma lista de atributos
 
 
{| cellspacing="0" cellpadding="4" border="1" class="wikitable"
 
|-
 
! Atributo
 
! Requerido?
 
! Descrição
 
! Exemplo
 
! Notas
 
|-
 
| description
 
| não
 
| Uma curta descrição do que a permissão permite
 
| <pre>description: Permite que o player coloque fogo em si mesmo</pre>
 
|
 
*Permite o acesso programado, e ajuda os administradores dos servidores.
 
 
|-
 
| default
 
| não
 
| Marca o valor padrão da permissão
 
| <pre>default: true</pre>
 
|
 
*Se não existir o padrão será marcado para OP
 
*valores permitidos: true, false, op, not op
 
*padrão op significa que o player terá permissão se ele for op
 
*not op significa o contrário(sem op)
 
 
|-
 
| children
 
| não
 
| Permite que você defina as permissões-filhas da permissão. Nodes filhas são geralmente nomes de permissão
 
| <pre>children:
 
inferno.flagrate: true
 
inferno.burningdeaths: true</pre>
 
|
 
*Cada node de permissões filhas deve ser defina como true ou false
 
**Uma node com true faz a permissão pai herda-la
 
**Uma node com false herda a permissão inversa.
 
* Também pode conter outros nodes de permissão [https://github.com/bukkit/bukkit/commit/326f2aca9b98d1d096842d3410000ed9d84611f5 {1}]
 
 
|}
 
 
 
Exemplo:
 
 
<blockquote><source lang="yaml" style="border: 1px #aaa solid;">
 
name: Inferno
 
version: 1.4.1
 
description: Esse plugin permite que você se coloque em chamas.
 
# We could place every author in the authors list, but chose not to for illustrative purposes
 
# Also, having an author distinguishes that person as the project lead, and ensures their
 
# name is displayed first
 
author: CaptainInflamo
 
authors: [Cogito, verrier, EvilSeph]
 
website: http://forums.bukkit.org/threads/MyPlugin.31337/
 
 
main: com.captaininflamo.bukkit.inferno.Inferno
 
database: false
 
depend: [NewFire, FlameWire]
 
 
commands:
 
flagrate:
 
description: Coloca fogo em si.
 
aliases: [combust_me, combustMe]
 
permission: inferno.flagrate
 
usage: Erro de sintaxe! Use simplesmente /&lt;command&gt; para colocar fogo em si.
 
burningdeaths:
 
description: Lista quantas vezes voce ja morreu pelo fogo.
 
aliases: [burning_deaths, burningDeaths]
 
permission: inferno.burningdeaths
 
usage: |
 
/&lt;command&gt; [player]
 
Exemplo: /&lt;command&gt; - ve quantas vezes você foi queimado ate a morte
 
Exemplo: /&lt;command&gt; CaptainIce - ve quantas vezes CaptainIce foi queimado ate a morte
 
 
permissions:
 
inferno.*:
 
description: Da acesso a todos comandos do Inferno
 
children:
 
inferno.flagrate: true
 
inferno.burningdeaths: true
 
inferno.burningdeaths.others: true
 
inferno.flagrate:
 
description: Permite colocar fogo em si
 
default: true
 
inferno.burningdeaths:
 
description: Permite ver quantas vezes voce foi queimado ate a morte
 
default: true
 
inferno.burningdeaths.others:
 
description: Permite ver quantas vezes outros players foram queimados ate a morte
 
default: op
 
children:
 
inferno.burningdeaths: true
 
</source></blockquote>
 
 
{{Languages|Plugin YAML}}
 

Revision as of 10:06, 25 June 2017

Warmly congratulate XCRailway team's creation in minecraft have exceed 40,000 chunks!

What is XCRailway Team?

XCRailway is the focus of the Minecraft creation.XCRailway is the origin of the railway associations.XCRailway, a non-commercial non-profit Minecraft and Vocaloid railway creation team, founded on January 31, 2015, under the efforts of the founder xiaocao2015, has received extensive praise from the railway fans. XCRailway have created many fantastic works in many place. XCRailway have already had 1.5 million fans in China.

XCRailway Energy

Whether under the void, or the unbuildable area that above the world height limit; Whether in the disordered Far Land, or land that is difficult to exploit, XCRailway are never stop exploring and building. XCRailway, disseminated railway to every corner of the Minecraft and Vocaloid world. We believe that railways can create miracles. We believe that we have the ability to promote the spirit of XCRailway. Through the creation of various works on the railway, the fans and members of XCRailway can get the energy of the divine railway.

Creations

XCRailway, except for our minecraft world, created more than 40 pieces of music related to XCRailway; created more than 30 railway lines and locomotives in Railwork; XCRailway have received a wide range of praise all the time. XCRailway, in all walks of life, each dimension, each platform has a lot of excellent works.

Explorations

In the exploration of the unknown dimension, XCRailway team summed up a set of track characteristics of creative planning and methods. Since its inception to March 2017, a large number of fans and members of XCRailway support us. XCRailway members, like Xionglong , Yudian Xuehua, etc. have contributed greatly to the creation of XCRailway. So far, XCRailway has more than 1 million subscribers in weibo.XCRailway team will continue to flourish with the support of everyone.

In the end

XCRailway, will overturn all the obstacles along the way forward, efforts to advance, continue to create, to promote the XCRailway team - specific spirit of the railway, keep healthy and vigorous developing, create more excellent works, create miracle in the railway world,in the every dimensions!

Contact/Join Us

Zhihu : www.zhihu.com/people/XCRailway/activities
Weibo : weibo.com/xiaocao2015
Bilibili : space.bilibili.com/66261012
Telephone: ( 86) 135 0452 3672 (use Chinese only)