{"id":17454775,"url":"https://github.com/ole1986/vscode-arma-dev","last_synced_at":"2025-07-02T09:35:36.213Z","repository":{"id":47818939,"uuid":"110177851","full_name":"ole1986/vscode-arma-dev","owner":"ole1986","description":"Arma Dev for Visual Studio Code","archived":false,"fork":false,"pushed_at":"2021-08-12T19:32:14.000Z","size":1942,"stargazers_count":7,"open_issues_count":5,"forks_count":6,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-19T19:04:50.691Z","etag":null,"topics":["arma","arma3","development","pbo","vscode"],"latest_commit_sha":null,"homepage":"https://marketplace.visualstudio.com/items?itemName=ole1986.arma-dev","language":"TypeScript","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.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-11-09T23:30:17.000Z","updated_at":"2023-12-01T14:32:32.000Z","dependencies_parsed_at":"2022-08-31T05:51:27.425Z","dependency_job_id":null,"html_url":"https://github.com/ole1986/vscode-arma-dev","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/ole1986/vscode-arma-dev","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ole1986%2Fvscode-arma-dev","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ole1986%2Fvscode-arma-dev/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ole1986%2Fvscode-arma-dev/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ole1986%2Fvscode-arma-dev/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ole1986","download_url":"https://codeload.github.com/ole1986/vscode-arma-dev/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ole1986%2Fvscode-arma-dev/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263112283,"owners_count":23415577,"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":["arma","arma3","development","pbo","vscode"],"created_at":"2024-10-18T01:41:44.868Z","updated_at":"2025-07-02T09:35:36.192Z","avatar_url":"https://github.com/ole1986.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Arma Dev\n\nBuilding Arma 3 mod made easier using the Arma Dev tooling extension\nThis Visual Studio Code extensions will optimize your workflow on building and signing pbo's, preview dialog controls and automate execution and installation.\n\n![Getting Started](https://raw.githubusercontent.com/ole1986/vscode-arma-dev/master/images/arma-dev.gif)\n![DialogControl preview](https://raw.githubusercontent.com/ole1986/vscode-arma-dev/master/images/arma-dev-dialog.gif)\n\n## Features\n\n* Build your extension or add existing into the Arma-Dev configuration\n* Pack server and client pbo files (incl. signing) with a single command\n* Preview Dialog control files (*.hpp)\n* Generate private keys\n* Install the client mod into the correct game directory\n* Run and debug (using *.RPT file) on the fly\n\n## Usage\n\nBefore using the Arma Dev extension, please make sure you have properly installed the Arma 3 Tools from Steam.\n\nOpen your existing Arma (server / client) and run the `Arma 3: Configure` command to setup the project.\nPlease refer to the **Configuration** section for further details\n\nBelow you can find all available commands\n\n* `Arma 3: Configure`: to setup the project\n* `Arma 3: Build`: to pack / build pbos defined in your configuration file\n* `Arma 3: Binarize`: binarize cpp files from explorer context menu\n* `Arma 3: UnBinarize`: Unbinarize bin files from explorer context menu\n* `Arma 3: Run Server`: start the arma3server with server mod path included\n* `Arma 3: Run Client`: to start the game from your local computer\n* `Arma 3: Run Client (With Logging)`: to start the game and display the logfile\n* `Arma 3: Generate Key`: generate a private key to sign the client pbo's\n* `Arma 3: Transfer Files`: transfer server pbos to destination server using SFTP\n* `Arma 3: Toggle Code Live`: please read the below \"Toggle Code Live\" section for further details\n\n## Configuration\n\nThe configuration file is located in `.vscode/arma-dev.json` and contains the following options.\n\n* `title`: The title of your project (no used yet)\n* `name`: The short name of the addon (this name is used as output folder)\n* `author`: author name\n* `steamPath`: The default steam path used for this project (default: auto-detect)\n* `buildPath`: destination folder of all pbo files being generated\n* `privateKey`: the private key path being used to sign the client addon\n* `serverDir`: all server directories a pbo files should be created for (E.g. core and core_config)\n* `serverUse32bit`: use legacy 32bit version of arma3server.exe\n* `serverMods`: additional server mods being loaded when running arma3server\n* `clientDirs`: all client directories a pbo files should be created for (ussualy its one or none)\n* `clientMods`: additional client mods being loaded when running arma 3\n* `version`: a version number to track possible changes (not immplemented) \n* `ftpConnection`: setup SFTP connection using host, username and password (optionally path)\n* `ftpConnectionFile`: setup SFTP connection by using a separate file\n* `postProcess`: run some additional scripts once a command has been successfully executed - see \"Post Processing\"\n\n## Toggle Code Live\n\n### PLEASE READ THIS CAREFULLY\n\nWith \"Code live\" you can edit *.sqf files while Arma is running.\nIt uses symlinks (refering to its workspace source) and the `-filePatching` [startup parameter](https://community.bistudio.com/wiki/Arma_3_Startup_Parameters).\n\nA proper configured $PBOPREFIX$ for every addon file is required\n\nSo, how to use it\n\n* Run the command `Arma 3: Toggle Code Live` to create all necessary symlinks into \"Arma 3\\x\" directory\n* use `Arma 3: Run Client` to start Arma with all necessary parameters (-filePatching)\n* use `Arma 3: Run Server` to prepare a server configuration and run it\n* Customize the files defined in your workspace source folder.\n* Open the in-game debug console and either use `execVM` or `preprocessFile*` to \"reload\" the changes.\n* If you use a preInit script (which DOES NOT use `compileFinal`) you can use `execVM` too\n\nPlease be aware of the following\n\n* Server config.cfg requires `allowedFilePatching = 2;` (which is ussually the case when running with `Arma 3: Run Server`)\n* No server side signatur verification will work, so `verifySignatures = 0;` to bypass it\n* You can toggle `Code Live` to either use the source or PBO file (located in buildPath)\n* Some commands / settings (like `compileFinal` / config.cpp) cannot be overwritten (anti cheat)\n\n**HINT: Use `[] spawn { compile preProcessFile \"x\\youraddon\\yourfile.sqf\" };` instead of `execVM \"x\\youraddon\\yourfile.sqf\"` from console to update file modifications**\n\n## Post Processing\n\nThe post processing option (defined in `.vscode/arma-dev.json`) can be helpful to run additional tasks once a command has been successfully executed.\nAn example of running a script when for instance *all files are transfered to the remote* can look the following:\n\n```json\n\"postProcess\": {\n    \"transferFiles\": \"./restart-server.ps1\"\n}\n```\n\nPlease note these commands are always executed locally\n\n## Requirements\n\n* Arma 3 Tools (http://store.steampowered.com/app/233800/Arma_3_Tools/)\n* Visual Studio Code\n\nPLEASE MAKE SURE STEAM IS RUNNING AS IT IS REQUIRED FOR PACKING\n\n## Extension Settings\n\n* `arma-dev.logLevel`: setup the log level (Info | Debug | Error)\n* `arma-dev.dialogAxisMode`: How to display the dialog control axis (0 = truncated, 1 = original) **restart required**\n* `arma-dev.steamPath`: The default steam path used for arma-dev (default: auto-detect)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fole1986%2Fvscode-arma-dev","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fole1986%2Fvscode-arma-dev","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fole1986%2Fvscode-arma-dev/lists"}