A powerful CLI tool that simplifies and streamlines the IW4MAdmin database, offering a more user-friendly view of all your game server statistics.
Go to file
2024-03-03 05:24:56 -05:00
assets Fix filename in build script, add icon for build executable 2024-03-02 22:48:29 -05:00
src
build.py Fix filename in build script, add icon for build executable 2024-03-02 22:48:29 -05:00
parse_db.py Add sorting functionality to extra tables, homogenize code 2024-03-03 04:50:44 -05:00
README.md Update README.md 2024-03-03 05:24:56 -05:00

IW4MAdmin Database Parser

A Python3 script designed to export your IW4MAdmin database, parsing it into an easily accessible format. While the native IW4MAdmin\Database\Database.db is already accessible, navigating its complex relationships, keys, and constraints can be frustrating. This tool simplifies and streamlines the data, offering a more user-friendly view.

Arguments


optional arguments:
  -h, --help            show this help message and exit
  -s {ASC,DESC}, --sort {ASC,DESC}
                        Sort order for the query results (ASC or DESC).
  -p PATH, --path PATH  Path to the IW4MAdmin database file.
  -o OUTPUT, --output OUTPUT
                        Output directory for the parsed database file.
  -t, --time            Time the script's execution.
  -c, --config          Use default config.json for configuration.```

## Instructions
1. Copy the database to a folder and make sure it's named 'Database.db'
2. Copy the script `parse_db.py` into the location of your database's copy
3. Run the script

* This will generate a new database named `Database_parsed.db` with all of the essential information.

## Building

1. Ensure Python3 is installed on your system and added to PATH
2. Run `build.py`

## Examples

- Parse and save the IW4MAdmin Database in its native directory.
   - `python parse_db.py -p "IW4MAdmin\Database\Database.db" -o "IW4MAdmin\Database"`

- Parse the database on the desktop, output to documents, use a config file, time the operation, and sort entries in descending order.
   - `python parse_db.py -c -t -p "C:\Users\User\Desktop\Database.db" -o "C:\Users\User\Documents" -s DESC`

- Use config file and output to a specific folder.
   - `python parse_db.py -p "Database.db" -o "FilteredOutput" -s DESC -c`

- Parse the database with timing
   - `python parse_db.py -t -p "Database.db" -o "TimedOutput"`

- Extract using the config file for the newest/oldest database entries
   - `python parse_db.py -c -p "Database.db" -o "SelectiveOutput" -s DESC -t`