iOS Shortcuts - rebelancap/Quake3-iOS GitHub Wiki

Creating iOS Shortcuts for Quake 3

This guide will show you how to create home screen shortcuts that launch Quake 3 directly into vanilla or modded gameplay, bypassing the iOS menu.

Prerequisites

  • Quake 3 for iOS installed on your device
  • The Shortcuts app (comes pre-installed on iOS)
  • Game files (baseq3 folder) copied to the app's Documents folder
  • For mods: mod folders (like q3ut4, cpma, etc.) also copied to Documents

Creating a Vanilla Quake 3 Shortcut

  1. Open the Shortcuts app on your iPhone/iPad

  2. Tap the "+" button in the top right to create a new shortcut

  3. Add an action:

    • Tap "Add Action"
    • Search for "Open URLs"
    • Select it

  4. Set the URL:

    • In the URL field, type: quake3://vanilla
    • This will bypass @tomkidd's simplified frontend

  5. Name your shortcut:

    • Tap the settings icon (☰) at the top
    • Give it a name like "Quake 3 Vanilla"
    • Optionally choose an icon and color

  6. Add to Home Screen:

    • Still in settings, tap "Add to Home Screen"
    • Customize the name and icon if desired
    • Tap "Add"

Creating Mod Shortcuts

Urban Terror Example

  1. Follow steps 1-3 above
  2. For the URL, use: quake3://mod?mod=q3ut4
  3. Name it "Urban Terror"
  4. Add to Home Screen

Other Popular Mods

  • CPMA: quake3://mod?mod=cpma
  • Rocket Arena: quake3://mod?mod=arena
  • OSP: quake3://mod?mod=osp
  • Defrag: quake3://mod?mod=defrag
  • Excessive Plus: quake3://mod?mod=excessiveplus

Advanced: Launching Specific Maps

You can also create shortcuts that launch directly into specific maps:

Vanilla Maps

  • The Longest Yard: quake3://vanilla?map=q3dm17
  • Campgrounds: quake3://vanilla?map=q3dm6
  • The Edge: quake3://vanilla?map=q3dm7

Mod Maps

  • Urban Terror on Turnpike: quake3://mod?mod=q3ut4&map=ut4_turnpike
  • CPMA on CPM3: quake3://mod?mod=cpma&map=cpm3

Tips

  • Shortcut Names: Keep them short for better home screen appearance
  • Icons: You can use custom images for your shortcuts:
    1. In the shortcut settings, tap the icon
    2. Choose "Choose Photo" to use any image
    3. Search online for Quake 3 logos or mod logos
  • Organization: Create a folder on your home screen called "Quake 3" to organize all your shortcuts

Troubleshooting

Shortcut opens the app but doesn't bypass the menu:

  • Make sure you typed the URL exactly as shown (case-sensitive)
  • Ensure the app is fully closed before using the shortcut

Mod doesn't load:

  • Verify the mod folder exists in the app's Documents folder
  • Check that the folder name matches what you put after mod=
  • Mod folder names are case-sensitive

"Game Files Missing" error:

  • You need to copy the baseq3 folder to the app's Documents folder first
  • Use iTunes File Sharing or the Files app to copy game files

How It Works

These shortcuts use a custom URL scheme (quake3://) that the app recognizes. When you tap a shortcut, it tells the app to skip the iOS menu and launch directly into the specified game mode or mod.

Enjoy fragging with quick access to all your favorite Quake 3 experiences!