Description
Tired of stretching your left hand across the entire number row to switch weapons mid-fight? Or spamming one cycle button for 9 different weapons? This lightweight, clean AutoHotkey (AHK) script offers a more advanced approach to Jazz Jackrabbit 2 weapon swapping mechanics by grouping weapons into logical, easy-to-reach directional cycles right next to your movement keys.
It takes some practice for sure; it’s not a cheap way to get good overnight. But with time, you can get used to it and it can help you cycle through your weapons much more efficiently. Some players might not find it worth the effort compared to other methods of ammo cycling like key-binds with a mutator, and many are used to other setups that work just as well with the right practice (this for example: https://jj2multiplayer.com/guide/multiplayertutorial).
The script focuses purely on ergonomic weapon binds and utility features (such as automatically pausing while you type so the binds never get in the way of chatting + you can toggle it off/on with num lock + it's only activated when jazz.exe is opened and the script is opened). There are no turbo-fire, macro-climbing, or automation mechanics included, making it 100% clean, safe, and fair for competitive multiplayer play; especially since anyone can download it here on j2o now.
Key Features
-Dynamic Smart-Cycling: Weapons are bundled onto single keys (e.g., tap Z to cycle Blaster → Bouncer → Freezer).
-0.75s Idle Reset: If you switch weapons but stop pressing the cycle key for more than 750ms, the cycle resets back to its starting weapon. You will never get lost in your weapon order.
-Smart Window Context: The script detects the game. Binds are only active when you are in Jazz2.exe and automatically turn off when you Alt-Tab out.
-Anti-Chat Interference: Pressing T automatically pauses the script so you can type chat messages normally. Pressing Enter to send your message instantly re-enables your binds.
-Optional Autorun Swap: Easily swap CapsLock and Shift for a much more comfortable pinky placement when toggling Autorun on/off.
In-Game Key Bindings
When inside the game, your default number row is mapped to these comfortable clusters:
Key Action / Weapon Cycle
-Z Cycles Tier 1: Blaster (1) → Bouncer (2) → Freezer (3)
-X Cycles Tier 2: Seeker (4) ↔ RF Missile (5)
-S Direct shortcut straight to RF Missile (5)
-C Instant Select: Fire/ Toaster (6)
-RCtrl Cycles Tier 3: TNT (7) ↔ Pepper Spray (8)
-0 / Numpad0 Instant Select: Electro-blaster (9)
(Tip: Change your default weapon cycle button to A, that's what works for me at least)
How to Install and Run
-Download the Software: Download and install AutoHotkey v1.1 (deprecated but highly stable for older scripts) from the official website: https://www.autohotkey.com.
-Create the File: Right-click your desktop, select New → AutoHotkey Script.
-Add the Code: Right-click the newly created file, select Edit Script (or open with Notepad), delete everything inside, paste the script code, and save.
-Launch: Double-click the script file. A green "H" icon will appear in your Windows system tray, meaning it is running and waiting for you to launch Jazz 2!
Configuration Settings
You can customize the script by opening it in any text editor. Look at the top section for these values:
-global IdleResetTime := 750 — Change this number if you want more or less time (in milliseconds) before a weapon cycle resets back to weapon 1.
-global SwapKey := "" — Change this to global SwapKey := "Shift" if you want CapsLock to act as your physical Shift key (highly recommended for a more comfortable Run/Walk toggle layout).
Utility, by 
