mirror of
https://github.com/loot/libloot.git
synced 2026-07-27 14:16:01 -07:00
Oliver Hamlet
80d9f8be43
Sorting doesn't work as for other games, because esplugin can't tell if a plugin contains override records, so returns 0 for their count, so no overlap edges get added.
64 lines
2.9 KiB
Markdown
64 lines
2.9 KiB
Markdown
# libloot
|
|
|
|
[](https://ci.appveyor.com/project/LOOT/libloot/branch/dev)
|
|
[](https://travis-ci.org/loot/libloot)
|
|
[](http://loot-api.readthedocs.io/en/latest/?badge=latest)
|
|
|
|
## Introduction
|
|
|
|
LOOT is a plugin load order optimisation tool for TES III: Morrowind, TES IV: Oblivion, TES V: Skyrim, TES V: Skyrim Special Edition, Fallout 3, Fallout: New Vegas, Fallout 4 and Fallout 4 VR. It is designed to assist mod users in avoiding detrimental conflicts, by automatically calculating a load order that satisfies all plugin dependencies and maximises each plugin's impact on the user's game.
|
|
|
|
LOOT also provides some load order error checking, including checks for requirements, incompatibilities and cyclic dependencies. In addition, it provides a large number of plugin-specific usage notes, bug warnings and Bash Tag suggestions.
|
|
|
|
libloot provides access to LOOT's metadata and sorting functionality, and the LOOT application is built using it.
|
|
|
|
## Downloads
|
|
|
|
Releases are hosted on [GitHub](https://github.com/loot/libloot/releases), and snapshot builds are available on [Bintray](https://bintray.com/loot/snapshots/libloot). The snapshot build archives are named like so:
|
|
|
|
```
|
|
libloot-<last tag>-<revisions since tag>-g<short revision ID>_<branch>-<platform>.7z
|
|
```
|
|
|
|
## Building libloot
|
|
|
|
### Windows
|
|
|
|
Refer to `appveyor.yml` for the build process.
|
|
|
|
### Linux
|
|
|
|
Refer to `.travis.yml` for the build process. It assumes that you have already
|
|
cloned the libloot repository, that the current working directory is its root,
|
|
and that the following applications are already installed:
|
|
|
|
- `cmake`
|
|
- `curl` and libcurl (`libcurl4-openssl-dev` on Ubuntu)
|
|
- `git`
|
|
- `python` and `pip` (2.7 or 3, it shouldn't matter)
|
|
- `cargo` and the rest of the Rust toolchain (e.g. via
|
|
[rustup](https://rustup.rs/))
|
|
- `wget`
|
|
|
|
(The list above may be incomplete.)
|
|
|
|
### CMake Variables
|
|
|
|
libloot uses the following CMake variables to set build parameters:
|
|
|
|
Parameter | Values | Default |Description
|
|
----------|--------|---------|-----------
|
|
`BUILD_SHARED_LIBS` | `ON`, `OFF` | `ON` | Whether or not to build a shared libloot binary.
|
|
`MSVC_STATIC_RUNTIME` | `ON`, `OFF` | `OFF` | Whether to link the C++ runtime statically or not when building with MSVC.
|
|
|
|
You may also need to set `BOOST_ROOT` if CMake cannot find Boost.
|
|
|
|
## Building The Documentation
|
|
|
|
The documentation is built using [Doxygen](http://www.stack.nl/~dimitri/doxygen/), [Breathe](https://breathe.readthedocs.io/en/latest/) and [Sphinx](http://www.sphinx-doc.org/en/stable/). Install Doxygen and Python (2 or 3) and make sure they're accessible from your `PATH`, then run:
|
|
|
|
```
|
|
pip install -r docs/api/requirements.txt
|
|
sphinx-build -b html docs build/docs/html
|
|
```
|