This repository has been archived on 2023-09-02. You can view files and clone it, but cannot push or open issues or pull requests.
csh/GUIDE.md

55 lines
1.8 KiB
Markdown

# Easy steps to add a cheat to this app:
1. Create a file in [the cheat directory](./cheats/)
2. Create a class that inherits from `Hack`:
```python
from hack import Hack
class Mycheat(Hack):
def __init__(self, **kwargs) -> None:
super().__init__(**kwargs)
# Here you can initialize global variables for your cheat
```
3. Add the method who will contains the cheat logic, note that:
- Your method must contains a sub-method and must be added to
the `hackloop` at the end of the method (see example below)
```python
def mycheat(self) -> None:
# Cheat initialization, will only run once
def cheat():
# Your cheat logic, will be looped
# Setting up the loop
self.hack_loop(cheat)
```
4. If you need to unload something before closing the app (e.g. restore the
initial state of something), you can add a second method called
`MYCHEAT_unload` with `MYCHEAT` the same name as the previous method
```python
def mycheat_unload(self) -> None:
# Called when the app is closed
```
5. For more examples, see [the cheats already done](./cheats/)
6. If your cheat logic modifies the same memory of another cheat at the same
time, then add that cheat to the list of incompatibilities in [cheat](./cheat.py)
after the `Incompatible cheats` comment. Add only one entry for your cheat,
it will automatically propagate to the other ones
## Extra infos
- `self.pm` is used to read/write memory
- `self.offsets` contains a list of offsets
- `self.find_module` finds a module (`.dll`)
- `self.find_uint` always returns something (blocking thread)
- You can always add time between each loop call by calling `sleep`
- See the [utils](./utils.py) file if you need more tools, like a vector class,
colour etc.
- If needed, feel free to add your own offsets to the `self.offsets` variable