{"id":17454777,"url":"https://github.com/ole1986/a3-admintoolkit","last_synced_at":"2026-02-11T00:33:19.287Z","repository":{"id":84913916,"uuid":"45746801","full_name":"ole1986/a3-admintoolkit","owner":"ole1986","description":"AdminToolkit for Arma 3 (ATK) - Extensions, Moderators, Godmode, Vehicle, global chat","archived":false,"fork":false,"pushed_at":"2019-11-02T11:19:04.000Z","size":33421,"stargazers_count":36,"open_issues_count":8,"forks_count":13,"subscribers_count":15,"default_branch":"master","last_synced_at":"2025-02-02T05:44:27.699Z","etag":null,"topics":["admin","administration","admintoolkit","arma3","moderator","tool"],"latest_commit_sha":null,"homepage":"http://www.exilemod.com/topic/7690-admintoolkit-for-arma-3-v222-exile-edition","language":"SQF","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ole1986.png","metadata":{"files":{"readme":"README.MissionFile.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2015-11-07T17:33:25.000Z","updated_at":"2024-11-25T01:57:27.000Z","dependencies_parsed_at":null,"dependency_job_id":"6738dd30-048e-4525-90b5-bc66038ca1a4","html_url":"https://github.com/ole1986/a3-admintoolkit","commit_stats":null,"previous_names":[],"tags_count":24,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ole1986%2Fa3-admintoolkit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ole1986%2Fa3-admintoolkit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ole1986%2Fa3-admintoolkit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ole1986%2Fa3-admintoolkit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ole1986","download_url":"https://codeload.github.com/ole1986/a3-admintoolkit/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245972672,"owners_count":20702721,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["admin","administration","admintoolkit","arma3","moderator","tool"],"created_at":"2024-10-18T01:41:44.918Z","updated_at":"2026-02-11T00:33:14.237Z","avatar_url":"https://github.com/ole1986.png","language":"SQF","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Extending AdminToolkit features\r\n\r\n**PLEASE NOTE: This README is ONLY important for Extension configuration or development**\r\n\r\n**PLEASE NOTE: Make sure you have read the README.\u0026lt;ExtensionName\u0026gt;.sqf for extensions installation instruction**\r\n\r\nThe AdminToolkit takes advantage of the MissionFile concept allowing you to add additional features.\r\n\r\n- Extending the Menu Menu\r\n- adding additional action command (client/server side)\r\n- customize QuickButton actions\r\n- (...)\r\n\r\n\u003cp align=\"center\"\u003e\r\n\t\u003ca href=\"#build-your-own-extension\"\u003eBuild your own Extension (Guide)\u003c/a\u003e\r\n\u003c/p\u003e\r\n\r\nTo achieve this, the configuration class `CfgAdminToolkitCustomMod` is required in your `config.cpp` located in your MissionFile.\r\nBelow is an excerpt of the current `CfgAdminToolkitCustomMod`.\r\n\r\n```\r\nclass CfgAdminToolkitCustomMod {\r\n\t/* Exclude some main menu items\r\n\t * To only show the menus loaded from an extension, use:\r\n\t * \r\n\t * ExcludeMenu[] = {\"Players\", \"Vehicles\", \"Weapons\" , \"Other\"};\r\n\t */\r\n\tExcludeMenu[] = {};\r\n\t\r\n\t/* Load an additional sqf file as MOD */\r\n\tExtensions[] = {\r\n\t\t/**\r\n\t\t* Usage: {\"\u003cYour Mod Title\u003e\", \"\u003cYourModFile\u003e\"}\r\n\t\t* add a new menu entry called My Extension into main menu */\r\n\t\t{\"My Extension\", \"MyExtension\"}\r\n\t};\r\n\r\n\t/* 4 Quick buttons allowing to add any action you want - See example below*/\r\n\tQuickButtons[] = {\r\n\t\t/* send a message to everyone using the parameter text field */\r\n\t\t{\"Restart Msg\", \"['messageperm', ['Server Restart in X minutes']] call AdminToolkit_doAction\"},\r\n\t\t/* Quickly get a Helicopter */\r\n\t\t{\"Heli\", \"['getvehicle', ['B_Heli_Light_01_armed_F']] call AdminToolkit_doAction\"},\r\n\t\t/*4 button*/\r\n\t\t{\"Empty\", \"['Command', ['Variable #1', 'Variable #2']] call AdminToolkit_doAction\"}\r\n\t};\r\n};\r\n```\r\n\r\n**ExcludeMenu[]**\r\n\r\nThis property is used to hide the default menu entries.\r\nUseful when you only want to display your extension.\r\n\r\n\r\n**Extensions[]**\r\n\r\nThis property is used to load additional extensions (*.sqf files) located in the MissionFile `atk\\extensions` folder.\r\nOn server side it will also include the same file from its `extensions` folder to execute global commands.\r\n\r\n**QuickButtons[]**\r\n\r\nAllows you to overwrite the four quick buttons with some custom commands\r\n\r\n## Build your own extension\r\n\r\nThis is a Step-by-step guide on how to build your own extension.\r\nIn this guide you will learn how to add a new Menu entry, add new action commands, pass them to the server and finally execute custom code (from server)\r\n\r\n- First, make sure you have copied the above mentioned `CfgAdminToolkitCustomMod` into the config.cpp.\r\n- Now, add the following line into the Extensions[] property: `{\"My Extension\", \"MyExtension\"}`\r\n\r\n```\r\nExtensions[] = {\r\n\t/* add a new menu entry called My Extension into main menu */\r\n\t{\"My Extension\", \"MyExtension\"}\r\n};\r\n```\r\n\r\n- Once the menu is selected, it searches for the sqf file \"MyExtension.sqf\" in `atk\\extension\\MyExtension.sqf`. So, lets create this now:\r\n\r\nAs you can see, we have added to actions- The first (myext_hellotomyself) is a local call to showMessage only.\r\nThe second (and more interesting) action is passed to the server.\r\n\r\n- Now we need to setup the server to accept the action \"myext_helloserver\".\r\n\r\n```\r\n// extension\\MyExtension.sqf (located in admintoolkit_servercfg.pbo)\r\n\r\nprivate['_playerObject','_request', '_params'];\r\n_playerObject = _this select 0;\r\n_request = _this select 1; // is supposed to be the action command (myext_helloserver)\r\n_params = _this select 2; // is the text: \"some secret text to the server\"\r\n\r\n\r\n// to keep it simple output every action and parameter into servers log file (so check the log once you execute your custom action)\r\n\r\ndiag_log format[\"[ADMINTOOLKIT-MYEXTENSION]: The action is %1 and the parameter is %2\", _request, str _params];\r\n```\r\n\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fole1986%2Fa3-admintoolkit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fole1986%2Fa3-admintoolkit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fole1986%2Fa3-admintoolkit/lists"}