World of Warcraft add-on stub. The overall goal is to create a specialized raid frame.
No history found.
README.adoc:
= Chorus
Vladyslav Bondarenko <vladyslavbond@protonmail.com>
0.7.1 (unstable), 2024-01-27
Chorus is a graphical user interface extension for a popular video game World
of Warcraft. It adds a custom raid frame. This is a work in progress.
Features:
- approximate distance to every raid member in yards;
- sort debuffs by relevance;
- generalize raid and party frames;
Supported game version is legacy 3.3.5a (or interface 30300).
The motivation is to create a robust minimalistic raid frame. It must work
out-of-the-box and require no configuration by the user. It must be comparable
in it's features with modern native raid frame that was shipped with the game
since Cataclysm expansion (interface 40000).
This add-on will never feature key binding customization. This feature is
specifically excluded to be the subject of a different add-on.
== Install
The project is installed like any other World of Warcraft add-on. Exit the
game. Unpack the archive that contains the project's sources into
`${DESTDIR}/Interface/AddOns/` directory, where `${DESTDIR}` is the path to the
game installation directory. In the end it must look something like this.
----
Interface/Addons/chorus/
Interface/Addons/chorus/bin/
Interface/Addons/chorus/etc/
Interface/Addons/chorus/share/
Interface/Addons/chorus/src/
Interface/Addons/chorus/README.adoc
Interface/Addons/chorus/chorus.toc
----
Experienced users may install the add-on with `git`.
----
git clone --branch master https://rocketgit.com/user/vrtc/chorus "${gamedir}/Interface/AddOns/chorus"
----
== Development
=== Build dependencies
The project does not require any building steps to work. It can be freely
distributed as sources only. However, the project was developed using certain
tools that may still be applicable.
Build dependencies:
- luacheck (static analysis for Lua);
- xmllint (XML validator);
- luarocks (packaging and project management for Lua);
- ldoc (generate technical documentation from Lua sources);
==== Build dependencies for Debian 12
Install build dependencies for Debian 12.
----
apt-get install libxml2-utils lua-check lua-ldoc make git
----
==== Build dependencies for Windows
Insalling for Windows is much more tricky. The first step is to install
LuaRocks, then use LuaRocks to install LuaCheck and LDoc. xmllint can be
replaced with any XML parser that understands *.xsd.
=== Build package
Navigate to the source directory.
The source directory is where the distribution archive was unpacked to, where
the repository was cloned to, or where the add-on was already installed to.
The build is done with `make` utility. All example commands assume it's
installed.
Validate Lua snippets for sanity. Requires `luacheck`. The configuration is
loaded from `etc/luacheckrc.lua`.
----
make check-lua
----
Validate Blizzard UI XML snippets for sanity. Requires `xmllint`. The schema is
loaded from `etc/xml/FrameXML/UI.xsd`. The schema descriptor was exported from
the game client, version 3.3.5a.
----
make check-xml
----
Do both.
----
make check
----
Package a `*.zip` archive for redistribution. Requires `git`. More importantly,
it requires the project's source repository to be cloned. Therefore, it will
not work if the project's was obtained from a distribution archive.
----
make dist
----
Minimal effort was made to make the `Makefile` adhere to `GNUmakefile`
conventions.
Vladyslav Bondarenko <vladyslavbond@protonmail.com>
0.7.1 (unstable), 2024-01-27
Chorus is a graphical user interface extension for a popular video game World
of Warcraft. It adds a custom raid frame. This is a work in progress.
Features:
- approximate distance to every raid member in yards;
- sort debuffs by relevance;
- generalize raid and party frames;
Supported game version is legacy 3.3.5a (or interface 30300).
The motivation is to create a robust minimalistic raid frame. It must work
out-of-the-box and require no configuration by the user. It must be comparable
in it's features with modern native raid frame that was shipped with the game
since Cataclysm expansion (interface 40000).
This add-on will never feature key binding customization. This feature is
specifically excluded to be the subject of a different add-on.
== Install
The project is installed like any other World of Warcraft add-on. Exit the
game. Unpack the archive that contains the project's sources into
`${DESTDIR}/Interface/AddOns/` directory, where `${DESTDIR}` is the path to the
game installation directory. In the end it must look something like this.
----
Interface/Addons/chorus/
Interface/Addons/chorus/bin/
Interface/Addons/chorus/etc/
Interface/Addons/chorus/share/
Interface/Addons/chorus/src/
Interface/Addons/chorus/README.adoc
Interface/Addons/chorus/chorus.toc
----
Experienced users may install the add-on with `git`.
----
git clone --branch master https://rocketgit.com/user/vrtc/chorus "${gamedir}/Interface/AddOns/chorus"
----
== Development
=== Build dependencies
The project does not require any building steps to work. It can be freely
distributed as sources only. However, the project was developed using certain
tools that may still be applicable.
Build dependencies:
- luacheck (static analysis for Lua);
- xmllint (XML validator);
- luarocks (packaging and project management for Lua);
- ldoc (generate technical documentation from Lua sources);
==== Build dependencies for Debian 12
Install build dependencies for Debian 12.
----
apt-get install libxml2-utils lua-check lua-ldoc make git
----
==== Build dependencies for Windows
Insalling for Windows is much more tricky. The first step is to install
LuaRocks, then use LuaRocks to install LuaCheck and LDoc. xmllint can be
replaced with any XML parser that understands *.xsd.
=== Build package
Navigate to the source directory.
The source directory is where the distribution archive was unpacked to, where
the repository was cloned to, or where the add-on was already installed to.
The build is done with `make` utility. All example commands assume it's
installed.
Validate Lua snippets for sanity. Requires `luacheck`. The configuration is
loaded from `etc/luacheckrc.lua`.
----
make check-lua
----
Validate Blizzard UI XML snippets for sanity. Requires `xmllint`. The schema is
loaded from `etc/xml/FrameXML/UI.xsd`. The schema descriptor was exported from
the game client, version 3.3.5a.
----
make check-xml
----
Do both.
----
make check
----
Package a `*.zip` archive for redistribution. Requires `git`. More importantly,
it requires the project's source repository to be cloned. Therefore, it will
not work if the project's was obtained from a distribution archive.
----
make dist
----
Minimal effort was made to make the `Makefile` adhere to `GNUmakefile`
conventions.
Hints:
Before first commit, do not forget to setup your git environment:
Clone this repository using HTTP(S):
Clone this repository using ssh (do not forget to upload a key first):
Clone this repository using git:
You are allowed to anonymously push to this repository.
This means that your pushed commits will automatically be transformed into a merge request:
Before first commit, do not forget to setup your git environment:
git config --global user.name "your_name_here"
git config --global user.email "your@email_here"
git config --global user.email "your@email_here"
Clone this repository using HTTP(S):
git clone https://rocketgit.com/user/vrtc/chorus
Clone this repository using ssh (do not forget to upload a key first):
git clone ssh://rocketgit@ssh.rocketgit.com/user/vrtc/chorus
Clone this repository using git:
git clone git://git.rocketgit.com/user/vrtc/chorus
You are allowed to anonymously push to this repository.
This means that your pushed commits will automatically be transformed into a merge request:
... clone the repository ...
... make some changes and some commits ...
git push origin main
... make some changes and some commits ...
git push origin main
RocketGit
Rocket your launch!
Rocket your launch!