<div align="center">

![PalworldSaveTools Logo](../assets/branding/PalworldSaveTools_Blue.png)

# PalworldSaveTools

**Um kit de ferramentas completo para editar arquivos de salvamento do Palworld**

[![Downloads](https://img.shields.io/github/downloads/deafdudecomputers/PalworldSaveTools/total)](https://github.com/deafdudecomputers/PalworldTools/releases/latest)
[![License](https://img.shields.io/github/license/deafdudecomputers/PalworldSaveTools)](LICENSE)
[![Discord](https://img.shields.io/badge/Discord-Join_for_support-blue)](https://discord.gg/sYcZwcT4cT)
[![NexusMods](https://img.shields.io/badge/NexusMods-Download-orange)](https://www.nexusmods.com/palworld/mods/3190)

[English](../../README.md) | [简体中文](README.zh_CN.md) | [Deutsch](README.de_DE.md) | [Español](README.es_ES.md) | [Français](README.fr_FR.md) | [Русский](README.ru_RU.md) | [日本語](README.ja_JP.md) | [한국어](README.ko_KR.md) | [Português (Brasil)](README.pt_BR.md) | [Português (Portugal)](README.pt_PT.md)

---

### **Baixe a versao autonoma do [GitHub Releases](https://github.com/deafdudecomputers/PalworldSaveTools/releases/latest)** 

---

</div>
<div align="center">

## Visão geral

<img src="https://readme-typing-svg.demolab.com?lines=O+que+exatamente+%C3%A9+isso%3F;Sua+economia%2C+do+seu+jeito;Uma+ferramenta+para+governar+todos+eles&center=true&width=490&height=28&font=monospace&size=22&color=7DD3FC&vCenter=true" alt="" />

</div>

Palworld Save Tools (PST) é um aplicativo de desktop rápido e completo para inspecionar e editar arquivos salvos do Palworld. Construído com Python e PySide6, ele lê e grava diretamente o formato de salvamento compactado do jogo - sem necessidade de mods de jogo.

Se você precisa gerenciar um servidor dedicado, migrar entre servidores cooperativos e dedicados, limpar dados abandonados ou ajustar Pals individual, o PST fornece uma interface unificada única para tudo isso.

### Destaques

- **Plataforma cruzada** — Binários pré-criados para **Windows**, **Linux** e **macOS**.
- **Análise nativa rápida** — Um dos leitores de arquivos salvos mais rápidos disponíveis, equipado com o mecanismo [`palsav`](src/palsav).
- **Mapa visual** — Mapa mundial interativo com marcadores de base/jogador, zonas de exclusão e calibração de coordenadas.
- **Edição profunda de Pal** — Controle total sobre estatísticas, IVs, almas, habilidades, passives, adequações de trabalho, classificação e sinalizadores de aparência.
- **Ferramentas de nível de servidor** — Exclusão em massa, limpeza, conversão e transferência de caracteres criadas para administradores.
- **Backups automáticos** — Cada operação de salvamento cria um backup antes de gravar.
- **9 idiomas** — UI localizada, guias no aplicativo e documentação.





---





## Indice

- [Visão geral](#visão-geral)
- [Recursos](#recursos)
- [Instalação](#instalação)
- [Início rápido](#início-rápido)
- [Guias](#guias)
- [Solução de problemas](#solução-de-problemas)
- [Construindo a partir da fonte](#construindo-a-partir-da-fonte)
- [Contribuindo](#contribuindo)
- [Isenção de responsabilidade](#isenção-de-responsabilidade)
- [Suporte](#suporte)
- [Licença](#licença)
- [A Equipe Palworld](#a-equipe-palworld)
- [Agradecimentos](#agradecimentos)

- [Suporte](#suporte)
- [Licença](#licença)
- [Agradecimentos](#agradecimentos)





---




<div align="center">

## Recursos

<img src="https://readme-typing-svg.demolab.com?lines=As+coisas+boas;Confira;Embalado+com+ferramentas&center=true&width=290&height=28&font=monospace&size=22&color=7DD3FC&vCenter=true" alt="" />

</div>

### Gerenciamento de jogadores

- Visualize e pesquise todos os jogadores por nome, nível, contagem de pal, UID, guilda e hora da última visualização.
- Edite nomes de jogadores, níveis, estatísticas e pontos de tecnologia.
- **Aba Estatísticas** — Estatísticas do herói (Saúde, Vigor, Ataque, Defesa, Velocidade de Trabalho, Peso) com valores corretos computados no jogo; Habilidades de relíquia com alternadores e giradores.
- **Max All Stats** — Limite instantaneamente todas as estatísticas ao máximo (50 pontos).
- **Operações em massa** entre vários jogadores: gerenciamento de itens, gerenciamento pal e desbloqueio de tecnologia.
- Excluir jogadores inativos por limite de tempo; remova duplicatas.

### Pal Editor

Uma interface de edição profunda para qualquer Pal de propriedade de qualquer jogador. Pals são organizados por **Party** (esquadrão ativo) e **Palbox** (armazenamento).

- **Estatísticas e IVs** — HP, Ataque, Defesa (IV 0–100), Nível (1–80), Classificação de Confiança (0–10).
- **Almas** — HP, Ataque, Defesa, Velocidade de Criação (0–20).
- **Habilidades** — Seletor de habilidades ativo; aprenda todos os movimentos; habilidades de sincronização em massa em Pals.
- **Passive Traits** — Seletor passivo com dados completos do jogo.
- **Adequação para o trabalho** — Defina níveis individuais de adequação para o trabalho (0–10).
- **Bandeiras de Aparência** — Alternar Boss/Alpha, Lucky/Shiny, Predator, Awakened e Imported/DNA.
- **Classificação e bloqueio** — Defina a classificação e o nível de bloqueio favorito (0–3).
- **Cheat Mode** — Alterne para expandir todas as letras maiúsculas: nível, IVs, almas, classificação do condensador para 255; desbloquear habilidades ativas/passivas ilimitadas com duplicatas permitidas.
- **Exportar/Importar** — Clique com o botão direito em qualquer pal para exportar como `.pstpal` (compactado) ou `.json`. Importe para slots vazios em party, palbox, DPS ou trabalhadores de base. Funciona em salvamentos e jogadores.
- **Max All Pals** — Maximize todas as estatísticas (IVs, almas, classificação, nível) para todos os pals no grupo, todas as páginas palbox ou todos os trabalhadores da base — respeita os limites do modo de trapaça.
- **Consertar Illegal Pals** — Detecta e limita pals com estatísticas, habilidades ou características ilegais por jogador.
- **Bulk Clone/Delete** — Diálogo de seleção de espécies com controles de quantidade e alternadores de origem (Party/Palbox/DPS) para operações em lote.
- Adicione novo Pals ou exclua rapidamente com clique duplo.

### Gerenciamento de Guilda

Visualização em dois painéis: lista de guildas no topo, lista de membros abaixo.

- Renomear guildas, mudar líderes, definir nível de guilda, nível máximo de guilda.
- Desbloqueie todas as pesquisas de laboratório; reconstruir todas as guildas.
- Mover jogadores entre guildas; exclua guildas vazias ou inativas.

### Ferramentas do acampamento base

- Veja todos os acampamentos base com associação de guilda.
- **Exportar** projetos básicos para `.json`; **importar** (arquivo único ou múltiplo) para qualquer guilda.
- **Clone** bases para outras guildas com posicionamento deslocado.
- **Alterar Coordenadas** — Clique com o botão direito em um marcador de base no mapa, escolha "Alterar Coordenadas" e clique em qualquer local para teletransportar a base.
- **Deslocamento de base** — Desloque uma base em deslocamentos X/Y/Z exatos para corrigir o corte ou a flutuação do solo.
- **Ajustar o raio da base** (50%–1000%).
- Excluir bases inativas e objetos do mapa não base.
### Visualizador de mapa

Visualização interativa de todo o seu mundo.

- Marcadores de base (ícone de casa) e marcadores de jogador (ícone de pessoa) com painéis de detalhes.
- Alternar sobreposições: Bases, Jogadores, Anéis de Raio, Zonas de Exclusão.
- **Desenho de zona** — Desenhe zonas de exclusão retangulares ou poligonais diretamente no mapa.
- **Modo de calibração** — Alinhe com precisão o mapa com as coordenadas do jogo.
- Visualizações do mapa mundial e do mapa em árvore; filtre por guilda ou nome do jogador.
- Zoom (1,0x–30,0x), panorâmica, clique duas vezes para voar até um marcador.
- Marcadores de clique com o botão direito e espaço vazio para ações de gerenciamento.

### Gerenciamento de estoque

**Inventário de jogadores** — Três subguias:
- *Inventário* — Todos os itens e equipamentos da sacola principal; editar quantidade, adicionar, remover.
- *Itens Principais* — Itens de missão, efígies e tecnologia; adicione em massa todas as efígies/itens principais.
- *Estatísticas* — Nível, HP, Vigor, Ataque, Defesa, Velocidade de Trabalho, Peso.
- Painel de equipamentos para armas, acessórios, alimentos, armaduras, escudos, planadores e slots de módulos.
- Desbloqueie todos os mapas + pontos de viagem rápida com um clique.

**Inventário Base** — Navegue e gerencie itens e trabalhe Pals em todas as bases:
- Visualizar/editar itens em containers; recipientes transparentes; modificar slots de contêiner.
- Operações de itens entre guildas (encontrar/remover itens em todas as guildas).
- Exclusão de estrutura entre guildas.
- Subguia **Base Pals** — Gerencie o Pals de trabalho atribuído a cada base com menus de contexto completos do editor pal.

### Exclusões

Listas de proteção que protegem jogadores, guildas e bases de operações de limpeza.

- Três painéis lado a lado: UIDs de jogadores, IDs de guilda e IDs de base excluídos.
- Adicione entradas através dos menus de contexto do botão direito nas guias Jogadores, Guildas ou Bases.
- Salve e carregue listas de exclusão de forma persistente.
- Crie sua lista **antes** de executar a limpeza em massa.

### Salvar ferramentas

Acessível na guia **Ferramentas** como cartões clicáveis:

| Ferramenta | Descrição |
|------|-------------|
| **Conversão salva** | Converter entre os formatos SAV e JSON |
| **Converter GamePass → Steam** | Converter salvamentos do Xbox/GamePass para o formato Steam |
| **Converter SteamID** | Converter IDs Steam em UIDs Palworld |
| **Restaurar mapa** | Aplique o progresso do mapa totalmente desbloqueado a todos os mundos/servidores |
| **Injetor de slot** | Aumentar slots de palbox por jogador |
| **Modificar Salvar** | Abra e modifique dados brutos salvos |
| **Transferência de personagem** | Transferir personagens entre mundos/servidores diferentes (salvamento cruzado) |
| **Corrigir o salvamento do host** | Troca de UIDs entre dois jogadores (troca de host, migração de plataforma) |

### Limpeza e funções utilitárias

Acessíveis via **Menu → Funções**, essas operações de nível de servidor incluem:

- **Exclusão** — Exclui guildas vazias, bases/jogadores inativos, jogadores duplicados, dados não referenciados.
- **Limpeza** — Remova itens inválidos/modificados, pals e passives inválidos, estruturas inválidas; corrigir pals ilegal (limite ao máximo legal); redefinir torres antiaéreas; desbloquear private chests; reparar todas as estruturas.
- **Redefinições** — Redefina missões, masmorras, plataforma de petróleo, invasor, entrega de suprimentos.
- **Timestamps** — Corrige timestamps negativos; redefinir os tempos dos jogadores.
- **PalDefender** — Gera comandos `killnearestbase`.





---




<div align="center">

## Instalação

<img src="https://readme-typing-svg.demolab.com?lines=Fa%C3%A7a+funcionar+em+minutos;Baixe+e+v%C3%A1;Nenhuma+configura%C3%A7%C3%A3o+necess%C3%A1ria&center=true&width=420&height=28&font=monospace&size=22&color=7DD3FC&vCenter=true" alt="" />

</div>

### Construções independentes (recomendado)

Binários pré-construídos estão disponíveis para todas as três plataformas principais de [GitHub Releases](https://github.com/deafdudecomputers/PalworldSaveTools/releases/latest):

| Plataforma | Baixar | Requisitos |
|----------|----------|-------------|
| **Janelas** | `PalworldSaveTools-*.exe` | Janelas 10/11, [VC++ Redistributable](https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170) (2015–2022) |
| **Linux** | `PalworldSaveTools-*-linux` | Qualquer distribuição moderna |
| **macOS** | `PalworldSaveTools-*-macos.dmg` | macOS 12+ (Monterey ou posterior) |

Também disponível em [Nexus Mods](https://www.nexusmods.com/palworld/mods/3190).

1. Baixe a versão apropriada para sua plataforma.
2. Extraia (se arquivado) e execute o executável.
3. É isso aí - não é necessário Python ou dependências.

> **Windows:** Se você vir "VCRUNTIME140.dll não encontrado", instale o [Microsoft Visual C++ Redistributable](https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170).

> **Linux:** Talvez seja necessário marcar o arquivo como executável: `chmod +x PalworldSaveTools-*-linux`

> **macOS:** Se o Gatekeeper bloquear o aplicativo, clique com o botão direito → **Abrir** na primeira vez ou execute `xattr -d com.apple.quarantine /path/to/app`.

### Da fonte (todas as plataformas)

PST usa [`uv`](https://docs.astral.sh/uv/) para gerenciamento de dependências. O script inicial cria automaticamente um ambiente virtual e instala tudo.

**Pré-requisitos:** [Python 3.11+](https://www.python.org/) e [uv](https://docs.astral.sh/uv/getting-started/installation/).

```bash
git clone https://github.com/deafdudecomputers/PalworldSaveTools.git
cd PalworldSaveTools
uv run start.py
```

**Windows** (clique duas vezes no iniciador):
```
start.cmd
```

O inicializador cria um `.venv`, instala dependências via `uv sync` e inicializa o aplicativo. Ele limpa o arquivo de bloqueio ao sair para que cada execução seja reproduzível.





---




<div align="center">

## Início rápido

<img src="https://readme-typing-svg.demolab.com?lines=Carregar.+Editar.+Salvar.+T%C3%A3o+simples.;Tr%C3%AAs+passos+para+a+gl%C3%B3ria;%C3%89+t%C3%A3o+f%C3%A1cil&center=true&width=450&height=28&font=monospace&size=22&color=7DD3FC&vCenter=true" alt="" />

</div>

1. **Carregue seu arquivo salvo**
   - Clique em **Menu → Carregar Salvar** ou arraste e solte um arquivo `.sav` na janela.
- Navegue até a pasta salva do Palworld e selecione `Level.sav`.

2. **Explore seus dados**
   - Use as abas — **Mapa**, **Ferramentas**, **Jogadores**, **Guildas**, **Bases**, **Inventário de Jogadores**, **Inventário Base**, **Pal Editor**, **Exclusões** — para explorar seu salvamento.
   - A barra de estatísticas mostra contagens ao vivo; ícones de navegação rápida saltam para cada seção.

3. **Faça alterações**
   - Clique com o botão esquerdo para selecionar; clique com o botão direito em quase tudo para ações contextuais.
   - Clique duas vezes para editar ou excluir rapidamente (consulte os guias do aplicativo para obter detalhes).

4. **Salve suas alterações**
   - Clique em **Menu → Salvar alterações**. Os backups são criados automaticamente.

> **Dica:** Cada guia possui um guia integrado. Clique no ícone de ajuda em qualquer guia para ver exatamente o que ela pode fazer. Para um conhecimento mais profundo, **passe o mouse sobre qualquer botão, campo ou controle** para revelar dicas de ferramentas detalhadas no cabeçalho. O sistema de ajuda com dicas de ferramentas no aplicativo é sua melhor referência para entender exatamente o que cada recurso faz e como usá-lo.





---




<div align="center">

## Guias

<img src="https://readme-typing-svg.demolab.com?lines=Passo+a+passo;Siga+o+guia;Mostraremos+como&center=true&width=390&height=28&font=monospace&size=22&color=7DD3FC&vCenter=true" alt="" />

</div>

### Salvar locais de arquivos

**Host/Cooperativo (Windows):**
```
%localappdata%\Pal\Saved\SaveGames\YOURID\RANDOMID\
```

**Servidor Dedicado:**
```
steamapps\common\Palworld\Pal\Saved\SaveGames\0\RANDOMSERVERID\
```

### Desbloqueio de mapa

O PST pode desbloquear o mapa completo (todos os pontos de viagem rápida) para você salvar:

1. Carregue seu arquivo salvo em PST.
2. Abra a aba **Inventário do Jogador** e clique em **Desbloquear todos os mapas + Viagem rápida** para um único jogador, **ou**
3. Use a ferramenta **Restaurar Mapa** na guia Ferramentas para aplicar o progresso do mapa desbloqueado em **todos** os seus mundos/servidores de uma só vez.
4. Salve as alterações. Backups automáticos são criados.

### Host → Transferência de Servidor

<details>
<summary>Clique para expandir</summary>

1. Copie `Level.sav` e a pasta `Players` do seu host save.
2. Cole-os na pasta dedicada de salvamento do servidor.
3. Inicie o servidor, crie um novo personagem e aguarde o salvamento automático.
4. Feche o servidor.
5. Use **Fix Host Save** em PST para migrar o GUID do personagem antigo para o novo.
6. Copie os arquivos de volta e inicie o servidor.

</details>

### Troca de Host (Alteração de Host)

<details>
<summary>Clique para expandir o guia de troca de host</summary>

**Antecedentes:**

- O host usa `0001.sav`.
- Cada cliente usa um UID regular exclusivo, como `1234.sav`, `9876.sav`, etc.
- O jogador A é o antigo anfitrião com progresso em `0001.sav`.
- O jogador B é um cliente existente que se tornará o novo host.

**Estado inicial:**
```
0001.sav = Player A, old host
1234.sav = Player B, future host
```

**Pré-requisitos:**
- O Jogador B deve ter entrado anteriormente no mundo do Jogador A e criado um personagem.
- O save regular do jogador B deve existir na pasta `Players`.
- O Jogador A e o Jogador B devem ter pelo menos Nível 2.
- Faça backup de toda a pasta de salvamento mundial antes de fazer alterações.
- Desligue o servidor ou feche o Palworld antes de modificar o salvamento.

---

### 1. Troque o jogador B no slot host

Abra **Fix Host Save** e selecione:
```
Source Player: Player A, 0001.sav
Target Player: Player B, 1234.sav
```
Execute a migração.

Resultado:
```
0001.sav = Player B's original progress
1234.sav = Player A's original progress
```
O Jogador B agora ocupa o slot de anfitrião. O progresso original do host do Jogador A é preservado no antigo UID regular do Jogador B.

---

### 2. Comece o mundo com o jogador B como o novo anfitrião

Inicie o Palworld com o Jogador B hospedando o mundo. Confirme se o jogador B tem o personagem, nível, inventário, pals, guilda, bases e propriedade corretos.

Salvar estado:
```
0001.sav = Player B, new host
1234.sav = Player A's original progress
```

---

### 3. Faça com que o jogador A se junte ao mundo do jogador B

O Jogador A junta-se ao mundo agora hospedado pelo Jogador B. Palworld pode atribuir ao Jogador A um novo UID regular porque ele não é mais o anfitrião.

Exemplo:
```
3456.sav = Player A's new client UID
```

Palworld pode pedir ao Jogador A para criar um novo personagem (esperado). O progresso original do Jogador A ainda está em `1234.sav`.

Após o Jogador A criar o personagem temporário:
```
0001.sav = Player B's correct progress
1234.sav = Player A's original progress
3456.sav = Player A's new temporary character
```

---

### 4. Personagem temporário do jogador de nível A

1. Faça com que o Jogador A alcance pelo menos o **Nível 2** com o personagem temporário.
2. Faça o Jogador A sair do servidor.
3. Encerre o servidor completamente.
4. Faça backup da pasta de salvamento mundial novamente.

O nível 2 é necessário porque **Fix Host Save** exige que ambos os caracteres selecionados sejam pelo menos de nível 2.

---

### 5. Restaure o progresso original do jogador A

Abra **Fix Host Save** novamente e selecione:
```
Source Player: Player A's original progress, 1234.sav
Target Player: Player A's new client UID, 3456.sav
```
Execute a migração. Porque esta é outra troca bidirecional:

```
0001.sav = Player B's correct host progress
3456.sav = Player A's restored original progress
1234.sav = Player A's temporary character
```
O novo UID do cliente do Jogador A agora aponta para o personagem original e o progresso do Jogador A.

---

### Resultado Final:
```
0001.sav = Player B, new host with original progress
3456.sav = Player A, client with restored original progress
1234.sav = Temporary leftover character
```
- O Jogador B hospeda usando o personagem original do Jogador B.
- O Jogador A entra usando o personagem original restaurado do Jogador A.

</details>

### Transferência de personagem (salvamento cruzado)

<details>
<summary>Clique para expandir</summary>

Transfira personagens entre diferentes mundos ou servidores preservando personagens, Pals, inventário e tecnologia:

1. Abra a ferramenta **Transferência de personagem** na guia Ferramentas.
2. Selecione o salvamento de origem e o salvamento de destino.
3. Transferir um único jogador ou todos os jogadores.
4. Útil para migrar entre servidores cooperativos e dedicados.

</details>

### Exportação/Importação/Clonagem Base

<details>
<summary>Clique para expandir</summary>

**Exportando uma Base:**
1. Vá para a aba **Bases** (ou use o Map Viewer).
2. Clique com o botão direito em uma base → **Exportar Base**.
3. Salve como um arquivo de blueprint `.json`.

**Importando uma Base:**
1. Clique com o botão direito na guilda alvo (na aba Bases, Map Viewer ou na aba Guildas).
2. Selecione **Importar Base** (arquivo único) ou **Importar Bases (Vários Arquivos)**.
3. Selecione o(s) arquivo(s) `.json` exportado(s).

**Clonando uma Base:**
1. Clique com o botão direito em uma base → **Clone Base**.
2. Selecione a guilda alvo.
3. A base é clonada com posicionamento deslocado.

**Ajustando o raio base:**
1. Clique com o botão direito em uma base → **Ajustar raio**.
2. Insira um novo raio (50%–1000%).
3. Salve e recarregue o arquivo salvo no jogo para que as estruturas sejam reatribuídas.

</details>





---




<div align="center">

## Solução de problemas

<img src="https://readme-typing-svg.demolab.com?lines=Quando+as+coisas+v%C3%A3o+para+o+lado;N%C3%A3o+entre+em+p%C3%A2nico;N%C3%B3s+vimos+tudo&center=true&width=390&height=28&font=monospace&size=22&color=7DD3FC&vCenter=true" alt="" />

</div>

### "VCRUNTIME140.dll não foi encontrado" (Windows)

Instale o [Microsoft Visual C++ Redistributable](https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170) (2015–2022).

### `struct.error` ao analisar um salvamento

O formato do arquivo salvo está desatualizado. Carregue o jogo salvo (Solo, Co-op ou Servidor Dedicado) uma vez para acionar uma atualização automática da estrutura e tente novamente. Certifique-se de que o salvamento foi atualizado no ou após o patch mais recente do jogo.

### GamePass conversor não funciona

1. Feche totalmente a versão GamePass do Palworld.
2. Aguarde alguns minutos para que os identificadores de arquivo sejam liberados.
3. Execute o conversor GamePass → Steam.
4. Inicie o Palworld em GamePass para verificar.

### O binário Linux/macOS não inicia

- **Linux:** `chmod +x PalworldSaveTools-*-linux` para marcá-lo como executável.
- **macOS:** Se bloqueado pelo Gatekeeper, clique com o botão direito → **Abrir** ou execute `xattr -d com.apple.quarantine /path/to/app`.





---




<div align="center">

## Construindo a partir da fonte

<img src="https://readme-typing-svg.demolab.com?lines=Compile+voc%C3%AA+mesmo;Construa+o+seu+pr%C3%B3prio;Da+fonte+ao+bin%C3%A1rio&center=true&width=340&height=28&font=monospace&size=22&color=7DD3FC&vCenter=true" alt="" />

</div>

PST oferece suporte a dois caminhos de construção. O pipeline de CI/CD usa Nuitka para binários de lançamento multiplataforma; cx_Freeze é usado para o instalador local do Windows.

### Nuitka (plataforma cruzada — usado por CI/lançamentos)

Requer Python 3.11+ e `uv`. Nuitka é instalado automaticamente.

```bash
# One-file build (Windows / Linux)
uv run python build/nuitka/build_nuitka.py --onefile

# One-directory build (macOS .app)
uv run python build/nuitka/build_nuitka.py --onedir
```

As saídas vão para `dist/`:
- Janelas → `dist/PalworldSaveTools-*.exe`
-Linux → `dist/PalworldSaveTools-*-linux`
- macOS → `dist/PalworldSaveTools.app` → empacotado como `.dmg`

### cx_Freeze (instalador do Windows)

Para um pacote local do Windows `.7z`:

```
scripts\build_cx.cmd
```

Isso cria `PST_standalone_v{version}.7z` na raiz do projeto.

### Construtor interativo

Um menu interativo para escolher um modo de construção:

```bash
uv run python build/build_interactively.py
```





---




<div align="center">

## Contribuindo

<img src="https://readme-typing-svg.demolab.com?lines=Quer+ajudar%3F+Veja+como;Junte-se+%C3%A0+equipe;Cada+contribui%C3%A7%C3%A3o+conta&center=true&width=440&height=28&font=monospace&size=22&color=7DD3FC&vCenter=true" alt="" />

</div>

Contribuições são bem-vindas! Sinta-se à vontade para enviar uma solicitação pull.

1. Bifurque o repositório.
2. Crie sua ramificação de recursos (`git checkout -b feature/AmazingFeature`).
3. Confirme suas alterações (`git commit -m 'Add some AmazingFeature'`).
4. Empurre para a ramificação (`git push origin feature/AmazingFeature`).
5. Abra uma solicitação pull.





---




<div align="center">

## Isenção de responsabilidade

<img src="https://readme-typing-svg.demolab.com?lines=Leia+isto+antes+de+quebrar+algo;Voc%C3%AA+foi+avisado;Fa%C3%A7a+backup+primeiro%21;Com+grande+poder...&center=true&width=520&height=28&font=monospace&size=22&color=7DD3FC&vCenter=true" alt="" />

</div>

**Use esta ferramenta por sua conta e risco. Sempre faça backup dos seus arquivos salvos antes de fazer qualquer modificação.**

Os desenvolvedores não são responsáveis por qualquer perda de dados salvos ou problemas que possam surgir com o uso desta ferramenta.





---




<div align="center">

## Suporte

<img src="https://readme-typing-svg.demolab.com?lines=N%C3%B3s+protegemos+voc%C3%AA;Precisa+de+ajuda%3F;Estamos+aqui+para+voc%C3%AA&center=true&width=340&height=28&font=monospace&size=22&color=7DD3FC&vCenter=true" alt="" />

</div>

- **Discord:** [Join us for support, base builds, and more!](https://discord.gg/sYcZwcT4cT)
- Problemas **GitHub:** [Report a bug](https://github.com/deafdudecomputers/PalworldSaveTools/issues)
- **Modificações Nexus:** [Download & discuss](https://www.nexusmods.com/palworld/mods/3190)





---




<div align="center">

## Licença

<img src="https://readme-typing-svg.demolab.com?lines=MIT+%E2%80%93+fa%C3%A7a+o+que+quiser;Gr%C3%A1tis+como+na+cerveja;C%C3%B3digo+aberto%2C+mente+aberta&center=true&width=430&height=28&font=monospace&size=22&color=7DD3FC&vCenter=true" alt="" />

</div>

Este projeto está licenciado sob a licença MIT — consulte o arquivo [license](license) para obter detalhes.





---




<div align="center">

## A Equipe Palworld

<img src="https://readme-typing-svg.demolab.com?lines=As+pessoas+por+tr%C3%A1s+da+magia;Conhe%C3%A7a+a+equipe;Constru%C3%ADdo+com+paix%C3%A3o&center=true&width=420&height=28&font=monospace&size=22&color=7DD3FC&vCenter=true" alt="" />

</div>

Este projeto não existiria sem as pessoas por trás dele.

### Mantenedores Ativos

**[Pylar](https://github.com/deafdudecomputers)** — O homem que começou tudo. Cada linha desta ferramenta remonta à sua visão e trabalho incansável no mecanismo de salvamento, na GUI e nos recursos que você usa todos os dias.

**[cyrix](https://github.com/CyrixJD115)** — Refatorador e submantenedor. Focado na qualidade do código, simplificação e melhorias estruturais — mantendo a base de código limpa, menor e mais fácil de manter à medida que o projeto cresce.

### Colaboradores

**[dkoz](https://github.com/dkoz)** — O homem por trás das identidades. Fornece IDs de dados de jogos, visão estrutural sobre os códigos de ID e conhecimento profundo de como os dados do Palworld são conectados, o que mantém a ferramenta precisa a cada atualização do jogo.

**[oMaN-Rod](https://github.com/oMaN-Rod)** — Fornecido o analisador de salvamento original do qual este projeto se bifurcou. Sem seu trabalho fundamental para quebrar o formato de salvamento do Palworld, nada disso existiria. O fork simplificou e simplificou seu analisador no que o PST é hoje.

**[Okaetsu](https://github.com/Okaetsu)** — Modificações de insights que tornaram possível a importação/exportação básica. Sua compreensão de como o Palworld estrutura os dados básicos do lado do modding preencheu a lacuna entre o modding e a edição salva, tornando esse recurso uma realidade.





---




<div align="center">

## Agradecimentos

<img src="https://readme-typing-svg.demolab.com?lines=Onde+o+cr%C3%A9dito+%C3%A9+devido;Obrigado+a+todos;Estamos+nos+ombros&center=true&width=390&height=28&font=monospace&size=22&color=7DD3FC&vCenter=true" alt="" />

</div>
Um enorme obrigado a:

- **Palworld** desenvolvido pela Pocketpair, Inc. — para o jogo que nos uniu.
- **Os repórteres de bugs** — cada problema registrado, cada caso extremo encontrado, cada log colado em Discord. Você torna essa ferramenta mais robusta a cada relatório.
- **A comunidade de modding Palworld** — colegas modders, desenvolvedores de ferramentas e criadores que compartilham conhecimento, fazem engenharia reversa de formatos e impulsionam o ecossistema. Este projeto está apoiado nesse esforço coletivo.
- **Todos os colaboradores e membros da comunidade** — quer você tenha enviado um PR, respondido uma pergunta em Discord ou simplesmente contado a um amigo sobre o PST — obrigado.

---

<div align="center">

![Divider](../assets/branding/PalworldSaveTools_readme_divider.png)

**Feito com ❤️ para a comunidade Palworld**

[⬆ Back to Top](#palworld-save-tools)

</div>