| Name | cdtb JSON |
| Version |
1.1.0
JSON |
| download |
| home_page | None |
| Summary | A toolbox to work with League of Legends game files |
| upload_time | 2024-08-19 19:04:46 |
| maintainer | None |
| docs_url | None |
| author | CDragon team |
| requires_python | >=3.8 |
| license | None |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# CommunityDragon Toolbox
A toolbox to work with League of Legends game files and export files for CDragon.
It can be used as a library or a command-line tool.
Most things are discussed on our [Discord server](https://discord.gg/rZQwuek). Feel free to join!
## Install
```
pip3 install cdtb
```
**Windows users:** if needed precompiled packages of binary dependencies can be found [here](https://www.lfd.uci.edu/~gohlke/pythonlibs/).
## Updating hashes
Most commands require hash lists which are updated frequently and and not bundled with this code.
To download them locally from `raw.communitydragon.org`, run:
```
cdtb fetch-hashes
```
The command will print where they are downloaded.
By default, they will land in `~/.local/share/cdragon` (or `%LOCALAPPDATA%/cdragon` on Windows).
An alternate location can be configured using the `CDTB_HASHES_DIR` or `CDRAGON_DATA` environment variables.
Hashes are versionned in the [Data](https://github.com/CommunityDragon/Data) repository.
## Command-line examples
The CLI interface allows:
- download game files and list relations between
- list and extract content of WAD files
- export game files to be served by CDragon
Here are some examples, use `cdtb -h` for details.
```sh
# download and extract files for the latest patch to the directory `cdn`
# (files from the new patcher will be used)
cdtb -v download -s cdn patch=
# download and extract files from the PBE to the directory `cdn`
cdtb -v download -s cdn --patchline pbe patch=main
# same, but don't download language-specific files
cdtb download -s cdn --no-lang patch=
# list patch versions (using already downloaded data in `cdn/`)
cdtb versions -s cdn patch
# list game files for patch 9.9
cdtb files -s cdn game=9.9
# extract a WAD file
cdtb wad-extract path/to/assets.wad
# list content of a WAD file
cdtb wad-list path/to/assets.wad
# export files from PBE
cdtb export -s cdn --patchline pbe --full main
# export files of patch 7.23 into export/7.23 (deprecated)
cdtb export -o export 7.23
```
## WAD files
WADs are archives used by the clients. They contain assets, game data (e.g.
item description), files for the LCU interface and more.
Paths of files in WAD files are hashed, they are not stored in clear in the
archive. A large number of these hashes have been guessed but there are still a
lot of unresolved hashes.
An hash list is provided and regularly updated with new hashes as they are
discovered, especially after client updates.
Raw data
{
"_id": null,
"home_page": null,
"name": "cdtb",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": null,
"author": "CDragon team",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/f4/2b/f730563318eebacd389504aa3f3bf5cfcffca1cfb86c4808831ae1822ce6/cdtb-1.1.0.tar.gz",
"platform": null,
"description": "# CommunityDragon Toolbox\n\nA toolbox to work with League of Legends game files and export files for CDragon.\nIt can be used as a library or a command-line tool.\n\nMost things are discussed on our [Discord server](https://discord.gg/rZQwuek). Feel free to join!\n\n## Install\n\n```\npip3 install cdtb\n```\n\n**Windows users:** if needed precompiled packages of binary dependencies can be found [here](https://www.lfd.uci.edu/~gohlke/pythonlibs/).\n\n\n## Updating hashes\n\nMost commands require hash lists which are updated frequently and and not bundled with this code.\n\nTo download them locally from `raw.communitydragon.org`, run:\n```\ncdtb fetch-hashes\n```\n\nThe command will print where they are downloaded.\nBy default, they will land in `~/.local/share/cdragon` (or `%LOCALAPPDATA%/cdragon` on Windows).\nAn alternate location can be configured using the `CDTB_HASHES_DIR` or `CDRAGON_DATA` environment variables.\n\nHashes are versionned in the [Data](https://github.com/CommunityDragon/Data) repository.\n\n\n## Command-line examples\n\nThe CLI interface allows:\n - download game files and list relations between\n - list and extract content of WAD files\n - export game files to be served by CDragon\n\nHere are some examples, use `cdtb -h` for details.\n\n```sh\n# download and extract files for the latest patch to the directory `cdn`\n# (files from the new patcher will be used)\ncdtb -v download -s cdn patch=\n\n# download and extract files from the PBE to the directory `cdn`\ncdtb -v download -s cdn --patchline pbe patch=main\n\n# same, but don't download language-specific files\ncdtb download -s cdn --no-lang patch=\n\n# list patch versions (using already downloaded data in `cdn/`)\ncdtb versions -s cdn patch\n\n# list game files for patch 9.9\ncdtb files -s cdn game=9.9\n\n# extract a WAD file\ncdtb wad-extract path/to/assets.wad\n\n# list content of a WAD file\ncdtb wad-list path/to/assets.wad\n\n# export files from PBE\ncdtb export -s cdn --patchline pbe --full main\n\n# export files of patch 7.23 into export/7.23 (deprecated)\ncdtb export -o export 7.23\n```\n\n## WAD files\n\nWADs are archives used by the clients. They contain assets, game data (e.g.\nitem description), files for the LCU interface and more.\n\nPaths of files in WAD files are hashed, they are not stored in clear in the\narchive. A large number of these hashes have been guessed but there are still a\nlot of unresolved hashes.\n\nAn hash list is provided and regularly updated with new hashes as they are\ndiscovered, especially after client updates.\n\n",
"bugtrack_url": null,
"license": null,
"summary": "A toolbox to work with League of Legends game files",
"version": "1.1.0",
"project_urls": {
"Homepage": "https://communitydragon.org",
"Repository": "https://github.com/CommunityDragon/CDTB"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "bb9ad17ac2aaadc511d203ad818cfd7758cb8c57cc0669cdea22bb198a12e169",
"md5": "39a3a4927c813ebd286463380b229cd1",
"sha256": "ff686286dc485444368b20a5aaf3b19bfacbed2bfd4c3dd76d0f3219e6f85991"
},
"downloads": -1,
"filename": "cdtb-1.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "39a3a4927c813ebd286463380b229cd1",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 63717,
"upload_time": "2024-08-19T19:04:44",
"upload_time_iso_8601": "2024-08-19T19:04:44.836012Z",
"url": "https://files.pythonhosted.org/packages/bb/9a/d17ac2aaadc511d203ad818cfd7758cb8c57cc0669cdea22bb198a12e169/cdtb-1.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "f42bf730563318eebacd389504aa3f3bf5cfcffca1cfb86c4808831ae1822ce6",
"md5": "b77c36b974dcc094e007e9eec5ad766d",
"sha256": "ffafe94ee8be14746c488086a6436f54dee5225d3826b6c72c0d72e1e5df760e"
},
"downloads": -1,
"filename": "cdtb-1.1.0.tar.gz",
"has_sig": false,
"md5_digest": "b77c36b974dcc094e007e9eec5ad766d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 56017,
"upload_time": "2024-08-19T19:04:46",
"upload_time_iso_8601": "2024-08-19T19:04:46.072700Z",
"url": "https://files.pythonhosted.org/packages/f4/2b/f730563318eebacd389504aa3f3bf5cfcffca1cfb86c4808831ae1822ce6/cdtb-1.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-19 19:04:46",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "CommunityDragon",
"github_project": "CDTB",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "cdtb"
}
