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

The tool reads save data from your **clipboard** by default (or from stdin/argument), applies edits, and copies the result back to the clipboard.

```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`. |
| `--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)