# idmangler-cli
Basically this generates fake items by loading from a json. Effectively a wrapper for [zatzou's idmangler-lib](https://github.com/Zatzou/idmangler-lib).
A video guide for Windows users can be found [HERE](https://www.youtube.com/watch?v=AvEUhs_6rEc).
## How to get the program
### Option 1: prebuilt
Go to the [releases tab](https://git.frfrnocap.men/endernon/idmangler-cli/releases)
### Option 2: compile yourself
requirements: rust, cargo
use `cargo run --release` to build and run.
### Option 3: get from crates.io
Requirements: rust-lang
run `cargo install idmangler-cli`.
## Usage
### 1) Setting up
- #### 1a) Linux:
- Open your preferred terminal emulator, and make sure the working directory is the directory with idmangler-cli extracted inside.
- Otherwise, if it's the wrong directory, run `cd PATH_TO_IDMANGLER_CLI_DIR` where `PATH_TO_IDMANGLER_CLI_DIR` is where idmangler-cli is stored.
- Run `chmod +x idmangler-cli` because by default it doesn't have executable permissions.
- #### 1b) Windows:
- Open the folder where idmangler-cli is extracted to in Windows File Explorer.
- Then, click the empty space in the top bar (it shows the path e.g. "This PC > Downloads") and type `cmd` and press enter.
- This should open a Command Prompt.
- At the start of the line displayed, it should say the path to the folder where File Explorer is open (e.g. "This PC > Downloads").
### 2) Getting necessary information files / Updating the necessary information files
- These files are from wynntils, and are data files necessary to the operation of the program.
- There are two methods of getting these information files.
- #### 1) Automatic download
- Windows: run `idmangler-cli.exe --download all`
- Linux: run `idmangler-cli --download all`
- #### 2) Manual download
- Move the program to some folder along with config.json . Download these three files and place them next to the program:
- https://raw.githubusercontent.com/Wynntils/Static-Storage/main/Reference/id_keys.json
- https://raw.githubusercontent.com/Wynntils/Static-Storage/main/Data-Storage/shiny_stats.json
### 3) Actually generating an item
- Read through the provided `config.md` document. You can get the web version [HERE](docs/config.md).
- Once you have read through it, use one of the provided json files to create your own json.
- Run the program with it.
- Windows: run `idmangler-cli.exe --config CONFIG_FILE_PATH`
- Linux: run `idmangler-cli --config CONFIG_FILE_PATH`
- Where CONFIG_FILE_PATH is the actual path to the file.
- Now, what happens is there should be an output line that has the encoded file.
- Copy the whole line and paste it into minecraft chat or whatever.