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
Next revision Both sides next revision
cre:compiling [2021/10/26 11:48]
draugthewhopper [Windows]
cre:compiling [2024/03/20 01:06]
leaf [CRE (Crossfire Resource Editor)] Intro text update
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). 
 + 
 +The sources for CRE are included in the server sources. 
 + 
 +===== Requirements ===== 
 You need Qt5 and the associated development package. You need Qt5 and the associated development package.
  
 Depending on your system, installing ''​qt5-default''​ may be enough. Depending on your system, installing ''​qt5-default''​ may be enough.
  
-==== Distribution Specific Requirements ====+===== 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.txt · Last modified: 2024/04/26 16:58 by leaf