diegoulloao / ioquake3-mac-install

install ioquake3 on macOs in one command (apple silicon support)

---

Important

This is an unofficial ioquake3 version.

Please do not report issues in the ioquake3 official repository. This project is not related to them and is totally independent.

 apple silicon support

👉 Check the hq screenshots page 😍

Requirements 📋

• macOs version 10.9 or later
• Compatible with arm64 and x64/32 processors

Installation ✨

ioquake3 for macOs is installed by running 1 command:

curl -L git.io/ioq3mac | sh

This is an Universal compilation and it will work for both arm64 and x64/32 processors.

Updating ⚡

The binary file included here was compiled based on a specific commit from the ioquake3 official repository.

For update your current ioquake3 executable to the latest version please run:

curl -L bit.ly/ioq3mac-u | sh

Read more about the compilation

---

A version file must be present locally in your base installation directory. This file is automatically generated after the installation and contains the commit hash on which the compilation is based.

Tip: Adding an alias for updating to the system 💡

Alternatively you can add an alias to .bashrc or .zshrc:

alias @q3u="curl -L bit.ly/ioq3mac-u | sh"

Then is available for use:

@q3u

Uninstalling ⭕

The following command will remove all the files:

rm -rf ~/Library/Application\ Support/Quake3 /Applications/ioquake3

Adding extras 🚀

Open the folder and add your files in:

open ~/Library/Application\ Support/Quake3

Tip: Adding an alias to the system 💡

Alternatively you can add an alias to .bashrc or .zshrc:

alias @q3f="open ~/Library/Application\ Support/Quake3"

Then is available for use:

@q3f

Packages 📦

All packages and improvements are listed here:

package	description
ioquake3 for macOs	Quake3 arena (improved engine) for macOs
ioquake3 latest pk3 files	Latest pk3 files (point release patches)
NEW CPMA 1.53	Challenge pro mode arena mod v1.53
CPMA Map Pack	Set of maps and dependencies for CPMA
High Resolution Textures Pack	High resolution textures
Complementary HQ Textures	Complementary textures in high quality
Quake 3 Live Sounds Pack	Quake3 live audios + high quality sounds
NEW Quake 3 HD Weapons	Quake3 new 2019 weapons re-textures
NEW Quake 3 Weapons Replacements	Replacements for RL, RG and GL weapons

Information 💎

Last Update: 2023/12/18

The ioquake3 app included here was compiled directly from the ioquake3 source code repository.

It includes commits to date Nov. 22, 2023.

"OpenGL2: Fix updating the loading screen with r_cubeMapping 1"

Troubleshooting ⚡️

1. ioquake3.app can't be opened

You may face this warning:

ioquake3.app can't be opened because it is from an unidentified developer

Open Privacy and Settings:

System Preferences > Security & Privacy Settings

And click the button "open anyway".

Read more about: http://support.apple.com/kb/HT5290

---

2. fullscreen does not fill the screen

Try running the following commands inside the quake3 console:

/seta r_customwidth "screen_width"
/seta r_customheight "screen_height"
/seta r_fullscreen "1"
/seta r_mode "-1"
/vid_restart

Q&A ❔

What is this?

ioquake3-mac-install pretends to be the one unified and most simply way to install quake3 arena on mac computers. This includes a lot of improvements like high quality textures, improved sounds, most knowed mods, etc.

---

What is the ioquake3 engine?

Please visit: https://ioquake3.org/

Development 💻

You can visit my personal website: https://diegoulloa.dev/

Related projects 🔥

ioquake3-server-gcloud

"The fastest way to deploy your own ioquake3 server using docker, kubernetes and google cloud". https://github.com/diegoulloao/ioquake3-server-gcloud

Deploy a quake3 server to Google Cloud in 1 command!

Licence 📄

Licensed MIT: LICENSE

---

diegoulloao · 2024

ioquake3-mac-install's Issues

ioquake3fe.app is still flagged as 32-bit application

Hi. I noticed you guys updated the ioquake3-1.36.app to 64-bits which is great for Catalina, and also works great on Mojave. Although, the config app ioquake3fe-1.36.app is still flagged as 32-bits on Mojave. I haven't updated to Catalina yet, many 32-bits without a proper update yet are on my end, but the two new apps you just posted work well on Mojave.

Any ETA for the config app?

Thanks and great work!

Please rename your repository to anything besides ioquake3 or at least call it unofficial

Hi, we sometimes hear from users that have issues and use your version of ioquake3. Please mark it as "unofficial" or rename it especially as you are distributing a pirated copy of Quake 3's pak0.pk3 which we do not condone.

Installed. Now, how to run it?

I've installed it by running curl -L git.io/ioq3mac | sh

How can I play now?
Couldn't find anything about it on the docs.

MacOS catalina support

Hi,

The new MacOS cataline upgrade won't support 32 bit apps. It is possible to the script install a 64 bit version?

After 30 min of trying i give up

Please tell me how to run it because i tried everything i know and no result i sound so stupid but it got really annoying

One missing piece on README

How to execute?!

Btw, congrats on the awesome repo!

ioquake3 and security?

Hi,

I was just wanting to find out about your repo and how it's affected with the news regarding ioquake3 being compromised by crypto miners?

Source: https://ioquake3.org/news/

As an initial notice, I want to warn ioquake3 players and server operators that precompiled test builds downloaded from our website may have been compromised. Please do not use or run an ioquake3 test build until we provide new builds for download. This post will be updated and a new notice will be provided on this site. ioquake3 builds compiled from source or provided by distributions should be safe to use so long as they did not redistribute our test build binaries. I have no evidence that the ioquake3 test builds were compromised but I am alerting the community out of an abundance of caution.

Should we be concerned running / installing your repo?

Thanks,
Alex

The player doesn't run/walk forward

Whatever key I bind for the run/walk command, I just don't move forward. I've quickly started a new game as soon as I installed, chose a map, added a bot and... it doesn't move forward. Left, right, jump, crouches, shoot - everything is alright. I've restarted numerous times both the game and the computer. Re-installed it a couple of times. I've also tried binding a ton of other keys to see maybe something is wrong with my keyboard. Everything is fine. It may seem like a joke, but as far as you can see, I've got plenty of "w", "e", "r", "t" so you know my keyboard actually works.

Can't get cl_allowdownload to work

Server is running a custom map and has sv_dlURL configured. cl_allowdownload works fine when connecting using ioquake for windows but download doesn't appear to work while using cl_allowdownload 1 on Mac Catalina.

Console log shows the map is missing from the baseq3 directory and then throws an error because the map was missing. On Windows ioquake3 uses cURL to download the map (based on the sv_dlURL set on the server) and successfully loads the map.

Any ideas?

Installation failed, cannot find xcsv_hires.zip

Hello Diego!

First of all thank you very much for your great and easy Quake 3 installer.

After a fresh install of Mojave on my MacBookPro 6,1 the installation unfortunately failed:

End-of-central-directory signature not found. Either this file is not
a zipfile, or it constitutes one disk of a multi-part archive. In the
latter case the central directory and zipfile comment will be found on
the last disk(s) of this archive.
unzip: cannot find zipfile directory in one of xcsv_hires.zip or
xcsv_hires.zip.zip, and cannot find xcsv_hires.zip.ZIP, period.

Getting error sh: line 69: cd: __MACOSX: No such file or directory

On a Mid 2010 27" iMac with 10.13.6 I get the error: sh: line 69: cd: __MACOSX: No such file or directory

"cd.." command not found

d349777#diff-20488634e978ccd1f9f7c7daf1e75300R19

Should be cd ...

Team Arena (Missionpack)

Would you be interested in adding TA? I have the packs and it works perfectly on MacOS M1.

Defrag mode

I remember from the old days I used to play defrag mode maps and it was very challenging, besides the fact that every map in that mode shipped with a couple of demos of pro's smashing the living crap out of that maps in record timings, I would love this mode to be a part of quake gameplay.

curl: (35) Unknown SSL protocol error in connection to cdn.playmorepromode.com:443

Hi,

I'm getting this error when trying to install ioquake3 with the provided command:

---

Downloading CPMA Map-Pack ...

---

% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
0 0 0 0 0 0 0 0 --:--:-- 0:01:06 --:--:-- 0curl: (35) Unknown SSL protocol error in connection to cdn.playmorepromode.com:443

Is there a known solution/workaround?