An open API service indexing awesome lists of open source software.

https://github.com/captainzero93/ahk-cs2-null-movement-snap-tap-socd


https://github.com/captainzero93/ahk-cs2-null-movement-snap-tap-socd

Last synced: 3 months ago
JSON representation

Awesome Lists containing this project

README

          

# This type of automated movement is now banned on FACEIT and Valve official servers and serves only as an archive.

# Null Movement, "Snap Tap" SOCD Script (CS2) (AHK2) (EXE)

Edit: A self contained compiled portable .exe is now in the release section! Now AHK2 doesnt need to be installed.
Pretext: I do not cheat but I made this to practice programming and level the playing field for people who cant afford the new keyboards. This functionality as of writing is NOT considered cheating neither is AHK a VAC bannable process.

## Features
- **Snap Tap Mode**: Prioritizes the last pressed key for instant direction changes.
- **SOCD (Simultaneous Opposite Cardinal Direction) Handling**: Prevents unintended movement cancellation when pressing opposing keys.
- **Configurable SOCD Cleaning**: Options for horizontal (Left+Right) movement handling. ( check the source code to adapt this )
- **Game-Specific Vertical SOCD**: Set for Counter-Strike style movement.
- **Performance Optimizations**: Code has been worked on to keep it as snappy as possible.

## Changelog
### v2.2.0 (2024-07-25)
- Updated vertical SOCD handling for Counter-Strike
- Added game-specific SOCD handling option
- Improved comments and documentation

### v2.1.0 (2024-07-25)
- Implemented proper SOCD handling
- Added configurable SOCD cleaning method for Left+Right inputs

### v2.0.0 (2024-07-25)
- Completely refactored the script for AutoHotkey v2.0
- Implemented Snap Tap behavior, prioritizing the last pressed key
- Added support for both horizontal (A/D) and vertical (W/S) movement
- Improved performance with various optimizations
- Simplified logic using functions and maps for better maintainability

### v1.0.0 (Original Version)
- Initial implementation of null movement script
- Basic WASD key management

## Installation
- Use the EXE from the release section or;

1. Ensure you have AutoHotkey v2.0 or later installed on your system. You can download it from the [official AutoHotkey website](https://www.autohotkey.com/).
2. Download the `CSNullInput.ahk` script from this repository.
3. Save the script to a location on your computer where you can easily access it.

## Usage
1. Double-click the `CSNullInput.ahk` file to run the script ( or compiled .exe ).
2. The script will run in the background, affecting your WASD key inputs.
3. To stop the script, right-click the AutoHotkey icon in your system tray and select "Exit".

## Configuration
You can modify the following variables in the script to customize its behavior:

- `horizontalSOCDMethod`: Set to "Neutral" for Left+Right = Neutral, or "Last Win" for Last Input Priority.
- `csgoStyle`: Set to true for Counter-Strike behavior (Up+Down = No movement), or false for traditional fighting game style (Up wins).

To change these settings:
1. Open the `CSNullInput.ahk` file in a text editor.
2. Locate the variables near the top of the script.
3. Modify the values as desired.
4. Save the file and restart the script for changes to take effect.

## Credits
- Original "null bind" AHK script credit to Qiasfah on Github, that provided the basis for everything else I added.

## Disclaimer
This script is an attempt to recreate features built into newer keyboards. It does not implement hardware-level actuation or rapid fire functionality. The script is designed to work within the bounds of what's typically allowed by game anti-cheat systems, but use at your own risk.

## Note on Fair Play
The maintainer acknowledges the ethical considerations of using such scripts:
- A previous version included functionality to stop stepping forward instantly when left click was pressed, but this was removed as it was deemed too close to specificly known forms of cheating.
- There are concerns about the future of hardware automation in competitive gaming, particularly if peripheral manufacturers create integrated keyboard-mouse systems.
- The question of where Valve (and other game developers) will draw the line on hardware automation remains open.

## Contributing
Contributions to improve the script are welcome. Submit a pull request with a description of your changes.

Please ensure your code adheres to the existing style and includes appropriate comments. Also, update the README if your changes add or modify functionality.

## License
This project is licensed under the MIT License.

- For the full license text, please see the [LICENSE](LICENSE) file in the repository.

## Support
If you encounter any issues or have questions about the script, please open an issue. While I'll do my best to address concerns, please understand that this is a community project maintained in free time.

## Reported Issies
From time to time a key such as "A" ar "D" may continue to be pressed, causing unwanted movement. Until this is fully resolved to remedy it in game hit the opposing key a few times and it should stop.