Aprenda a programar com Minecraft by Novatec Editora

Aprenda a Programar com Minecraft T r a n s fo r m e s e u m u n d o c o m o poder do Python

Craig Richardson

novatec

Copyright © 2015 by Craig Richardson. Title of English-language original: Learn to Program with Minecraft, ISBN 978-1-59327-670-6, published by No Starch Press. Portuguese-language edition copyright © 2016 by Novatec Editora Ltda. All rights reserved. Copyright © 2015 por by Craig Richardson. Título original em Inglês: Learn to Program with Minecraft, ISBN 978-1-59327-670-6, publicado pela No Starch Press. Edição em Português copyright © 2016 pela Novatec Editora Ltda. Todos os direitos reservados. © Novatec Editora Ltda. 2016. Todos os direitos reservados e protegidos pela Lei 9.610 de 19/02/1998. É proibida a reprodução desta obra, mesmo parcial, por qualquer processo, sem prévia autorização, por escrito, do autor e da Editora. Editor: Rubens Prates IG20160408 Assistente editorial: Priscila A. Yoshimatsu Tradução: Patrícia Gavazzi Revisão gramatical: Solange Martins e Smirna Cavalheiro Revisão técnica: Rafael Milléo Editoração eletrônica: Carolina Kuwabata ISBN: 978-85-7522-493-9 Histórico de impressões: Abril/2016

Primeira edição

Novatec Editora Ltda. Rua Luís Antônio dos Santos 110 02460-000 – São Paulo, SP – Brasil Tel.: +55 11 2959-6529 E-mail: novatec@novatec.com.br Site: novatec.com.br Twitter: twitter.com/novateceditora Facebook: facebook.com/novatec LinkedIn: linkedin.com/in/novatec IG20160411

INSTALAÇÕES E CONFIGURAÇÕES: PREPARANDO-SE PARA A AVENTURA

Antes de você começar a fazer programas legais em Python para o seu mundo do Minecraft, é preciso instalar o Minecraft, o Python e mais alguns softwares em seu computador. Neste capítulo, mostrarei como instalar e executar todos os tipos de software necessários. Você pode utilizar o Minecraft em seu PC Windows ou Mac; ou, ainda, pode usar o Minecraft: Pi Edition em um computador Raspberry Pi. Se estiver utilizando um PC Windows, basta continuar lendo. Se estiver usando um Mac, vá para “Configurando o seu Mac” na página 33. Se estiver usando um Raspberry Pi, vá para “Configurando o seu Raspberry Pi” na página 42. NOTA

Para obter informações sobre outras plataformas e atualizações referentes a essas instruções, acesse https://www.nostarch.com/pythonwithminecraft/.

Configurando o seu PC Windows Você precisa instalar cinco programas para que possa controlar o Minecraft com o Python: • Minecraft • Python 3 • Java • Minecraft Python API • Spigot Minecraft Server Nesta seção, vou orientá-lo na instalação de cada um deles em seu computador. Vamos começar com o Minecraft. Instalando o Minecraft

Se você já tem a última versão do Minecraft instalada em seu PC, vá direto para “Instalando o Python” na página 23. Se não tiver certeza de que tem a última versão do Minecraft, siga os passos nesta seção para instalar a versão mais recente. Se você ainda não possui o jogo, pode comprar uma cópia no site oficial do Minecraft, https://minecraft.net/. Talvez você precise da ajuda de um adulto! Lembre-se do nome de usuário e senha usados ao comprar o Minecraft – você precisará deles para efetuar login mais tarde. Após a compra do Minecraft, siga estes passos para instalar o jogo em seu PC: 1. Vá para https://minecraft.net/download. 2. Na seção Minecraft para Windows, encontre o link Minecraft.msi e clique para baixá-lo. Se for fornecida a opção de salvar ou abrir o arquivo, selecione Save File (Salvar arquivo). 3. Aguarde o download do arquivo e, em seguida, abra-o. Se uma caixa de diálogo aparecer perguntando se deseja executar esse arquivo, clique em Run (Executar). Não se preocupe; sabemos que esse arquivo é seguro! 4. Quando a janela do assistente de instalação abrir, clique em Next (Próximo). Em seguida, clique em Next mais uma vez. Depois, clique em Install (Instalar). 5. Será perguntado se você deseja instalar o Minecraft. É claro que sim! Clique em Yes (Sim). Aguarde um pouquinho enquanto o Minecraft é instalado. Tomei um copo d’água e comi um biscoito enquanto o jogo era instalado. 22

Capítulo 1

6. Após feita a instalação, clique em Finish (Finalizar). O Minecraft deve estar instalado agora. Sabe qual seria uma boa ideia? Jogar Minecraft, claro! Demora alguns minutos para a sua inicialização: 1. Para abrir o Minecraft, clique em Start Menu (Menu iniciar) (ou pressione a tecla Windows em seu teclado), encontre o Minecraft na lista de programas e clique no ícone. 2. O Minecraft será inicializado e poderá instalar atualizações. 3. A janela de login será aberta em seguida. Digite o nome do usuário e a senha que usou ao comprar o Minecraft e clique em Log In (Efetuar login). 4. Clique em Play (Jogar). O Minecraft fará o download de mais algumas atualizações antes de abrir. 5. Finalmente, clique em Single Player4Create New World (Um jogador4Criar novo mundo). Dê um nome para o seu mundo e clique em Create New World. O mundo será criado e você poderá jogar o quanto quiser. Divirta-se! Se você nunca jogou Minecraft antes, tente brincar um pouco, até que anoiteça em seu mundo Minecraft. Cuidado com os monstros! Observe que ao usar o Minecraft com o Python, você estará usando um jogo multiplayer, que será diferente deste mundo. Falaremos sobre isso em “Executando Spigot e criando um jogo” na página 28. De volta ao trabalho! Chegou a hora de instalar o Python. Para liberar o seu cursor do Minecraft, basta pressionar ESC em seu teclado. Feche o Minecraft antes de continuar a instalação. Instalando o Python

Python é a linguagem de programação que você aprenderá neste livro. Vamos instalá-lo agora. 1. Vá para http://www.python.org/downloads/. 2. Clique no botão Download Python 3.5.0. (No momento da escrita, esta é a versão mais recente do Python 3, mas você poderá encontrar uma versão posterior. Instale a versão mais recente.) 3. O download do programa será iniciado. Se for feita a pergunta para escolher entre salvar ou abrir o arquivo, selecione Save File (Salvar arquivo). Instalações e configurações: preparando-se para a aventura

4. Ao fazer o download do instalador, clique nele. Se uma caixa de diálogo aparecer perguntando se deseja executar esse arquivo, clique em Run (Executar). 5. Quando o instalador abrir, marque a caixa de seleção Add Python 3.5 to Path, conforme mostrado na parte inferior da Figura 1.1. Em seguida, clique em Install Now (Instalar agora).

Figura 1.1 – Certifique-se de ter selecionado Add Python 3.5 to Path.

6. Uma caixa de diálogo deve perguntar se você deseja instalar o software no computador. Clique em Yes (Sim) e aguarde a instalação do Python. Levantei-me para fechar a janela enquanto o programa estava sendo instalado e, quando voltei a me sentar, a instalação já tinha finalizado. 7. Clique em Finish (Finalizar). O Python já está instalado. Instalando o Java

Capítulo 1

Primeiro, verifique se o Java já está instalado: 1. Clique em Start Menu (Menu iniciar) (ou pressione a tecla Windows em seu teclado) e digite cmd na caixa de pesquisa. Abra o programa chamado cmd. 2. Você verá uma janela com um fundo negro e um prompt (o meu diz C:\Users\Craig>). No prompt, digite java -version e pressione ENTER . 3. Se você deparar com uma mensagem como a da Figura 1.2, o Java já está instalado. Vá direto para “Instalando a API do Minecraft Python e o Spigot” na página 26. 4. Se você receber uma mensagem dizendo que o Java não é reconhecido, instale-o usando as seguintes instruções.

Figura 1.2 – Após digitar o comando java -version, posso ver que o Java foi instalado.

Para instalar o Java, siga estes passos: 1. Vá para http://www.java.com/en/download/. 2. Clique no botão Free Java Download (Download gratuito do Java). Em seguida, clique no botão Agree and Start Free Download (Concordar e iniciar download gratuito). 3. Ao fazer o download do instalador, clique nele. Se uma caixa de diálogo aparecer perguntando se deseja permitir que o programa faça alterações em seu computador, selecione Yes (Sim). 4. Quando o instalador abrir, clique em Install (Instalar).

Instalações e configurações: preparando-se para a aventura

5. Esta parte é muito importante! Se aparecer uma página perguntando se deseja instalar um outro programa, como o Ask Search App, o Yahoo! search bar ou qualquer outro, desmarque a caixa para que esse programa adicional não seja instalado. Trata-se de mais um programa desnecessário. 6. Será perguntado se você deseja definir o Yahoo! como a sua página inicial. É provável que não. Selecione Do not update browser settings (Não atualizar as configurações do navegador) e clique em Next (Próximo). 7. Aguarde enquanto o Java é instalado. Escrevi uma breve mensagem para um amigo enquanto o programa era instalado. Clique em Close (Fechar) ao finalizar. Agora vamos verificar se o Java foi instalado corretamente: 1. Clique no Start Menu (Menu iniciar) e digite cmd na caixa de pesquisa. Abra o programa cmd. 2. Na janela cmd, digite java -version no prompt e pressione ENTER . 3. Se você se deparar com uma mensagem como a da Figura 1.2, o Java foi instalado corretamente. Se você receber uma mensagem de erro dizendo “‘Java não foi reconhecido como comando interno ou externo, um programa operável ou um arquivo em lotes”, o Java não foi instalado corretamente. Para corrigir isso, tente reinstalar o Java e executá-lo novamente. Se o erro ainda persistir após a reinstalação, vá para http://www.java.com/en/download/help/path.xml para obter mais informações. É isso! O Java está instalado e pronto para executar o Minecraft server! Vamos para o próximo item. Instalando a API do Minecraft Python e o Spigot

Capítulo 1

Um jogo padrão do Minecraft de um único jogador (single-player) não suporta uma API. Porém, os seus programas vão interagir com um servidor do Minecraft, possibilitando o uso de APIs. Os servidores do Minecraft são geralmente utilizados online para que várias pessoas possam jogar juntas em um único mundo. Também é possível criar um servidor em seu próprio computador para jogar sozinho. Tanto os servidores single-player quanto os multiplayer do Minecraft permitem que você use uma API com o Minecraft. Neste livro, você utilizará, em seu computador, um servidor single-player do Minecraft chamado Spigot. Agora que você já sabe o que é uma API e um servidor, vamos instalá-los em seu computador. Criei um download prático para que você possa fazer essas instalações rapidamente. Basta seguir estes passos: 1. Vá para https://www.nostarch.com/pythonwithminecraft/ e faça o download do arquivo Minecraft Tools.zip para Windows. 2. Ao finalizar o download do arquivo, clique no botão direito do mouse e selecione Extract All (Extrair tudo). Haverá uma pergunta sobre onde você deseja colocar os arquivos extraídos. Clique no botão Browse (Procurar) e vá para a pasta My Documents (Meus documentos). Clique no botão Make a New Folder (Fazer uma nova pasta) e chame a mesma de Minecraft Python. Selecione essa pasta e clique em OK. Clique em Extract (Extrair) para extrair os arquivos. 3. Vá para a pasta Minecraft Python em sua pasta My Documents, onde você deve ver os arquivos extraídos. 4. Abra a pasta Minecraft Tools. O seu conteúdo é mostrado na Figura 1.3. 5. Clique duas vezes no arquivo chamado Install_API . Uma nova janela se abrirá, instalando a API do Minecraft Python. Se você receber uma mensagem de alerta, clique em Run Anyway (Executar de qualquer maneira). 6. Após feita a instalação, pressione em qualquer tecla para finalizar. NOTA

Se você receber uma mensagem de erro dizendo que o pip não foi reconhecido, isso significa que você não instalou o Python corretamente. Volte a “Instalando o Python” na página 23 e reinstale o programa. Certifique-se de ter marcado a caixa de seleção que diz Add Python 3.5 to Path.

A API do Minecraft Python e o servidor do Minecraft estão instalados agora. O último passo é executar o servidor. Faremos isso na próxima seção.

Instalações e configurações: preparando-se para a aventura

Figura 1.3 – A pasta Minecraft Tools.

Executando o Spigot e criando um jogo

O Spigot, quando executado pela primeira vez, criará um mundo do Minecraft. Para inicializar o Spigot, siga estes passos: 1. Vá para a pasta Minecraft Python e abra a pasta Minecraft Tools. 2. Na pasta Minecraft Tools, clique duas vezes no arquivo Start_Server. Se você receber uma mensagem perguntando se deseja permitir o acesso, clique em Allow (Permitir). 3. O Spigot inicializará o seu servidor do Minecraft. Aparecerá uma janela com diversos textos enquanto o Spigot gera o mundo do jogo. Após a execução do Spigot , a sua tela deve ficar como a da Figura 1.4. Mantenha essa janela aberta. 4. Abra o Minecraft e clique em Multiplayer (Multijogador). 5. Clique no botão Add Server (Adicionar servidor). 6. Na caixa Nome do Servidor, chame o seu servidor como Minecraft Python World e, na caixa Endereço do Servidor, digite localhost, conforme mostrado na Figura 1.5. Em seguida, clique em Done (Feito). 7. Clique duas vezes em Minecraft Python World (Mundo do Minecraft Python), e o mundo criado pelo Spigot será aberto. 28

Capítulo 1

Figura 1.4 – O servidor Spigot está pronto.

Figura 1.5 – Instalando o servidor.

Vamos dar uma rápida olhada em seu novo mundo do Minecraft no servidor Spigot. O mundo foi configurado no Creative Mode (Modo criativo) para que você possa voar. Toque duas vezes na barra de espaço para voar. Segurar a barra de espaço fará com que você voe mais alto e pressionar SHIFT fará com que voe mais baixo em direção ao solo. Se quiser parar de voar, basta tocar duas vezes na barra de espaço.

Instalações e configurações: preparando-se para a aventura

Recomeçando um novo mundo

Criar um mundo Minecraft novíssimo com um servidor é um pouco diferente de criar um novo mundo no modo single-player (um jogador). Siga estes passos para criar um novo mundo: 1. Vá para a pasta Minecraft Python. Clique duas vezes na pasta Minecraft Tools e clique em Copy (Copiar). 2. Clique no botão direito do mouse em qualquer lugar na pasta Minecraft Python e clique em Paste (Colar). Esse procedimento criará uma cópia da pasta Minecraft Tools com o nome Minecraft Tools - Copy. 3. Clique no botão direito do mouse na pasta Minecraft Tools - Copy e clique em Rename (Renomear). Nomeie a nova pasta de New World, embora você possa dar o nome que quiser a ela. 4. Abra a pasta New World (ou qualquer que seja o nome que tenha dado) e, em seguida, abra a pasta server. 5. Na pasta server, selecione as pastas world, world_nether e world_the_end, conforme mostrado na Figura 1.6. Pressione DELETE para excluí-las.

Figura 1.6 – Destaquei as pastas que você precisa apagar.

6. Ainda na pasta server, clique no arquivo start. (Observe que é importante clicar neste arquivo start dentro da pasta server e não no arquivo original Start_Server!) Esse procedimento inicializará o servidor novamente para gerar um novo mundo. 30

Capítulo 1

7. Assim, quando você abrir o Minecraft e o Minecraft Python World, verá um mundo recém-gerado. É possível repetir esse processo para criar um novo mundo quantas vezes desejar. Se você quiser abrir o mundo antigo, pode ainda executá-lo clicando no arquivo Start_Server na pasta Minecraft Tools. Para apagar um mundo e substituí-lo por um novo, basta apagar as pastas world, world_nether e world_the_end na pasta do mundo que deseja substituir. Jogando offline

Se não tiver acesso a uma conexão da Internet, você receberá uma mensagem de erro ao tentar se conectar ao servidor do Minecraft com seu jogo. É possível corrigir esse problema alterando as propriedades do servidor. Primeiro, certifique-se de ter fechado a janela do servidor. Em seguida, abra a pasta Minecraft Python; depois, a pasta Minecraft Tools e, por fim, a pasta server. Abra o arquivo server.properties em um editor de texto, como o Notepad, e modifique a configuração online-mode (Figura 1.7) de true para false. Salve as modificações. A seguir, volte para a pasta Minecraft Tools e clique duas vezes em Start_Server para inicializar o servidor novamente. Agora você poderá jogar offline.

Figura 1.7 – Altere a configuração em destaque de true para false. Instalações e configurações: preparando-se para a aventura

Alterando para o Modo de Sobrevivência

Defini o Modo Criativo como o modo padrão de jogo para o seu servidor Minecraft. Isso facilitará ao escrever e executar programas em Python, pois você não terá que se preocupar se o personagem vai tomar dano, ficar com fome ou ser atacado. Mas pode ser que você queira testar alguns programas no Modo de Sobrevivência apenas por diversão. É fácil mudar o servidor do Modo Criativo para o Modo Sobrevivência e, depois, voltar. Para passar o servidor do Modo Criativo para o Modo Sobrevivência, siga estes passos: 1. Abra a pasta Minecraft Tools. Dentro dela, abra a pasta server. 2. Encontre o arquivo server.properties e abra-o com um editor de texto, como o Notepad. 3. No arquivo, encontre a linha que diz gamemode=1 e altere para gamemode=0, conforme mostrado na Figura 1.8.

Figura 1.8 – Alterei para o Modo Sobrevivência definindo gamemode para 0.

4. Salve o arquivo e feche-o.

Capítulo 1

5. Inicialize o servidor clicando no arquivo Start_Server na pasta Minecraft Tools. Ao entrar no jogo Minecraft Python World, este estará agora no Modo Sobrevivência. Você pode voltar ao Modo Criativo a qualquer momento. Basta repetir esses passos, mas, no passo 3, mude gamemode=0 para gamemode=1 no arquivo server.properties. Agora o seu PC está configurado! A seguir, vamos falar do IDLE, que é onde você escreverá o seu código. Vá para “Conhecendo o IDLE” na página 44.

Configurando o seu Mac Você precisa instalar cinco programas para que possa controlar o Minecraft com o Python: • Minecraft • Python 3 • Java Development Kit • Minecraft Python API • Spigot Minecraft Server Nesta seção, irei orientá-lo na instalação de cada um deles em seu computador. Vamos começar com o Minecraft. Instalando o Minecraft

Se você já tem a última versão do Minecraft instalada em seu Mac, vá direto para “Instalando o Python” na página 35. Se você não tem certeza de que tenha a última versão do jogo, siga os passos nesta seção para instalar a versão mais recente. Se você ainda não possui o jogo, pode comprar uma cópia no site oficial do Minecraft, https://minecraft.net/. Pode ser que você precise da ajuda de um adulto! Lembre-se do nome de usuário e senha usados ao comprar o Minecraft – você precisará deles para efetuar login mais tarde. Após a aquisição do Minecraft, siga estes passos para instalar o Minecraft em seu Mac: 1. Vá para https://minecraft.net/download. 2. Na seção Minecraft para Mac OS X, encontre o link Minecraft.dmg e clique nele para baixá-lo. [Se a seção Minecraft para Mac OS X não estiver visível, clique em Show all platforms (Exibir todas as plataformas).]

Instalações e configurações: preparando-se para a aventura

3. Aguarde o download do arquivo (olhei pela janela por alguns instantes) e, em seguida, abra-o. Quando a janela aparecer, arraste o ícone do Minecraft para a pasta Applications, conforme mostrado na Figura 1.9.

Figura 1.9 – Arraste o ícone do Minecraft para dentro da pasta Applications para instalá-lo.

O Minecraft deve estar instalado agora. Sabe qual seria uma boa ideia? Jogar Minecraft, claro! Demora alguns minutos para a sua inicialização: 1. Para abrir o Minecraft, clique no ícone do Finder no Dock para abrir o gerenciador de arquivos. 2. Na barra lateral, clique em Applications. 3. Encontre o Minecraft na pasta Applications, conforme mostrado na Figura 1.10. Clique duas vezes nela e selecione Open (Abrir). 4. Poderá haver uma pergunta se você deseja abrir o Minecraft, pois este foi baixado da Internet. Clique em Open. 5. O Minecraft será inicializado e poderá instalar atualizações. 6. A janela de login será aberta em seguida. Digite o nome do usuário e a senha que usou ao comprar o Minecraft e clique em Logi In (Efetuar login). 7. Clique em Play (Jogar). O Minecraft fará o download de mais algumas atualizações antes de abrir. 8. Finalmente, clique em Single Player4Create New World (Um jogador4Criar novo mundo). Dê o nome que quiser para o seu mundo e clique em Create New World. O mundo será gerado e você poderá jogar o quanto quiser.

Capítulo 1

Figura 1.10 – Encontre o Minecraft na pasta Applications.

Divirta-se! Se você nunca jogou Minecraft antes, tente brincar um pouco, até que escureça em seu mundo Minecraft. Cuidado com os monstros! Observe que, ao usar o Minecraft com Python, você estará usando um cenário de jogo multiplayer, que será diferente deste mundo. Falaremos sobre isso em “Executando Spigot e criando um jogo” na página 39. De volta ao trabalho! Chegou a hora de instalar o Python. Para liberar o seu cursor do Minecraft, basta pressionar ESC em seu teclado. Feche o Minecraft antes de continuar a instalação. Instalando o Python

Python é a linguagem de programação que você aprenderá neste livro. Vamos instalá-lo agora. 1. Vá para https://www.python.org/downloads/mac-osx/. 2. Clique no link que diz Latest Python 3 Release – Python 3.5.0 (Versão mais recente do Python 3 - Python 3.5.0). (No momento da escrita, esta é a versão mais recente do Python 3, mas você poderá encontrar uma versão posterior. Instale a versão mais recente.) O download do programa será iniciado. 3. Ao fazer o download do instalador, clique nele.

Instalações e configurações: preparando-se para a aventura

4. Quando o instalador abrir, clique em Continue (Continuar) três vezes. Será pedido que você aceite os termos do contrato de licença do software. Clique em Agree (Aceitar). 5. Clique em Install (Instalar) e aguarde a instalação do Python. Verifiquei a previsão do tempo enquanto esperava. 6. Clique em Close (Fechar). O Python já está instalado. Instalando o Java

Agora que o Minecraft e o Python já estão instalados, será necessário instalar mais alguns softwares para que eles possam se comunicar entre si. Para isso, você usará um programa chamado Spigot, mas, para que este funcione, é preciso instalar, primeiro, a versão mais recente do Java Development Kit (JDK) em seu computador. Vamos fazer isso agora: 1. Vá para http://www.oracle.com/technetwork/java/javase/downloads/index. html e clique no botão Java Download (Download do Java). 2. Selecione Accept License Agreement (Aceitar contrato de licença) e, em seguida, clique em Mac OSX x64. 3. Ao fazer o download do instalador, clique nele. 4. Quando o instalador abrir, clique duas vezes no ícone Install (Instalar). 5. Quando for solicitada a senha, digite-a. 6. Aguarde a instalação do Java. Clique em Close (Fechar) ao finalizar. Agora vamos verificar se o JDK foi instalado corretamente: 1. Clique em System Preferences (Preferências do sistema). 2. Você deve ver um ícone do Java abaixo de Preferências do sistema (System Preferences), conforme mostrado na Figura 1.11. É isso! O Java está instalado e pronto para executar o Minecraft server! Vamos para o próximo item.

Capítulo 1

Figura 1.11 – Java está instalado.

Instalando a API do Minecraft Python e o Spigot

Em seguida, você precisa instalar a API do Minecraft Python e o Minecraft server em seu computador. API significa Application Programming Interface (Interface de Programação de Aplicativos). Ela permite que os programas se comuniquem com aplicativos criados por outras pessoas. Neste caso, a API do Minecraft Python permite que os programas escritos por você em Python se comuniquem com o Minecraft. Por exemplo, você pode escrever um programa em Python que use a API para dizer ao Minecraft que construa um bloco ou mude a posição do jogador. Um jogo padrão do Minecraft de um único jogador (single-player) não suporta uma API. Em vez disso, os seus programas vão interagir com um servidor do Minecraft, possibilitando o uso de APIs. Os servidores do Minecraft são geralmente utilizados online para que várias pessoas possam jogar juntas em um único mundo. Também é possível criar um servidor em seu próprio Instalações e configurações: preparando-se para a aventura

computador e jogar sozinho. Tanto os servidores single-player quanto os multiplayer do Minecraft permitem que você use uma API com o Minecraft. Neste livro, você utilizará, em seu computador, um servidor single-player do Minecraft chamado Spigot. Agora que você já sabe o que uma API e um servidor fazem, vamos instalá-los em seu computador. Criei um download prático para que você possa fazer essas instalações rapidamente. Basta seguir estes passos: 1. Vá para https://www.nostarch.com/pythonwithminecraft/ e faça o download do arquivo MinecraftTools Mac.zip. 2. Após o download, abra a pasta Downloads e clique em Show in Finder (Mostrar no Finder). 3. No Finder, pressine a tecla CONTROL e clique no arquivo, selecionando Copy MinecraftTools Mac.zip. 4. Vá para a pasta Documents. Pressione a tecla CONTROL e clique na pasta, selecionando New Folder (Nova pasta). Chame a nova pasta de MinecraftPython. Certifique-se de não ter incluído um espaço no nome da pasta. 5. Abra a pasta MinecraftPython. Pressione a tecla CONTROL e clique na pasta, selecionando Paste Item (Colar item). O arquivo MinecraftTools Mac.zip será copiado aqui. 6. Pressione a tecla CONTROL e clique, selecione Open With4Archive Utility (Abrir com4Utilitário de arquivo). Quando o Utilitário de arquivo abrir o arquivo compactado, você terá uma nova pasta chamada MinecraftTools. 7. Abra a pasta Minecraft Tools. O seu conteúdo é mostrado na Figura 1.12. 8. Pressione a tecla CONTROL e clique no arquivo chamado Install_API. command, selecionando Open (Abrir). Esse procedimento abrirá uma nova janela. Digite a sua senha para instalar a API do Minecraft Python. 9. Após a instalação, feche a janela. NOTA

Se houver um erro dizendo que Install_API.command não pode ser aberto porque provém de um desenvolvedor não identificado, clique em System Preferences (Preferências do sistema) e, em seguida, clique em Security and Privacy (Segurança e privacidade). Você verá uma mensagem que diz “Install_API. command não foi aberto, pois é de um desenvolvedor não identificado).” Clique em Open Anyway (Abrir de qualquer maneira). Assim a janela deve aparecer.

Capítulo 1

Figura 1.12 – Os conteúdos da pasta MinecraftTools.

A API do Minecraft Python e o servidor do Minecraft estão instalados agora. O último passo é executar o servidor. Faremos isso em seguida. Executando o Spigot e criando um jogo

O Spigot, quando executado pela primeira vez, criará um mundo do Minecraft. Para inicializar o Spigot, siga estes passos: 1. Vá para a pasta Minecraft Python e abra a pasta Minecraft Tools. 2. Na pasta MinecraftTools, pressione a tecla CONTROL e clique no arquivo Start_Server, selecionando Open (Abrir). Se você receber uma mensagem de erro, vá para System Preferences (Preferências do sistema) e, em seguida, para Security and Privacy (Segurança e privacidade) e clique em Open Anyway (Abrir de qualquer maneira). 3. O Spigot inicializará o seu servidor do Minecraft. Aparecerá uma janela com um monte de texto, enquanto o Spigot gera o mundo do jogo. Ao terminar, certifique-se de ter mantido essa janela aberta. 4. Abra o Minecraft e clique em Multiplayer (Multijogador). 5. Clique no botão Add Server (Adicionar servidor). 6. Na caixa Nome do Servidor, chame o seu servidor como Minecraft Python World e, na caixa Endereço do Servidor, digite localhost, conforme mostrado na Figura 1.13. Em seguida, clique em Done (Feito). Instalações e configurações: preparando-se para a aventura

7. Clique duas vezes em Minecraft Python World (Mundo do Minecraft Python), e o mundo criado pelo Spigot será aberto. Vamos dar uma espiada em seu novo mundo do Minecraft no servidor do Spigot. O mundo foi configurado no Creative Mode para que você possa voar. Toque duas vezes na barra de espaço para voar. Segurar a barra de espaço fará com que você voe mais alto, e pressionar SHIFT fará com que voe mais baixo em direção ao solo. Se quiser parar de voar, basta tocar duas vezes na barra de espaço.

Figura 1.13 – Adicione o servidor para que você possa acessá-lo com facilidade no futuro.

Recomeçando um novo mundo

Criar um mundo Minecraft novíssimo com um servidor é um pouco diferente de criar um novo mundo no modo single-player (um jogador). Siga estes passos para criar um novo mundo: 1. Vá para a pasta MinecraftPython. Pressione a tecla CONTROL , clicando na pasta MinecraftTools e, em seguida, em Copy (Copiar). 2. Pressione a tecla CONTROL e clique em qualquer parte na pasta e, em seguida, em Paste (Colar). Esse procedimento criará uma cópia da pasta Minecraft Tools com o nome Minecraft Tools - Copy.

Capítulo 1

3. Pressione a tecla CONTROL e clique na pasta MinecraftTools copy e, em seguida, em Rename (Renomear). Nomeie a nova pasta de New World, embora possa dar o nome que quiser à sua. 4. Abra a pasta New World (ou qualquer que seja o nome que tenha dado) e, em seguida, abra a pasta server. 5. Na pasta server, selecione as pastas world, world_nether e world_the_end. Pressione SHIFT-DELETE para excluí-las. 6. Volte à pasta New World e clique no arquivo Start_Server. Esse procedimento inicializará o servidor novamente para gerar um novo mundo. 7. Assim, ao abrir o Minecraft e o Minecraft Python World, você verá um mundo recém-gerado. É possível repetir esse processo para criar um novo mundo quantas vezes desejar. Se quiser abrir o mundo antigo, você pode ainda executá-lo clicando no arquivo Start_Server na pasta Minecraft Tools no lugar da pasta New World. Para apagar um mundo e substituí-lo por um novo, basta apagar as pastas world, world_nether e world_the_end na pasta do mundo que deseja substituir. Jogando offline

Se não tiver acesso a uma conexão da Internet, você receberá uma mensagem de erro ao tentar se conectar ao servidor do Minecraft com seu jogo. É possível corrigir esse problema alterando as propriedades do servidor. Primeiro, certifique-se de ter fechado a janela do servidor. Em seguida, abra a pasta Minecraft Python, depois, a pasta Minecraft Tools e, por fim, a pasta server. Abra o arquivo server.properties em um editor de texto, como o TextEdit, e modifique a configuração online-mode de true para false (Veja Figura 1.7 na página 31). Salve as modificações. A seguir, volte para a pasta Minecraft Tools e clique em Start_Server para inicializar o servidor novamente. Agora você poderá jogar offline. Alterando para o Modo de Sobrevivência

Defini o Modo Criativo como o modo padrão do jogo para o seu servidor Minecraft. Isso facilitará ao escrever e executar programas em Python, pois você não terá que se preocupar se o personagem vai tomar dano, ficar com fome ou ser atacado. Mas pode ser que você queira testar alguns programas no Modo de Sobrevivência apenas por diversão. É fácil mudar o servidor do Modo Criativo para o Modo Sobrevivência e, depois, voltar. Instalações e configurações: preparando-se para a aventura

Para mudar o servidor do Modo Criativo para o Modo Sobrevivência, siga estes passos: 1. Abra a pasta Minecraft Tools. Dentro dela, abra a pasta server. 2. Encontre o arquivo server.properties e abra-o com um editor de texto, como o TextEdit. 3. No arquivo, encontre a linha que diz gamemode=1 e altere para gamemode=0, (veja Figura 1.8 na página 32). 4. Salve o arquivo e feche-o. 5. Inicialize o servidor clicando no arquivo Start_Server na pasta Minecraft Tools. Ao entrar no jogo Minecraft Python World, este estará agora no Modo Sobrevivência. Você pode voltar ao Modo Criativo a qualquer momento. Basta repetir esses passos, mas, no passo 3, mude gamemode=0 para gamemode=1 no arquivo server.properties. Agora o seu Mac está configurado! A seguir, vamos falar do IDLE, que é onde você escreverá o seu código. Vá para “Conhecendo o IDLE” na página 44.

Configurando o seu Raspberry Pi Faça o login em seu Raspberry Pi e inicialize o desktop com o comando startx. (Se você estiver usando a versão mais recente do sistema operacional do Raspberry Pi, não será necessário digitar esse comando.) Dependendo do seu Raspberry Pi, você pode ter duas ou três versões diferentes do Python instaladas. Para este livro, você usará a versão mais recente do Python, a Python 3. Por padrão, o computador Raspberry Pi vem com uma versão simplificada do Minecraft instalada chamada Minecraft: Pi Edition. Tudo que você precisa para começar a programar o seu mundo do Minecraft com Python já está instalado. Se você é iniciante no uso do Raspberry Pi, é possível encontrar instruções básicas no site oficial, http://www.raspberrypi.org/. Se estiver utilizando uma imagem do cartão SD mais antiga (criada antes de agosto de 2014), você pode achar que o Minecraft não esteja instalado. Assim, caso seja necessária, a instalação é fácil. Primeiro, é necessário conectar-se à Internet com o seu Raspberry Pi. Você pode encontrar um guia para fazer essa conexão em http://www.raspberrypi.org/. Assim que estiver conectado à Internet, siga estes passos:

Capítulo 1

1. Na área de trabalho, clique duas vezes em LXTerminal. 2. Assim que LXTerminal estiver aberto, digite este comando: $ sudo apt-get update

3. Após finalizar a atualização, digite este comando: $ sudo apt-get install minecraft-pi

4. Espere até que a instalação esteja concluída. O Minecraft já está instalado. Há algumas limitações para o Minecraft no Raspberry Pi comparado à versão de desktop. O mundo do jogo é bem menor, além de muitos blocos e outras funções (como o Modo de Sobrevivência) não estarem disponíveis, mas, ainda assim, você poderá escrever e executar todos os surpreendentes programas que estão neste livro. Antes de prosseguirmos, vamos criar uma pasta onde você possa armazenar os seus programas em Python. Na barra de tarefas, clique no ícone de gerenciador de arquivos. Abra a pasta Documents, clicando, em seguida, com o botão direito do mouse no segundo plano do gerenciador de arquivos e selecione Create New...4Folder (Criar nova...4Pasta). Nomeie a pasta Minecraft Python e clique em OK. NOTA

Se você estiver usando um Raspberry Pi original, você perceberá que alguns dos programas apresentados neste livro são executados de maneira lenta devido a limitações desse computador. O Raspberry Pi 2 apresentará menos problemas quanto à velocidade.

Para abrir o Minecraft, clique no menu iniciar na parte superior à esquerda do desktop. (Se estiver utilizando uma versão mais antiga do sistema operacional do Raspberry Pi, o menu iniciar estará na parte inferior à esquerda da tela.) Vá para Games (Jogos) e clique em Minecraft. O Minecraft será aberto. A primeira vez que abrir o Minecraft, terá que clicar em Create World (Criar novo mundo). Como regra geral, não redimensione a janela, já que poderá encontrar alguns problemas. Às vezes, ao abrir outras janelas ou caixas de diálogo (como a confirmação de que você deseja salvar um arquivo em Python), elas ficarão escondidas atrás da janela do Minecraft. Basta minimizar a janela do Minecraft quando quiser usar outras janelas. Se tiver problemas, tente reiniciar o Raspberry Pi após instalar o Minecraft. Instalações e configurações: preparando-se para a aventura

Conhecendo o IDLE Agora que está tudo instalado e configurado, vamos conhecer o IDLE, o software que você usará para escrever e executar os seus programas em Python. A instalação do Python inclui o IDLE, de modo que não precisa instalá-lo separadamente. Vamos abrir o IDLE agora! Windows Abra o Menu iniciar e digite IDLE na caixa de pesquisa. Mac Abra a pasta Applications e clique no ícone do IDLE. Raspberry Pi No desktop, clique duas vezes no ícone do IDLE chamado Python 3. Uma janela do IDLE se abrirá, conforme mostrado na Figura 1.14. Essa janela é chamada shell Python. O shell Python é tão fantástico que fiquei fascinado quando aprendi a programar com Python!

Figura 1.14 – Janela do IDLE: usada para escrever os programas em Python.

Conhecendo o Shell Python

O shell Python permite que você escreva e execute programas uma linha de cada vez. É possível escrever uma linha de código, executá-la instantaneamente, para ver o que acontece, e, em seguida, escrever outra linha. Isso é ótimo porque você pode, facilmente, experimentar e testar o seu código.

Capítulo 1

Na janela, você deve visualizar o símbolo (>>> ) no início da linha. Isso chama-se prompt de comandos e significa que o shell Python está pronto para receber um comando. Vamos começar com um comando bastante básico: adicionar ao Python dois números. Clique no shell Python e, ao lado do prompt de comandos, digite 2 + 2. Observe que você não precisa digitar o prompt de comandos (>>>). Você deve ter algo assim: >>> 2 + 2

Após digitar esse comando, pressione ENTER . O shell Python fornecerá o resultado. Neste caso, é 4: >>> 2 + 2 4

Você pode também usar o shell com texto. Digite este código no shell Python e pressione ENTER: >>> "W" + "o" * 5 Wooooo

Como se vê, esse código produz a palavra Wooooo. O número no final do comando determina quantos os há na palavra. Ao mudar esse número, você pode mudar o tamanho da palavra. Tente mudá-lo para 20 (ou qualquer outro número): >>> "W" + "o" * 20 Woooooooooooooooooooo

Woooooooooooooooooooo! O shell Python pode ser muito divertido. Observe que o IDLE deixa o código colorido. Isso chama-se destaque de sintaxe (syntax highlighting), recurso que facilita a visualização das diferentes partes do código. Todos os códigos presentes neste livro apresentam a mesma cor que os do IDLE, assim, as cores corresponderão quando você escrever os seus programas. A seguir, vamos mostrar o editor de texto do IDLE. Diga olá ao editor de texto do IDLE

Quando se trata de escrever programas mais longos, você não pode usar o shell. A solução é o editor de texto do IDLE! Diferentemente do shell, ele não executa uma linha de código de cada vez. Ao contrário, ele executa todo o programa quando for solicitado. Instalações e configurações: preparando-se para a aventura

No IDLE, clique em File (Arquivo) na barra do menu e selecione New File (Novo arquivo). Uma nova janela se abrirá como a que apresentamos na Figura 1.15. Este é o editor de texto.

Figura 1.15 – Editor de texto do IDLE.

“Ei!” Ouço você dizer. “O editor de texto parece igual ao shell Python do IDLE.” Sim, é igual, mas com uma diferença importante. A nova janela não tem prompt de comandos (>>>) no início de cada linha. Vamos ver o que isso significa. Na primeira linha do editor de texto, digite este código e pressione ENTER: print(2 + 2)

Você esperava que algo acontecesse? Ao pressionar ENTER , o código não foi executado – somente foi criada uma nova linha. Uma vez que o editor de texto não executa o código quando se pressiona ENTER , é possível escrever quantas linhas quiser antes de executá-las. Vamos acrescentar mais algumas linhas. É assim que seu arquivo deve ficar ao terminar: print(2 + 2) print("W" + "o" * 20) print("PYTHON!") print("<3s") print("Minecraft")

Capítulo 1

Antes de executar o seu código Python no editor de texto do IDLE, você precisa salvá-lo. Para salvar o programa, clique em File (Arquivo) e, em seguida, Save As (Salvar como). Crie uma pasta em sua pasta Minecraft Python chamada Setting Up. Salve esse programa como pythonLovesMinecraft.py na pasta Setting Up. Agora vamos executá-lo. Vá para Run (Executar) no menu e clique em Run Module (Executar módulo). A janela do shell se abrirá e o seu programa será executado nela. O resultado é mostrado na Figura 1.16.

Figura 1.16 – O resultado do programa Python.

Diferentemente do shell, os comandos executados no editor de texto fornecerão automaticamente seus resultados. É por isso que usamos print() para fornecer os resultados de seu código. Não se preocupe muito com os detalhes agora – mais adiante, no livro, você aprenderá tudo sobre isso. Sempre que você executar programas através do editor de texto do IDLE, o shell abrirá para executar o programa. Mesmo que você escreva o programa em uma janela separada, o IDLE sempre usa o shell para executar programas. Quando usar o Shell Python ou o editor de texto

Agora que você já sabe a diferença entre o shell Python e o editor de texto do IDLE, você pode pensar quando é melhor usar um ou outro. Em geral, uso o shell Python quando quero apenas testar algumas linhas, sem a intenção de reutilizá-las. Ao seguir o percurso deste livro, recomendo que você execute os pequenos exemplos usando o shell Python. Instalações e configurações: preparando-se para a aventura

Eu uso o editor de texto para programas que contêm um número razoável de linhas de código ou que desejo reutilizar. Todas as missões, neste livro, usam o editor de texto para que você possa salvar o seu progresso, mas sempre é possível utilizar o shell quando quiser testar algo de forma rápida. Os Prompts utilizados neste livro

Em todo o livro, sempre que encontrar um trecho de código escrito no shell Python do IDLE, este começará com o prompt de comandos (>>>), assim: >>> print("Wooooo Minecraft")

Recomendo que você copie o código no IDLE enquanto lê para que possa se familiarizar com ele. Qualquer resultado do shell será escrito na linha seguinte: >>> print("Wooooo Minecraft") Wooooo Minecraft

O código escrito no editor de texto não começará com o prompt de comandos, como ilustra o exemplo a seguir: print("Adventures")

O resultado do código não será exibido automaticamente em seu computador. Para mostrá-lo como deve ser o resultado ao executá-lo, vou explicá-lo ou ilustrá-lo. Por exemplo, a execução do código anterior deve resultar assim: Adventures

Para que você acompanhe as explicações do código com mais facilidade, incluí, no livro, marcadores para indicar sobre o que estou falando. Sempre que aparecer um desses no código, haverá uma explicação correspondente no texto e vice-versa. Os marcadores são assim: u

Testando a configuração do Minecraft Python Vamos verificar se todos os programas foram instalados corretamente. Para isso, vamos explorar rapidamente um programa bastante básico do Python que vai interagir com o Minecraft.

Capítulo 1

Antes de tudo: se estiver usando um PC ou um Mac, será necessário abrir três programas. Siga estes passos: 1. Abra o Spigot em sua pasta Minecraft Tools e clique em Start_Server. 2. Abra o Minecraft e conecte ao servidor Spigot selecionando Minecraft Python World (Mundo do Minecraft Python) por meio do menu multiplayer. 3. Aperte o ESC em seu teclado para liberar o cursor da janela do Minecraft e, em seguida, abra o shell Python no IDLE. Você deverá ter esses três componentes de software abertos sempre que escrever programas que interajam com o Minecraft. Se estiver usando um Raspberry Pi, abra o IDLE e o Minecraft. Agora digite esta linha no shell. Verifique se digitou com letras maiúsculas e minúsculas para haver a exata correspondência! >>> from mcpi.minecraft import Minecraft

Pressione ENTER para ir para a linha seguinte no shell. Depois, digite esta linha: >>> mc = Minecraft.create()

Nesse momento, se você receber uma mensagem de erro semelhante à da Figura 1.17, há algo errado.

Figura 1.17 – Uma mensagem de erro indicando que não inicializei o Spigot. Instalações e configurações: preparando-se para a aventura

Verifique estes itens em ordem: o Minecraft está aberto? O Spigot está funcionando? Você está no mundo multiplayer? Está usando a versão correta do Python (3 e não 2)? Se o erro ocorreu após digitar a primeira linha, isso significa que você não instalou a API corretamente. Execute os passos para instalar a API novamente. Se o erro ocorrer após a segunda linha, é provável que você não tenha instalado o Java ou o Spigot corretamente. Tente reinstalar esses componentes um de cada vez. Se ocorrer um erro que diz ImportError: No module named 'mcpi', é provável que esteja usando uma versão mais antiga do Python. Verifique se você tem a versão mais recente instalada! Se não receber uma mensagem de erro, acrescente esta linha ao programa no IDLE: mc.player.setTilePos(0, 120, 0)

Ao fazer isso, o jogador voará alto pelo ar! Esse código teletransporta o jogador para uma nova posição. Você aprenderá mais sobre isso no Capítulo 2. Vá para a página seguinte e comece!

Capítulo 1