Holding Block now works without a shield: with a drawn melee weapon the player parries melee hits from the front. A parry lets [Game] 'weapon block damage' (default 0.5) of the damage through, and the weapon takes the rest as wear. It costs fatigue scaled by Block skill and trains Block like a shield block. A shield still blocks the whole hit. While in the stance with a shield, the left arm holds the shield raised using the shield group's "block start" to "block hit" keys. Animations without those keys are left alone. Requested by Eric during a playtest of #19. Refs #19 Refs #23 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Building OpenMW documentation
Building in Docker (the recommended way)
Preparing Docker image
Run the following commands from OpenMW source directory to build a new Docker image openmw_doc:
cd docs
docker build -t openmw_doc .
cd ..
(or run script docs/prepare_docker_image.sh)
This step needs to be repeated only if any dependencies were changed.
The image is based on Ubuntu 22.04 and installs the system tools and Python packages required to build the documentation. The bundled installation script builds Lua 5.1 and LuaRocks and installs a pinned version of openmwluadocumentor.
Generating HTML
Run the following command from OpenMW source directory to generate the documentation:
docker run --user "$(id -u)":"$(id -g)" --volume "$PWD":/openmw openmw_doc \
sphinx-build /openmw/docs/source /openmw/docs/build
(or run script docs/build_docs.sh)
To view the generated documentation just open docs/build/index.html in a browser.
Building without Docker (an alternative way)
Building documentation without Docker is more complicated as it requires multiple dependencies.
Installation of required python packages
From OpenMW source directory
pip3 install -r docs/requirements.txt
Installation of openmwluadocumentor:
Debian/Ubuntu
sudo apt install luarocks
git clone https://gitlab.com/ptmikheev/openmw-luadocumentor.git
cd openmw-luadocumentor/luarocks
luarocks --local pack openmwluadocumentor-0.2.0-1.rockspec
luarocks --local install openmwluadocumentor-0.2.0-1.src.rock
Windows
- install LuaRocks (heavily recommended to use the standalone package) https://github.com/luarocks/luarocks/wiki/Installation-instructions-for-Windows
git clone https://gitlab.com/ptmikheev/openmw-luadocumentor.gitcd openmw-luadocumentor/luarocks- open "Developer Command Prompt for VS <2017/2019>" in this directory and run:
luarocks --local pack openmwluadocumentor-0.2.0-1.rockspec
luarocks --local install openmwluadocumentor-0.2.0-1.src.rock
Generating HTML
Run the following command from OpenMW source directory to generate the documentation:
sphinx-build docs/source docs/build