1,157
edits
Help:Setting up tools: Difference between revisions
Jump to navigation
Jump to search
→Common requirements: Python 3.9 incompatibility
imported>NiceneNerd (Mention Wild Bits where relevant) |
(→Common requirements: Python 3.9 incompatibility) |
||
| (8 intermediate revisions by 4 users not shown) | |||
| Line 3: | Line 3: | ||
== Common requirements == | == Common requirements == | ||
=== Python === | === Python === | ||
Many of the tools for these formats require [[wikipedia:Python (programming language)|Python]] 3. | Many of the tools for these formats require [[wikipedia:Python (programming language)|Python]] 3.7+ ('''64 bit version''') to be installed. | ||
On Linux, Python 3 is surely already installed. Just make sure you have a recent enough version (3. | On Linux, Python 3 is surely already installed. Just make sure you have a recent enough version (3.7+). Ubuntu 16.04 and Debian stretch are too old; the latest Ubuntu LTS (18.04) and rolling distros such as Arch and Debian sid have 3.7+ in their repos. | ||
{{alert|class=primary|text=<b><i class="fa fa-download"></i> Setup instructions</b> | |||
On Windows, follow the below instructions to install Python: | On Windows, follow the below instructions to install Python: | ||
# Uninstall any existing Python version to avoid conflicts. | # Uninstall any existing Python version to avoid conflicts. | ||
# Download the [https://www.python.org/ftp/python/3.7. | # Download the [https://www.python.org/ftp/python/3.7.7/python-3.7.7-amd64.exe Python 3.7 installer] (latest version as of July 2019). | ||
# Run the installer: do a ''system-wide install'' and tick the "''add Python to environment variables / PATH''" option. | # Run the installer: do a ''system-wide install'' and tick the "''add Python to environment variables / PATH''" option. Note that if you install to the Program Files folder, you may occasionally run into permission issues with certain Python programs. To avoid this, install Python somewhere that does not require administrator permissions, such as <code>C:\Python37</code>. | ||
# Verify that <code>py -3 --version</code> works and gives the correct version (3. | # Verify that <code>py -3 --version</code> works and gives the correct version (3.7 or higher). {{CLI help}} | ||
If you have any trouble installing Python, or need more detailed instructions, you can use [https://www.youtube.com/watch?v=ndrCfBJkkvE this video tutorial]. | |||
}} | |||
{{alert|class=warning|text=Several tools and libraries (e.g. oead) are not compatible with Python 3.9 yet [https://bugs.python.org/issue41237 because of CPython issue #41237]. 3.9 compatibility will be added when Python 3.9.1 is released with the bug fix, which is due to happen in December 2020. | |||
}} | }} | ||
=== For Windows users: Visual C++ redistributable for Visual Studio 2019 === | |||
Several tools require the [https://aka.ms/vs/16/release/vc_redist.x64.exe 64-bit Visual C++ redistributable for Visual Studio 2019] to be installed. To be clear, Visual Studio is '''not''' required. | |||
Failure to install the redistributable will cause several Python tools to fail with the error "ImportError: DLL load failed". | |||
== Tools == | == Tools == | ||
| Line 53: | Line 64: | ||
For the second method, follow [https://gitlab.com/ice-spear-tools/ice-spear-builds the instructions in the official repo for Ice-Spear builds]. | For the second method, follow [https://gitlab.com/ice-spear-tools/ice-spear-builds the instructions in the official repo for Ice-Spear builds]. | ||
=== MSBT === | |||
[[MSBT]] files contain game texts. Convert them to an editable YAML format (and back) with {{ltool|msyt}} or (built on top of msyt) [https://github.com/polarbunny/msyt-tools msyt-tools]. Wild Bits also provides a GUI frontend for msbt. | |||
== Reverse engineering == | == Reverse engineering == | ||