https://github.com/ate47/t8-atian-menu
my mod menu for Black Ops 4/ColdWar with my notes for Call of Duty
https://github.com/ate47/t8-atian-menu
blackops4 blackout callofduty cold-war gsc-script multiplayer ps4 zombies
Last synced: 4 months ago
JSON representation
my mod menu for Black Ops 4/ColdWar with my notes for Call of Duty
- Host: GitHub
- URL: https://github.com/ate47/t8-atian-menu
- Owner: ate47
- License: mit
- Created: 2023-04-16T21:11:52.000Z (about 3 years ago)
- Default Branch: master
- Last Pushed: 2025-05-15T19:38:49.000Z (about 1 year ago)
- Last Synced: 2025-08-28T00:58:50.970Z (9 months ago)
- Topics: blackops4, blackout, callofduty, cold-war, gsc-script, multiplayer, ps4, zombies
- Language: GSC
- Homepage: https://ate47.github.io/t8-atian-menu/
- Size: 2.05 MB
- Stars: 29
- Watchers: 5
- Forks: 11
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Atian menu
[](https://www.youtube.com/user/wilate48) [](https://discord.gg/wNH73Sg) [](https://github.com/ate47)
[](https://github.com/ate47/t8-atian-menu/actions/workflows/compile.yml)
Mod menu and notes for T8 (Black Ops 4) and T9/VM38 (Black Ops Cold War). IF YOU HAVE ANY ISSUE READ THE [FAQ](#faq) FIRST.
Using the compiler: https://github.com/shiversoftdev/t7-compiler (Some required features might not be implemented yet)
Using the sources: https://github.com/ate47/bo4-source
- [Atian menu](#atian-menu)
- [FAQ](#faq)
- [Downloads](#downloads)
- [Posts](#posts)
- [Config](#config)
- [Features](#features)
- [Dev tools](#dev-tools)
- [Symbols](#symbols)
- [Color](#color)
- [Hash lookup](#hash-lookup)
- [Functions](#functions)
- [Create menu](#create-menu)
- [Key manager](#key-manager)
## FAQ
- `No test task to run found` -> You need to create a `.vscode/tasks.json` file, I do not ship it with the menu by default, you can copy the default one in the `default` directory, the .
- `something LAZYLINK` -> This menu is using experimental features that might not be implemented in your compiler, they are probably implemented my version of the [t8-compiler repo](https://github.com/ate47/t7-compiler) in the latest branch, you need to compile the compiler yourself. (I won't help on how to do it)
- `How to change the default map in blackout` -> You Can read the README or you can simply change it in the [`scripts/config/blackout.gsc`](scripts/config/blackout.gsc) file.
- Error `1670707254` -> Try to redownload the menu completly, otherwise you can create an issue [here](https://github.com/ate47/t8-atian-menu/issues/new?assignees=&labels=bug&projects=&template=bug.yml).
## Downloads
Here precompiled versions of my menu with predefined configs. You have to find how to inject them by yourself.
- [Black Ops 4 - PC](https://github.com/ate47/t8-atian-menu/releases/latest/download/BlackOps4_atianmenu_pc.gscc)
- [Black Ops 4 - PS4 1.26](https://github.com/ate47/t8-atian-menu/releases/latest/download/BlackOps4_atianmenu_ps4.gscc)
- [Black Ops Cold War - PC VM38](https://github.com/ate47/t8-atian-menu/releases/latest/download/BlackOpsColdWar_atianmenu_pc.gscc)
## Posts
Posts or videos I've made using these scripts, my notes or the sources:
- [Reddit - Stats for the care packages](https://www.reddit.com/r/Blackops4/comments/nhonhu/if_you_had_ever_wondered_the_probabilities_in_the/)
- [Blackout Quaknarok](https://www.youtube.com/watch?v=XphuwHYtSjk)
- [GSC Weapon tool](https://www.youtube.com/watch?v=hPBZrQQ7u4c)
- [Some changes of the Black Ops 4 Fandom](https://callofduty.fandom.com/wiki/Cut_Content/Call_of_Duty:_Black_Ops_4)
- [t8-custom-ee](https://github.com/ate47/t8-custom-ee) - A tool to enable EEs in custom mutations, offline or casual
- [atian-cod-tools](https://github.com/ate47/atian-cod-tools) - Some tools related to Call of Duty (with [bo4-source](https://github.com/ate47/bo4-source))
## Config
*No available in the precompiled builds*
If you don't want to use the menu and only use particular functions from the mod, you can set the value of `no_menu` to `true` in [scripts/config/global.gsc](scripts/config/global.gsc).
If the config function is empty, nothing will happen in game.
```c++
self.no_menu = true;
```
You can config the mod keys in the [`scripts/config/keys.gsc`](scripts/config/keys.gsc) file, by default you open it with ADS+Melee.
You can config the mod menu in the [`scripts/config`](scripts/config) directory, current tools:
- General
- Force character skin
- Force weapon camo
- Enable options at startup
- Set random skin and camo on bots
- Blackout
- Force mode
- Force map
- Spawn vehicles
- Set the zombies spawner types (brutus, avogadro or zombies)
- Spawn the Icarus (config)
- Quaknarok
- Set the health of the avogadro
- Spawn waterballons
- Spawn snowballs
- Zombies eyes
- Give items
- Multiplayer
- set draft time
- Give killstreaks
- Zombies
- Allow EEs in custom mutation
- Custom mutation like config to setup your own zombies
- Set XP multiplier
- Quaknarok
- Open narrative rooms
- Give perks
- Give powerups
(and others)
## Features
This tool can be paired with the [t8-custom-ee mod (PC)](https://github.com/ate47/t8-custom-ee/tree/main) to run EE in casual or offline, you don't need it for custom mutations.
- Tools
- 3rd person
- max ammo
- fly mode (+config for the speeds)
- no damage
- Kill all zombies
- max points (Zombies)
- max revive (Zombies)
- set zombies' speed (Zombies)
- set round (Zombies)
- ignore me (Zombies)
- End contracts (Zombies)
- Set XP multiplier (Zombies)
- Give weapons
- All base weapons + upgraded in zombies
- Killstreaks
- Wunderwaffe (BO3) (Zombies/Tag der Totten)
- Tempest/Minigun (BO3) (Multiplayer)
- Hell retriver, Waterballoons and Snowballs (Blackout)
- Spectre's Blade (Blackout)
- Prototypes and remnant from BO3
- Gun tool ([Demo](https://www.youtube.com/watch?v=hPBZrQQ7u4c))
- Drop weapon
- TP gun
- Rocket man
- Rocket gun
- Armageddon
- A10 rocket/minigun, Mantis rocket, Hellstorm rocket, Dart (MP)
- Elephant riders (IX)
- Gegenees shot (AE)
- Darts (BoTD)
- Nova shot (AO)
- Teleport tool
- Waypoint tp (Blackout) : TP using the map (need fix for the main map)
- tp to hot location in your map (wip, not all the maps are available)
- Loading
- set map
- set gametype
- Customization
- set characters
- Set character skin (+unreleased skin)
- set skin palette
- set skin warpaint
- set skin decals
- Set weapon camo
- Set weapon reticle
- Set weapon mastercraft
- Internal tools
- GSC system list (+ignored)
- Loaded EEs list (Zombies)
- Basic hash_lookup method
- Entity tp
## Dev tools
My notes are in the [notes](notes/) directory.
You also have a doc about the game itself in the [doc](doc/) directory.
Some features might require some modification on the t8-compiler, you can get them [here](https://github.com/ate47/t7-compiler) (search the latest branch).
### Symbols
You can config the compilation using these options:
- `-DATIAN_MENU_LOOKUP_BIG` : Big lookup structure in array explorer
- `-DATIAN_MENU_DEV` : Run my dev configs
### Color
Using `iprintln`: `^0`: red, `^1`: cyan, but only for the whole line.
Using `iprintlnbold`:
- `^0` black (hide)
- `^1` red
- `^2` green
- `^3` yellow
- `^4` blue
- `^5` cyan
- `^6` pink
- `^7` bright yellow
### Hash lookup
The `hash_lookup(hash_str)` function can be used to look for unhashed values, to add a string to this function,
add it to the [`lookup/lookup.txt`](lookup/lookup.txt) file and run the [`build_lookup.ps1`](shell_scripts/build_lookup.ps1) script. The array explorer tool is using the [`lookup/lookup_structs.txt`](lookup/lookup_structs.txt) file to search for structure elements.
If the lookup is too big, the game won't start.
You can explore CSV files from the game using the method `get_known_csv_files()` in [enums.gsc](scripts/enums/enums.gsc).
### Functions
```c++
// object type of obj
get_object_type(obj);
// iprintbold msg if the dev mod is activated
debugln(msg);
// test if the dev mod
is_dev_mode();
// test if we are in blackout
is_warzone();
// test if we are in zombies
is_zombies();
// test if we are in multiplayer
is_multiplayer();
// dynamic version of #ifdef _CSC
is_client();
// log message using compiler::nprintln or using the menu log system.
am_log(str);
```
### Create menu
The menu descriptions are usually put in the [`scripts/core_common/ui/menu_items.gsc`](scripts/core_common/ui/menu_items.gsc) script.
To register a menu, you can call this method:
```c++
add_menu(menu_id, menu_name, parent_id, create_menu = false, menuenterfunc = undefined);
```
- ``menu_id`` is the id of your menu.
- ``menu_name`` is the name of your menu.
- ``parent_id`` is the parent of your menu, ie: the menu openned if you go the previous menu in your menu. Can be `""` for no parent.
- ``create_menu`` is creating the menu link from the parent to the menu
- ``menuenterfunc`` is the *optional* function to when the used is entering your menu, it will call it with self set to the player and the menu as an argument.
You can then add elements to your menu using
```c++
add_menu_item(menu_id, item_name, action, actiondata = undefined, actiondata2 = undefined, actiondata3 = undefined, actiondata4 = undefined, actiondata5 = undefined);
add_menu_item_menuswitch(menu_id, item_name, new_menu_id);
add_menu_item_modswitch(menu_id, item_name, mod_name);
```
- `add_menu_item`, add an item with the name `item_name` in the menu `menu_id`, the action is a function, it will be called with the player as self, the item as a 1st parameter and then the actiondataX as 2nd to 6th parameter.
- `add_menu_item_menuswitch`, add an item with the name `item_name` in the menu `menu_id`, it will open the menu `new_menu_id`
- `add_menu_item_modswitch`, add an item with the name `item_name` in the menu `menu_id`, it will toggle the mod `mod_name` and set the menu item to activated by putting on/off on it
You can use this function to check if a mod is activated:
```c++
is_mod_activated(mod_name);
```
### Key manager
The key manager is in the [`scripts/core_common/key_mgr.gsc`](scripts/core_common/key_mgr.gsc) script.
You can register a key binding in the `key_mgr_init()` function, the syntax is:
```c++
key_mgr_compile_key(hash key_name, undefined|string config, array|string default_config);
```
- `key_name` is the hashed name of the key
- `config` is the config from the user, it follows the same syntax as explained in [scripts/keyconfig.gsc](scripts/keyconfig.gsc).
- `default_config` is the default config, it can be an array or a single key
You can then use the key as you want using these 2 functions:
```c++
// get the key config for this player (work with console controller)
key_mgr_get_key_str(hash key_name) -> string;
// test if a key is pressed and if asked, wait until its release
key_mgr_has_key_pressed(hash key_name, bool wait_release = false) -> bool;
```