https://github.com/e-rk/speedtools
Data parsing utilities for Need for Speed 4 HS (PC) with Blender import addon.
https://github.com/e-rk/speedtools
blender blender-addon needforspeed parser python
Last synced: 3 months ago
JSON representation
Data parsing utilities for Need for Speed 4 HS (PC) with Blender import addon.
- Host: GitHub
- URL: https://github.com/e-rk/speedtools
- Owner: e-rk
- License: gpl-3.0
- Created: 2023-03-05T15:57:07.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2024-08-24T00:15:53.000Z (11 months ago)
- Last Synced: 2024-11-08T07:47:46.735Z (8 months ago)
- Topics: blender, blender-addon, needforspeed, parser, python
- Language: Python
- Homepage:
- Size: 207 KB
- Stars: 10
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# About
This project provides data extraction utilities for the following Need for Speed 4 HS asset files:
- tracks
- cars
Additionally, Blender addon is provided to directly import track and car data.
# Recommended setup
1. Download the latest ZIP file from [Releases][5].
2. Open Blender.
3. Go to `Edit -> Preferences -> Get Extensions`.
4. Click `v` in the top right corner of the window.
5. Click `Install from Disk...`.
6. Select the downloaded ZIP file.
7. Activate the addon in the `Add-ons` panel.
# Old setup instructions
> **Warning**: Use instructions from this section only if you have problems with the recommended setup.
1. Create new empty Blender project
2. Open the __Scripting__ tab
3. Copy-paste the following two commands into the Blender console:
```
import sys, subprocess
subprocess.call([sys.executable, "-m", "pip", "install", "speedtools"])
```
This command will install the [`speedtools`][1] package to your Blender Python installation.
> **Note**: Python installation that comes with Blender is completely separate from the global Python installation on your system. For this reason, it is necessary to use the Blender scripting console to install the package correctly.
4. Copy and paste the content of [this][2] file to the Blender scripting window.
5. Click the __▶__ button.
6. You should see `Track resources` and `Car resources` under `File > Import`.
# Setup (command line version)
Install the package from PyPI:
```
pip install speedtools
```
Currently, the command line version does not provide any useful functionality.
# Development dependencies
This setup is needed only if you plan to modify the add-on.
To develop the project the following dependencies must be installed on your system:
* [Kaitai Struct compiler][3]
Make sure the binary directories are in your `PATH`.
# Re-make project
This tool is a part of the re-make project. The project source code is available [here][4].
[1]: https://pypi.org/project/speedtools/
[2]: https://github.com/e-rk/speedtools/blob/master/speedtools/blender/io_nfs4_import.py
[3]: https://kaitai.io/
[4]: https://github.com/e-rk/velocity
[5]: https://github.com/e-rk/speedtools/releases