{"id":50320034,"url":"https://github.com/bitsfdb/velocityrl","last_synced_at":"2026-06-06T07:01:56.601Z","repository":{"id":356667541,"uuid":"1231479218","full_name":"bitsfdb/VelocityRL","owner":"bitsfdb","description":"Swap the visual appearance of any Rocket League item. Free and open source.","archived":false,"fork":false,"pushed_at":"2026-05-31T02:59:22.000Z","size":12680,"stargazers_count":4,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-31T04:20:17.195Z","etag":null,"topics":["game-modding","item-swap","linux","open-source","rocket-league","rust","tauri","upk","velocityrl","windows"],"latest_commit_sha":null,"homepage":"https://velocityrl.tech","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bitsfdb.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-07T02:09:33.000Z","updated_at":"2026-05-31T02:41:31.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/bitsfdb/VelocityRL","commit_stats":null,"previous_names":["bitsfdb/rlitemmod","bitsfdb/velocityrl"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/bitsfdb/VelocityRL","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitsfdb%2FVelocityRL","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitsfdb%2FVelocityRL/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitsfdb%2FVelocityRL/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitsfdb%2FVelocityRL/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bitsfdb","download_url":"https://codeload.github.com/bitsfdb/VelocityRL/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitsfdb%2FVelocityRL/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33972398,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-06T02:00:07.033Z","response_time":107,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["game-modding","item-swap","linux","open-source","rocket-league","rust","tauri","upk","velocityrl","windows"],"created_at":"2026-05-29T03:02:27.401Z","updated_at":"2026-06-06T07:01:56.593Z","avatar_url":"https://github.com/bitsfdb.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# VelocityRL 🚀\n\nA powerful, user-friendly tool for performing visual asset swaps in Rocket League.\n\n\u003e **Note**: The NPM package for this tool is named `rl-item-mod`.\n\n## Overview\n\n**VelocityRL** provides an interactive terminal wizard and a premium desktop interface that allows you to swap in-game items (e.g., swapping a standard boost for Alpha Reward). Under the hood, it seamlessly invokes an advanced Python engine to accurately parse `.upk` encryption, perfectly expand Name Table string offsets, and rebuild the package architecture without causing game crashes.\n\n## Features\n\n- **Interactive Wizard**: A beautiful command-line interface to search for and select your source and target items.\n- **Python Interop**: Leverages a robust Python backend to handle complex LZO decompression, AES decryption, and binary offset shifting.\n- **Automated Backups**: Automatically backs up original game assets before patching, with a one-click CLI restore feature.\n- **Item Database**: Uses a built-in `items.json` database for fuzzy-searching and mapping in-game item names directly to their underlying UPK files.\n\n## ⚠️ Warning - Some Swaps Will Crash the Game\n\n\u003e **Swapping certain asset types is not yet fully supported and will cause Rocket League to crash on load.** This is a known limitation of the current version and is being worked on. Until a fix is released, avoid swapping the following:\n\n\u003e Thumbnails in general cause a lot of crashes, as well as bodies and goal explosions.\n\n\u003e If a swap you attempt causes a crash, you should validate game files, and when a crash occurs on an item use the **Restore backups** as shown in this screenshot\n\n\u003cimg width=\"571\" height=\"298\" alt=\"image\" src=\"https://github.com/user-attachments/assets/e09d09eb-1e0e-499c-9ddd-74fea68163d0\" /\u003e\n\n## Installation\n\n### Prerequisites\n\n- Node.js (v18+)\n- Python 3.8+ (must be available in your system PATH)\n\n### Global Install (Recommended)\n\n```bash\nnpm install -g rl-item-mod\n```\n\n```bash\npip install cryptography\n```\n\n### Local Development\n\n```bash\ngit clone https://github.com/bitsfdb/RLItemMod.git\ncd RLItemMod\nnpm install\nnpm run build\nnpm link\n```\n\n## Usage\n\nSimply launch the interactive wizard from your terminal:\n\n```bash\nrl-item-mod\n```\n\nOr run directly via npx:\n\n```bash\nnpx rl-item-mod@latest\n```\n\n## Credits\n\nMassive credits to [CrunchyRL/RLUPKTools](https://github.com/CrunchyRL/RLUPKTools) for making this repository possible. The advanced Python engineering for parsing and shifting Unreal Engine 3 UPK binaries was instrumental in making this project work safely.\n\n## Support\n\nContact me on discord: @sfdb\nOr on the support server https://discord.gg/2HhBNbrGMj\n\n## License\n\nMIT\n\n## Code Signing Policy\n\nFree code signing provided by [SignPath.io](https://signpath.io), certificate by [SignPath Foundation](https://signpath.org).\n\n| Role | Member |\n|------|--------|\n| Committers \u0026 Approvers | [@bitsfdb](https://github.com/bitsfdb) |\n\n## Privacy Policy\n\nThis program will not transfer any information to other networked systems unless specifically requested by the user or the person installing or operating it. Anonymous diagnostic reports may be sent to velocityrl.tech solely for crash analysis.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbitsfdb%2Fvelocityrl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbitsfdb%2Fvelocityrl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbitsfdb%2Fvelocityrl/lists"}