MinecraftSync

Sincronizador simples de mundos do Minecraft Bedrock entre um PC Windows e um dispositivo Android usando ADB (Android Debug Bridge).

O projeto cria snapshots locais dos mundos do Android, permite importar um snapshot para o Minecraft Bedrock do Windows e cria um backup do conteúdo do PC antes de qualquer importação.

Requisitos

• Windows 10 ou mais recente com o Minecraft Bedrock instalado pela Microsoft Store.
• Windows PowerShell 5.1 ou mais recente.
• Minecraft Bedrock instalado no dispositivo Android.
• Depuração USB ativada e autorizada no dispositivo Android.

O script precisa do adb.exe (Android Debug Bridge) para as ações status e pull. Se ele não estiver no PATH, o script perguntará se você deseja baixar o Android SDK Platform-Tools oficial e instalar uma cópia local em tools\platform-tools. Essa instalação não exige administrador e não altera o PATH do Windows.

Feche o Minecraft no PC e no dispositivo Android antes de copiar os arquivos. Alterar um mundo enquanto o jogo está aberto pode causar perda ou corrupção de dados.

Download e estrutura

Baixe o projeto como ZIP e extraia todo o conteúdo em uma pasta chamada MinecraftSync. Não mova somente o arquivo sync.ps1: ele usa a pasta onde está localizado para guardar os dados.

Se o serviço de download acrescentar um sufixo como -main ao nome da pasta, renomeie a pasta extraída para MinecraftSync antes de executar o script.

A estrutura esperada é:

MinecraftSync/
|-- sync.ps1
|-- README.md
|-- LICENSE
|-- .gitignore
|-- worlds/
|   `-- .gitkeep
|-- tools/
|   `-- .gitkeep
`-- backups/
    `-- .gitkeep

As pastas worlds e backups já fazem parte do projeto. Se forem removidas, o script as recriará automaticamente na primeira execução sem apagar os dados existentes.

Configuração do ADB

O projeto aceita duas formas de obter o ADB:

• Se adb.exe já estiver no PATH, o script o reutiliza.
• Se não estiver disponível, execute setup ou qualquer ação que precise de ADB. O script perguntará antes de baixar o pacote oficial do Android SDK Platform-Tools e o manterá em tools\platform-tools dentro do projeto.

Para preparar a máquina explicitamente:

.\sync.ps1 -Action setup

Durante a instalação, responda s para autorizar o download. Responder qualquer outra coisa cancela a instalação e encerra a ação sem alterar o sistema. O pacote é baixado por HTTPS diretamente de dl.google.com; os arquivos baixados ficam ignorados pelo .gitignore e não devem ser commitados.

Depois de preparar o ADB:

1. Conecte o dispositivo Android por USB.
2. Ative a depuração USB e aceite a autorização RSA exibida no dispositivo.
3. Confirme a conexão:

adb devices

O dispositivo deve aparecer com o estado device. Estados como unauthorized ou offline precisam ser resolvidos no dispositivo antes de usar o sincronizador.

Uso rápido

Abra o PowerShell na pasta do projeto:

Set-Location .\MinecraftSync

Se a política de execução do PowerShell bloquear scripts locais, execute com uma permissão temporária para aquela chamada:

powershell -ExecutionPolicy Bypass -File .\sync.ps1 -Action status

Depois use uma das ações abaixo:

Ação	O que faz
status	Verifica o ADB, mostra os caminhos usados e lista os mundos encontrados no Android.
pull	Copia os mundos do Android para worlds\AAAA-MM-DD_HH-mm-ss.
push	Lista os snapshots locais, cria um backup do PC e importa o snapshot escolhido para o Minecraft do Windows.
backup	Cria somente um backup dos mundos atuais do PC em backups\AAAA-MM-DD_HH-mm-ss.
setup	Verifica o ADB e pergunta se deve instalar o Android Platform-Tools localmente quando ele não for encontrado.

Exemplos:

.\sync.ps1 -Action status
.\sync.ps1 -Action pull
.\sync.ps1 -Action push
.\sync.ps1 -Action backup
.\sync.ps1 -Action setup

Como funciona

1. pull usa ADB para copiar o diretório de mundos do Android para um novo snapshot em worlds.
2. push permite escolher um snapshot, cria um backup do diretório atual do Windows e pede confirmação antes de importar.
3. A importação sobrescreve arquivos de mundos com o mesmo identificador, mas não remove mundos que existam somente no PC.
4. Os dados reais dos mundos e dos backups ficam fora do controle de versão por meio do .gitignore.

O caminho padrão do Android é:

/sdcard/Android/data/com.mojang.minecraftpe/files/games/com.mojang/minecraftWorlds

O caminho padrão do Minecraft Bedrock no Windows é o pacote UWP:

%LOCALAPPDATA%\Packages\Microsoft.MinecraftUWP_8wekyb3d8bbwe\LocalState\games\com.mojang\minecraftWorlds

Se a versão do Minecraft usar caminhos diferentes, ajuste as variáveis $AndroidWorlds e $WindowsWorlds no início de sync.ps1.

Limitações e segurança dos dados

• O fluxo implementado é Android -> snapshot local -> Windows. Ele não envia mundos diretamente do PC para o Android.
• O script instala somente o Android Platform-Tools quando você autoriza. Ele não instala o Minecraft, drivers USB, PowerShell ou componentes do Windows.
• Algumas versões recentes do Android restringem o acesso ADB a Android/data. Nesse caso, o erro precisa ser resolvido no dispositivo ou o caminho deve ser ajustado.
• Sempre mantenha pelo menos um backup fora da pasta do projeto antes de operações importantes.
• Não execute push com o jogo aberto.

Contribuição

Correções e melhorias são bem-vindas. Ao testar alterações, não inclua arquivos reais de mundos ou backups no commit. Relate a versão do Windows, do Minecraft Bedrock, do Android e do ADB ao abrir uma issue.

Licença

Este projeto é distribuído sob a licença MIT, que permite uso, cópia, modificação e redistribuição com as condições descritas no arquivo da licença.