This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
cre:compiling [2022/06/13 17:47] leaf Update CRE package requirements (qttools5-dev-tools) for Ubuntu Jammy |
cre:compiling [2024/03/20 01:07] leaf [Requirements] Requirements wording updates |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | To build CRE, you first need to [[:server:server_compiling|build the server]] and install it (''make install'' if running under Linux). | + | ====== CRE (Crossfire Resource Editor) ====== |
- | CRE sources are part of the server sources. | ||
- | ====== Requirements ====== | + | To build CRE, you first need to [[:server:server_compiling|build the server]] and install it (''sh autogen.sh && make install'' if running under Linux). |
- | You need Qt5 and the associated development package. | + | |
- | Depending on your system, installing ''qt5-default'' may be enough. | + | The sources for CRE are included in the server sources. |
- | ==== Distribution Specific Requirements ==== | + | ===== Requirements ===== |
- | === Ubuntu 18.04 LTS (Bionic Beaver) === | + | You will need Qt5 and its associated development package. |
- | qt5-qmake qt5-qmake-bin qt5-default qtcreator | + | Depending on your system, simply installing ''qmake'' or ''qt5-default'' may suffice. |
+ | |||
+ | ===== Distribution Specific Requirements ===== | ||
+ | |||
+ | ==== Arch Linux ==== | ||
+ | FIXME - Placeholder text | ||
+ | |||
+ | ==== Debian ==== | ||
+ | |||
+ | ==== Debian 10 (Buster) ==== | ||
+ | |||
+ | A quick reference for Debian 10 (Buster) | ||
+ | |||
+ | sudo apt install qttools5-dev qttools5-dev-tools qtscript5-dev | ||
| | ||
- | === Ubuntu 20.04 LTS (Jammy Jellyfish) === | + | Instructions creation date: 2024-February-29 |
+ | |||
+ | Last tested date: 2024-February-29 | ||
+ | ==== Debian 11 (Bullseye) ==== | ||
+ | |||
+ | A quick reference for Debian 11 (Bullseye) | ||
+ | |||
+ | sudo apt install qttools5-dev qttools5-dev-tools qtscript5-dev | ||
+ | |||
+ | Instructions creation date: 2024-February-29 | ||
+ | |||
+ | Last tested date: 2024-February-29 | ||
+ | |||
+ | ==== Debian 12 (Bookworm) ==== | ||
+ | |||
+ | A quick reference for Debian 12 (Bookworm) | ||
+ | |||
+ | sudo apt install qttools5-dev qttools5-dev-tools qtscript5-dev | ||
+ | |||
+ | Instructions creation date: 2024-February-29 | ||
+ | |||
+ | Last tested date: 2024-February-29 | ||
+ | |||
+ | ==== Devuan ==== | ||
+ | |||
+ | ==== Devuan Chimaera 4.0 ==== | ||
+ | |||
+ | A quick reference for Devuan Chimaera 4.0 | ||
+ | |||
+ | sudo apt install qttools5-dev qttools5-dev-tools qtscript5-dev | ||
+ | |||
+ | Instructions creation date: 2024-February-29 | ||
+ | |||
+ | Last tested date: 2024-February-29 | ||
+ | |||
+ | ==== Devuan Daedalus 5.0 ==== | ||
+ | |||
+ | A quick reference for Daedalus 5.0 | ||
+ | |||
+ | sudo apt install qttools5-dev qttools5-dev-tools qtscript5-dev | ||
+ | |||
+ | Instructions creation date: 2024-March-01 | ||
+ | |||
+ | Last tested date: 2024-March-01 | ||
+ | |||
+ | |||
+ | ==== Fedora ==== | ||
+ | |||
+ | ==== Fedora 37 ==== | ||
+ | |||
+ | A quick reference for Fedora 37 | ||
+ | |||
+ | sudo dnf install qt5-qtbase-devel qt5-qttools-devel | ||
+ | |||
+ | Instructions creation date: 2024-March-02 | ||
+ | |||
+ | Last tested date: 2024-March-02 | ||
+ | |||
+ | ==== Fedora 38 ==== | ||
+ | |||
+ | A quick reference for Fedora 38 | ||
+ | |||
+ | sudo dnf install qt5-qtbase-devel qt5-qtscript-devel qt5-qttools-devel | ||
+ | |||
+ | Instructions creation date: 2024-March-02 | ||
+ | |||
+ | Last tested date: 2024-March-02 | ||
+ | |||
+ | ==== Fedora 39 ==== | ||
+ | |||
+ | A quick reference for Fedora 39 | ||
+ | |||
+ | sudo dnf install qt5-qtbase-devel qt5-qtscript-devel qt5-qttools-devel | ||
+ | |||
+ | Instructions creation date: 2024-March-02 | ||
+ | |||
+ | Last tested date: 2024-March-02 | ||
+ | |||
+ | ==== Linux Mint ==== | ||
+ | |||
+ | ==== Linux Mint 20 (Ulyana) ==== | ||
+ | |||
+ | A quick reference for Linux Mint 20 (Ulyana) | ||
+ | |||
+ | sudo apt install qttools5-dev qttools5-dev-tools qtscript5-dev | ||
+ | |||
+ | Instructions creation date: 2024-March-03 | ||
+ | |||
+ | Last tested date: 2024-March-03 | ||
+ | |||
+ | ==== Linux Mint 20.1 (Ulyssa) ==== | ||
+ | |||
+ | |||
+ | A quick reference for Linux Mint 20.1 (Ulyssa) | ||
+ | |||
+ | sudo apt install qttools5-dev qttools5-dev-tools qtscript5-dev | ||
+ | |||
+ | Instructions creation date: 2024-March-06 | ||
+ | |||
+ | Last tested date: 2024-March-06 | ||
+ | |||
+ | |||
+ | ==== Linux Mint 20.2 (Uma) ==== | ||
+ | |||
+ | A quick reference for Linux Mint 20.2 (Uma) | ||
+ | |||
+ | sudo apt install qttools5-dev qttools5-dev-tools qtscript5-dev | ||
+ | |||
+ | Instructions creation date: 2024-March-06 | ||
+ | |||
+ | Last tested date: 2024-March-06 | ||
+ | |||
+ | ==== Mint 20.3 (Una) ==== | ||
+ | |||
+ | A quick reference for Linux Mint 20.3 (Una) | ||
+ | |||
+ | sudo apt install qttools5-dev qttools5-dev-tools qtscript5-dev | ||
+ | |||
+ | Instructions creation date: 2024-March-06 | ||
+ | |||
+ | Last tested date: 2024-March-06 | ||
+ | |||
+ | ==== Linux Mint 21 (Vanessa) ==== | ||
+ | |||
+ | A quick reference for Linux Mint 21 (Vanessa) | ||
+ | |||
+ | sudo apt install qt5-qmake qt5-qmake-bin qttools5-dev qttools5-dev-tools qtbase5-dev qtscript5-dev | ||
+ | |||
+ | Instructions creation date: 2024-March-06 | ||
+ | |||
+ | Last tested date: 2024-March-06 | ||
+ | |||
+ | ==== Linux Mint 21.1 (Vera) ==== | ||
+ | |||
+ | A quick reference for Linux Mint 21.1 (Vera) | ||
+ | |||
+ | sudo apt install qt5-qmake qt5-qmake-bin qttools5-dev qttools5-dev-tools qtbase5-dev qtscript5-dev | ||
+ | |||
+ | Instructions creation date: 2024-March-06 | ||
+ | |||
+ | Last tested date: 2024-March-06 | ||
+ | |||
+ | ==== Linux Mint 21.2 (Victoria) ==== | ||
+ | |||
+ | A quick reference for Linux Mint 21.2 (Victoria) | ||
+ | |||
+ | sudo apt install qt5-qmake qt5-qmake-bin qttools5-dev qttools5-dev-tools qtbase5-dev qtscript5-dev | ||
+ | |||
+ | Instructions creation date: 2024-March-07 | ||
+ | |||
+ | Last tested date: 2024-March-07 | ||
+ | |||
+ | ==== Linux Mint Debian Edition ==== | ||
+ | |||
+ | A quick reference for Linux Mint Debian Edition | ||
+ | |||
+ | sudo apt install qt5-qmake qt5-qmake-bin qttools5-dev qttools5-dev-tools qtbase5-dev qtscript5-dev | ||
+ | |||
+ | Instructions creation date: 2024-March-07 | ||
+ | |||
+ | Last tested date: 2024-March-07 | ||
+ | |||
+ | ==== Manjaro ==== | ||
+ | |||
+ | ==== Manjaro 23.1.3 (Vulcan) ==== | ||
+ | |||
+ | A quick reference for Manjaro 23.1.3 (Vulcan) | ||
+ | |||
+ | sudo pacman -S qt5-script | ||
+ | |||
+ | Instructions creation date: 2024-March-08 | ||
+ | |||
+ | Last tested date: 2024-March-08 | ||
+ | |||
+ | ==== OpenSUSE ==== | ||
+ | |||
+ | ==== OpenSUSE Leap 15.5 ==== | ||
+ | |||
+ | IMPORTANT: CRE will not compile on OpenSuse 15.5, see bug [[https://sourceforge.net/p/crossfire/bugs/955/|CRE compile failure with OpenSUSE (QtConcurrent related) ]] | ||
+ | |||
+ | A quick reference for OpenSUSE Leap 15.5 | ||
+ | |||
+ | sudo zypper install libqt5-qtbase-common-devel libqt5-qtscript-devel libqt5-qttools-devel | ||
+ | |||
+ | Instructions creation date: 2024-March-08 | ||
+ | |||
+ | Last tested date: 2024-March-09 | ||
+ | |||
+ | |||
+ | ==== OpenSUSE Tumbleweed ==== | ||
+ | |||
+ | IMPORTANT: CRE will not compile on OpenSuse Tumbleweed, see bug [[https://sourceforge.net/p/crossfire/bugs/955/|CRE compile failure with OpenSUSE (QtConcurrent related) ]] | ||
+ | |||
+ | A quick reference for OpenSUSE Tumbleweed | ||
+ | |||
+ | sudo zypper install libqt5-qtbase-common-devel libqt5-qtscript-devel libqt5-qttools-devel | ||
+ | |||
+ | Instructions creation date: 2024-March-08 | ||
+ | |||
+ | Last tested date: 2024-March-09 | ||
+ | |||
+ | ==== Pop!_OS ==== | ||
+ | |||
+ | ==== Pop!_OS 22.04 LTS ==== | ||
+ | |||
+ | A quick reference for Pop!_OS 22.04 LTS | ||
+ | |||
+ | sudo apt install qtbase5-dev qt5-qmake qt5-qmake-bin qtscript5-dev qttools5-dev qttools5-dev-tools | ||
+ | |||
+ | Instructions creation date: 2024-March-10 | ||
+ | |||
+ | Last tested date: 2024-March-10 | ||
+ | |||
+ | |||
+ | ==== Pop!_OS 22.04 LTS (NVIDIA) ==== | ||
+ | |||
+ | A quick reference for Pop!_OS 22.04 LTS (NVIDIA) | ||
+ | |||
+ | sudo apt install qtbase5-dev qt5-qmake qt5-qmake-bin qtscript5-dev qttools5-dev qttools5-dev-tools | ||
+ | |||
+ | Instructions creation date: 2024-March-10 | ||
+ | |||
+ | Last tested date: 2024-March-10 | ||
+ | |||
+ | ==== Ubuntu ==== | ||
+ | |||
+ | |||
+ | ==== Ubuntu 20.04 LTS (Focal Fossa) ==== | ||
+ | |||
+ | A quick reference for Ubuntu 20.04 LTS (Focal Fossa) | ||
+ | |||
+ | sudo apt install qtbase5-dev qt5-qmake qt5-qmake-bin qtscript5-dev qttools5-dev qttools5-dev-tools | ||
+ | |||
+ | Instructions creation date: 2024-March-11 | ||
+ | |||
+ | Last tested date: 2024-March-11 | ||
+ | |||
+ | ==== Ubuntu 22.04 LTS (Jammy Jellyfish) ==== | ||
+ | |||
+ | A quick reference for Ubuntu 22.04 LTS (Jammy Jellyfish) | ||
+ | |||
+ | sudo apt install qtbase5-dev qt5-qmake qt5-qmake-bin qtscript5-dev qttools5-dev qttools5-dev-tools | ||
+ | |||
+ | Instructions creation date: 2024-March-11 | ||
+ | |||
+ | Last tested date: 2024-March-11 | ||
+ | |||
+ | ==== Ubuntu 23.10 (Mantic Minotaur) ==== | ||
+ | |||
+ | |||
+ | A quick reference for Ubuntu 23.10 (Mantic Minotaur) | ||
+ | |||
+ | sudo apt install qttools5-dev qttools5-dev-tools qtscript5-dev | ||
+ | |||
+ | Instructions creation date: 2024-February-29 | ||
+ | |||
+ | Last tested date: 2024-March-11 | ||
- | qt5-qmake qt5-qmake-bin qttools5-dev-tools | ||
====== Building ====== | ====== Building ====== | ||
===== Linux ===== | ===== Linux ===== | ||
- | Once the server has been built and installed (with ''./configure && make install''), from the server sources root: | + | Once the server has been built and installed (i.e., by running ''sh autogen.sh && make install''), navigate to the ''utils'' directory from the server source root. |
- | ''cd utils/cre && qmake && make'' | + | cd utils |
- | Make sure to use qmake from Qt version 5, and not a previous version. On Fedora for instance, you need to run ''qmake-qt5'' | + | Check you are in the correct directory with the ''pwd'' command: |
- | ''cd utils/cre && qmake-qt5 && make'' | + | $ pwd |
+ | /home/<username>/crossfire-crossfire-server/utils | ||
- | This should build the tool, to run it: | + | The first compilation step depends on the version of QT installed and the Linux distribution being used. Here are some guidelines: |
- | ''utils/cre/cre'' | + | For Debian, Devuan, Linux Mint, PopOS, and Ubuntu: |
- | should do the trick. | + | qmake |
+ | |||
+ | For Fedora and Manjaro: | ||
+ | |||
+ | qmake-qt5 | ||
+ | |||
+ | The ''qmake'' or ''qmake-qt5'' command usually executes quickly and only displays output if there is an issue. | ||
+ | |||
+ | Next, execute the ''make'' command. This process may take up to 5 minutes or more and can output over 300 lines of text. Any alerts or warnings can generally be ignored during this process. | ||
+ | |||
+ | make | ||
+ | |||
+ | Once the compilation process is complete, change directory to ''cre''. | ||
+ | |||
+ | Verify your location using the ''pwd'' command: | ||
+ | |||
+ | $ pwd | ||
+ | /home/<username>/crossfire-crossfire-server/utils/cre | ||
+ | |||
+ | To run CRE, enter: | ||
+ | |||
+ | ./cre | ||
+ | |||
+ | Alternatively, you can launch CRE from your home directory using: | ||
+ | |||
+ | ./crossfire-crossfire-server/utils/cre/cre | ||
===== Windows ===== | ===== Windows ===== | ||
Line 53: | Line 346: | ||
CRE standalone is available from [[http://crossfire.weeger.org/cre-latest.exe|this direct link]] (make sure to check the [[http://crossfire.weeger.org/cre-latest.exe.sha512|sha512 sum]]). | CRE standalone is available from [[http://crossfire.weeger.org/cre-latest.exe|this direct link]] (make sure to check the [[http://crossfire.weeger.org/cre-latest.exe.sha512|sha512 sum]]). | ||
+ | |||
+ | FIXME - are the manual setup steps listed below still required with the current .exe installer? | ||
After putting the ''.exe'' in the directory of your choice, you need to assemble a few prerequisites before it will run: | After putting the ''.exe'' in the directory of your choice, you need to assemble a few prerequisites before it will run: | ||
+ | |||
+ | FIXME - Discord/IRC discussion indicates, "CRE expects cre's dir/var/{arch,maps}" - is this still correct? | ||
First, create a directory alongside the .exe, named ''share''. Get the ''i18n'' directory from the server source (it's in ''[[https://sourceforge.net/p/crossfire/crossfire-server/ci/master/tree/lib/i18n/|lib\i18n]]'') and place it here too. | First, create a directory alongside the .exe, named ''share''. Get the ''i18n'' directory from the server source (it's in ''[[https://sourceforge.net/p/crossfire/crossfire-server/ci/master/tree/lib/i18n/|lib\i18n]]'') and place it here too. |