A Voyage AI se une ao MongoDB para impulsionar aplicativos de AI mais precisos e confiáveis no Atlas.

Explore o novo chatbot do Developer Center! O MongoDB AI chatbot pode ser acessado na parte superior da sua navegação para responder a todas as suas perguntas sobre o MongoDB .

Desenvolvedor do MongoDB
Centro de desenvolvedores do MongoDB
chevron-right
Produtos
chevron-right
MongoDB
chevron-right

Introdução ao Minecraft e ao MongoDB

Aasawari Sahasrabuddhe4 min read • Published Jul 15, 2024 • Updated Jul 15, 2024
MongoDBJava
SNIPPET
Ícone do FacebookÍcone do Twitterícone do linkedin
Avalie esse Início rápido
star-empty
star-empty
star-empty
star-empty
star-empty
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 .

Pré-requisitos

  1. Crie um cluster Atlas gratuito: Registre-se e crie seu cluster Atlas gratuito para obter sua connection string do MongoDB.
  2. Baixe o servidor Minecraft: Use o PaperMC para baixar o servidor Minecraft e aprimorar o ecossistema do Minecraft.
  3. Baixe o JDK mais recente: Usaremos a versão 22do Java para este tutorial.
  4. 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!

Iniciando o servidor do Minecraft

Depois que o arquivo jar do PaperMC for baixado, copie o jar para uma nova pasta e inicie o servidor usando o comando abaixo:
1java -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.

Conectando o aplicativo Java com MongoDB

Adicione suas dependências para PaperMC e spigot em seu pom.xml.
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çõesonEnable 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étodoonEnable() é 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étodoonDisable()é 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.
1mongo.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.
1mvn 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:
1aasawari.sahasrabuddhe@M-C02DV42LML85 plugins % pwd
2/Users/aasawari.sahasrabuddhe/minecraftServer/plugins
3aasawari.sahasrabuddhe@M-C02DV42LML85 plugins % ls
4MinecraftMongoDB-1.0-SNAPSHOT.jar bStats
5aasawari.sahasrabuddhe@M-C02DV42LML85 plugins %

Executando o aplicativo Java com o Minecraft Server

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:
Captura de tela demonstrando que a conexão com o MongoDB foi bem-sucedida
Legado: captura de tela demonstrando que a conexão com o MongoDB foi bem-sucedida

Próximos passos

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.

Conclusão

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.
Iniciar a conversa

Ícone do FacebookÍcone do Twitterícone do linkedin
Avalie esse Início rápido
star-empty
star-empty
star-empty
star-empty
star-empty
Relacionado
Tutorial

Uma leve introdução às listas vinculadas com o MongoDB


Apr 02, 2024 | 13 min read
Início rápido

Primeiros passos no MongoDB e Starlette


Jul 12, 2024 | 5 min read
Tutorial

A grande migração contínua: trabalhos do CDC com o Confluent Cloud e o Relational Migrator


Aug 23, 2024 | 11 min read
exemplo de código

Gestão de revistas


Sep 11, 2024 | 0 min read
Sumário