User Tools

Site Tools


cre:compiling

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
cre:compiling [2021/10/26 11:48]
draugthewhopper [Windows]
cre:compiling [2024/03/20 01:07] (current)
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 ===== 
 + 
 +You will need Qt5 and its associated development package. 
 + 
 +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 
 +   
 +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
  
-=== Ubuntu 18.04 LTS (Bionic Beaver) === 
  
-  qt5-qmake qt5-qmake-bin qt5-default qtcreator 
 ====== 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 49: 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.
Line 62: Line 363:
 Get ''​arch''​ and ''​maps'',​ and put them into ''​share''​. Get ''​arch''​ and ''​maps'',​ and put them into ''​share''​.
  
-One way is to get a snapshop ​from Sourceforge,​ available [[https://​sourceforge.net/​p/​crossfire/​crossfire-maps/​ci/​master/​tarball?​path=|for maps]] and [[https://​sourceforge.net/​p/​crossfire/​crossfire-arch/​ci/​master/​tarball?​path=|for arch]].+One way is to get a snapshot ​from Sourceforge,​ available [[https://​sourceforge.net/​p/​crossfire/​crossfire-maps/​ci/​master/​tarball?​path=|for maps]] and [[https://​sourceforge.net/​p/​crossfire/​crossfire-arch/​ci/​master/​tarball?​path=|for arch]].
  
 Another option is to clone the git repositories so you can easily push your changes upstream. ​ Another option is to clone the git repositories so you can easily push your changes upstream. ​
cre/compiling.1635266898.txt.gz · Last modified: 2021/10/26 11:48 by draugthewhopper