evolve-save-editor/README.md

# Evolve Save Editor

CLI tool for editing [Evolve](https://pmotschmann.github.io/Evolve/) browser game save files.

Export your save in Evolve (Settings > Export), run a command, and import the modified save back.

## Setup

```bash
npm install
```

## Usage

### Interactive mode

Run with no flags to launch an interactive menu. It reads your save from the clipboard, lets you pick actions and select individual resources, then copies the result back.

```bash
node index.js
```

### CLI mode

Pass flags for non-interactive, scriptable usage. Reads save data from your **clipboard** by default (or from stdin/argument), applies edits, and copies the result back.

```bash
# List all resources and their current values
node index.js --list

# Max all capped resources
node index.js --max-resources

# Set all crafted (unlimited) resources to 100,000
node index.js --set-crafted=100000

# Combine both
node index.js --max-resources --set-crafted=100000

# Max only specific resources
node index.js --max-resources --only=food,stone,iron

# Set specific crafted resources to 50,000
node index.js --set-crafted=50000 --only=plywood,brick

# Read from stdin instead of clipboard
node index.js --max-resources < save.txt

# Print result to stdout instead of copying to clipboard
node index.js --max-resources --no-copy
```

## Options

| Flag | Description |
|------|-------------|
| `--list` | List all resources in the save, grouped by type (capped, crafted, special, locked) |
| `--max-resources` | Set all capped resources (`max > 0`) to their max |
| `--set-crafted=N` | Set all unlimited/crafted resources (`max == -1`) to N |
| `--only=a,b,c` | Only affect listed resources (comma-separated, case-insensitive). Matches resource names (e.g. `Food`) or internal keys (e.g. `food`). Applies to `--max-resources` and `--set-crafted`. |
| `--max-soldiers` | Fill garrison to max capacity and heal all wounded soldiers |
| `--no-copy` | Print the edited save to stdout instead of clipboard |
| `--help` | Show help |

## Workflow

1. In Evolve, go to **Settings > Export** (copies save to clipboard)
2. Run `node index.js --max-resources`
3. In Evolve, go to **Settings > Import** (pastes from clipboard)