rust-gamedig/crates/cli
dependabot[bot] 24134d6f23
chore(deps): update quick-xml requirement in /crates/cli
Updates the requirements on [quick-xml](https://github.com/tafia/quick-xml) to permit the latest version.
- [Release notes](https://github.com/tafia/quick-xml/releases)
- [Changelog](https://github.com/tafia/quick-xml/blob/master/Changelog.md)
- [Commits](https://github.com/tafia/quick-xml/compare/v0.36.0...v0.37.0)

---
updated-dependencies:
- dependency-name: quick-xml
  dependency-type: direct:production
...

Signed-off-by: dependabot[bot] <support@github.com>
2024-10-29 20:44:20 +00:00
..
.cargo fix(cli): add explicit cargo config for crate 2024-07-16 22:49:09 +01:00
src fix: add xml utf8 and semver declaration 2024-02-02 21:10:41 +00:00
Cargo.toml chore(deps): update quick-xml requirement in /crates/cli 2024-10-29 20:44:20 +00:00
CHANGELOG.md chore(cli): bump semver with changes 2024-07-15 11:58:18 +01:00
README.md chore(cli): update readme 2024-07-15 11:42:38 +01:00

rust-GameDig CLI

The official rust-GameDig Command Line Interface.

CI License:MIT node coverage

Community

Checkout the GameDig Community Discord Server here.
Note that it isn't be a replacement for GitHub issues, if you have found a problem within the library or want to request a feature, it's better to do so here rather than on Discord.

Usage

Just by running gamedig-cli prints the usage.
Note: Passing --help (or -h) shows the usage.

Here's also a quick rundown of a simple query with the json-pretty format:

Pick a game/service/protocol (check the GAMES, SERVICES and PROTOCOLS files to see the currently supported ones), provide the ip and the port (be aware that some game servers use a separate port for the info queries, the port can also be optional if the server is running the default ports) then query on it.

Team Fortress 2 query example:

gamedig-cli query -g teamfortress2 -i 127.0.0.1 -f json-pretty

What we are doing here:

  • -g (or --game) specifies the game.
  • -i (or --ip) target ip.
  • -f (or --format) our preferred format.

Note: We haven't specified a port (via -p or --port), so the default one for the game will be used (27015 in this case).

Response (note that some games have a different structure):

{
  "name": "A cool server.",
  "description": null,
  "game_mode": "Team Fortress",
  "game_version": "8690085",
  "map": "cp_foundry",
  "players_maximum": 24,
  "players_online": 0,
  "players_bots": 0,
  "has_password": false,
  "players": []
}

Contributing

Please read CONTRIBUTING.