setup guide for etlegacy development with CLion

[mittermichal]

I just managed to setup etlegacy in CLion on MacBook, but it was a bit challenging and I would like to create some guide/tips on how to do it. Also it can be discussed here how it could be improved. I don't know where to place such info. Put it directly in readme or create separate md and reference it from readme?

I came up with these steps:

1. clone etlegacy git repository
2. cd etlegacy
3. git submodule init && git submodule update - clone bundled libraries
4. open folder as project in CLion
5. in Open Project Wizard CMake Options add:

• -DFEATURE_AUTOUPDATE=OFF - disables update prompt on start
• -DINSTALL_WOLFADMIN=OFF - disable unless you want to work with wolfadmin
• -DINSTALL_GEOIP=OFF - IP geolocation is generally not needed for development
• for macOS: -DCMAKE_OSX_ARCHITECTURES=arm64 or -DCMAKE_OSX_ARCHITECTURES=x86_64 for Intel processor
• for more options check easybuild.sh

7. Set Build directory to build
8. add +set fs_homepath CUSTOM_HOMEPATH I have chosen /Users/xmitter/Library/Application Support/etlegacy-dev
9. Optional: set ui_disableOssFilter 1 in client console. This is only needed to see the locally built server in server browser. Not needed if you are on win_x86 or linux_x86. Another option is to do echo "macos_aarch64" > CUSTOM_HOMEPATH/platforms.manifest for macOS arm64. Other platforms are in q_oss.h > oss_str[]
10. Link pak0 from installation:

• In Run/Debug Configurations add New configuration -> Shell script,
• name: link pak0
• choose script text
• Script text: mkdir -p build/etmain && ( ls build/etmain/pak0.pk3 || ln -s <ABSOLUTE_PATH_TO_ET_INSTALLATION>/etmain/pak0.pk3 ) - will create symbolic link to reuse already installed pak0.pk3 from your existing ET installation. On macOS: /Applications/ETLegacy build/etmain/pak0.pk3

11. Add run dependencies for running etl client. Edit etl run configuration, in "Before launch" section:

• click on "Add" -> "CMake Target" -> "All targets"
• again click on "Add" -> "Run another configuration" -> "link pak0"

12. Optional: do the same as in previous step and step 8. for etlded configuration if you want to run dedicated server
13. try to run etl configuration. ET:Legacy client should start and with profile creation form.
14. when debugging client on linux, run setxkbmap -option grab:break_actions;xdotool key XF86Ungrab in terminal after a breakpoint is hit to free up mouse cursor

On windows it could be different. @Helldembez have set this up there before.

I'm not sure about step 10. maybe there some nicer way.