Introdução ao Minecraft e ao MongoDB
Avalie esse Início rápido
Neste tutorial, exploraremos como conectar seu aplicativo Java do MingoC ao MongoDB. Ao final, você terá uma configuração robusta que integra o MongoDB como seu banco de dados para gerenciar os dados dos jogadores.
O trecho de código completo e o projeto de amostra discutidos neste tutorial estão disponíveis no repositório doGithub .
- Crie um cluster Atlas gratuito: Registre-se e crie seu cluster Atlas gratuito para obter sua connection string do MongoDB.
- Baixe o servidor Minecraft: Use o PaperMC para baixar o servidor Minecraft e aprimorar o ecossistema do Minecraft.
- Atualize sua versão do driver Java do MongoDB: para este tutorial, usaremos a versão 5.1.0.
Vamos começar nesta impactante viagem de integração!
Depois que o arquivo jar do PaperMC for baixado, copie o jar para uma nova pasta e inicie o servidor usando o comando abaixo:
1 java -jar paper-1.20.6-147.jar
Isso baixará todas as dependências e criará várias pastas. Altere o
eula=true
no arquivoeula.txt
.Depois de definir isso, você está pronto para iniciar o servidor usando o comando acima.
Na próxima etapa, tentaremos entender como você pode fazer com que o aplicativo Java se conecte ao MongoDB.
Abaixo está um exemplo para baixar as dependências.
1 <dependencies> 2 <dependency> 3 <groupId>org.spigotmc</groupId> 4 <artifactId>spigot-api</artifactId> 5 <version>1.20.4-R0.1-SNAPSHOT</version> 6 <scope>provided</scope> 7 </dependency> 8 <dependency> 9 <groupId>org.mongodb</groupId> 10 <artifactId>mongodb-driver-sync</artifactId> 11 <version>5.1.0</version> 12 </dependency> 13 <dependency> 14 <groupId>io.papermc.paper</groupId> 15 <artifactId>paper-api</artifactId> 16 <version>1.20.1-R0.1-SNAPSHOT</version> 17 <scope>provided</scope> 18 </dependency> 19 </dependencies>
Depois que as dependências forem carregadas, podemos começar criando o plug-in e o arquivo de propriedades.
No desenvolvimento de plug-ins do Minecraft, particularmente com as APIs Bukkit ou Spigot (frequentemente usadas com o servidor PaperMC), as funções
onEnable
e onDisable
são métodos essenciais no ciclo de vida de um plug-in. Esses métodos fazem parte da classeMongoDBPlugin.java que sua classe de plug-in normalmente estende.O método
onEnable()
é chamado quando o plugin é habilitado pela primeira vez. É aqui que você coloca qualquer código de inicialização para o seu plugin. Normalmente é usado para registrar comandos, configurar arquivos de configuração, inicializar variáveis e outros recursos, etc.Para este tutorial, configuraremos a conexão do MongoDB nesta função.
1 @Override 2 public void onEnable() { 3 getLogger().info("MongoDBTest plugin has been enabled"); 4 Properties properties = new Properties(); 5 String uri ; 6 try (InputStream input = getClass().getClassLoader().getResourceAsStream("application.properties")) { 7 if (input == null) { 8 getLogger().severe("Sorry, unable to find application.properties"); 9 return; 10 } 11 properties.load(input); 12 uri = properties.getProperty("mongo.uri"); 13 MongoClient mongoClient = MongoClients.create(uri); 14 database = mongoClient.getDatabase("test"); 15 getLogger().info("Connected to the database successfully"); 16 // Example: Listing collections in the database 17 for (String name : database.listCollectionNames()) { 18 getLogger().info("Collection: " + name); 19 } 20 } catch (Exception ex) { 21 ex.printStackTrace(); 22 } 23 }
O método
onDisable()
é chamado quando o plug-in é desativado. É aqui que você coloca qualquer código de limpeza para garantir que o plug-in seja encerrado sem problemas. Normalmente, ele é usado para salvar dados em arquivos ou bancos de dados, cancelar o registro de ouvintes de eventos e fechar conexões de banco de dados.1 @Override 2 public void onDisable() { 3 getLogger().info("MongoDBTest plugin has been disabled"); 4 } 5 public MongoDatabase getDatabase() { 6 return database; 7 }
Obtenha sua cadeia de conexão do cluster do Atlas e copie-a para o arquivo application.properties conforme abaixo.
1 mongo.uri=<Place Your connection URI here>
Por fim, o arquivoplugin.yml é outro componente crucial do aplicativo cliente Mincron. Esse arquivo contém metadados e informações de configuração essenciais sobre o plugin, permitindo que o servidor carregue, habilite e gerencie adequadamente o plugin.
Finalmente, quando todo o código estiver em vigor, execute o comando abaixo para criar o arquivo JAR.
1 mvn clean package
Depois que o jar for criado, copie-o para a pasta de plug-ins do arquivo do servidor PaperMC. Abaixo está a aparência da pasta:
1 aasawari.sahasrabuddhe@M-C02DV42LML85 plugins % pwd 2 /Users/aasawari.sahasrabuddhe/minecraftServer/plugins 3 aasawari.sahasrabuddhe@M-C02DV42LML85 plugins % ls 4 MinecraftMongoDB-1.0-SNAPSHOT.jar bStats 5 aasawari.sahasrabuddhe@M-C02DV42LML85 plugins %
Para executar o aplicativo Java com o servidor Minecraft, copie o comando abaixo e execute o arquivo jar. Esse comando habilitará o servidor e fará a conexão com o banco de dados.
O servidor será iniciado e a imagem abaixo fornece uma visão geral que mostra que a conexão com o MongoDB foi bem-sucedida.
Como resultado do comando acima, você verá a seguinte mensagem:
1 [MongoDBConnection] Connected to the database successfully
Aqui é mostrado na captura de tela do terminal:

Agora que você estabeleceu com sucesso uma conexão com seu MongoDB database a partir do seu plug-in do Paper, você pode começar a estender a funcionalidade do seu plug-in. Tente interagir com o MongoDB database e gerenciar as informações do jogador. Você pode executar as operações CRUD gerenciando os jogadores que entram no jogo, modificando o status quando eles saem do jogo e assim por diante.
Integrar o MongoDB Atlas com um mod do Minecraft abre um mundo de possibilidades para aprimorar a funcionalidade do seu jogo. Seguindo as etapas descritas neste artigo, você aprendeu como configurar um cluster MongoDB Atlas, conectá-lo ao seu mod do Minecraft e realizar operações básicas de banco de dados. Com as etapas mencionadas na seção acima, você pode estender seu aplicativo e começar a gerenciar os jogadores que entram no jogo por meio de seu aplicativo.
Lembre-se, este é apenas o início. Experimente diferentes recursos e explorar todos os recursos do MongoDB Atlas para levar seu mod de Minerva para o próximo nível. Se você tiver mais dúvidas, fique à vontade para compartilhar suas avaliações e comentários em nosso MongoDB Community. Você também pode visitar o MongoDB Developer Center para obter mais artigos interessantes.
Principais comentários nos fóruns
Ainda não há comentários sobre este artigo.