{"id":17819072,"url":"https://github.com/maestre3d/gtavd","last_synced_at":"2025-04-02T09:25:04.252Z","repository":{"id":104103649,"uuid":"472130917","full_name":"maestre3d/gtavd","owner":"maestre3d","description":"The Grand Theft Auto V daemon for third-party modification management.","archived":false,"fork":false,"pushed_at":"2022-03-22T04:31:41.000Z","size":23,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-08T00:32:06.945Z","etag":null,"topics":["daemon","grand-theft-auto","gtav","modding","modding-tool","windows-service"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/maestre3d.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2022-03-20T23:46:01.000Z","updated_at":"2022-03-22T04:57:56.000Z","dependencies_parsed_at":null,"dependency_job_id":"8e66fce4-e239-4f85-a20b-0b16e1f73aa4","html_url":"https://github.com/maestre3d/gtavd","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maestre3d%2Fgtavd","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maestre3d%2Fgtavd/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maestre3d%2Fgtavd/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maestre3d%2Fgtavd/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/maestre3d","download_url":"https://codeload.github.com/maestre3d/gtavd/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246786473,"owners_count":20833695,"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":["daemon","grand-theft-auto","gtav","modding","modding-tool","windows-service"],"created_at":"2024-10-27T16:57:37.274Z","updated_at":"2025-04-02T09:25:04.229Z","avatar_url":"https://github.com/maestre3d.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# gtavd\n`gtavd` is a Grand Theft Auto V daemon for third-party modification management. According to \n[wikipedia](https://en.wikipedia.org/wiki/Daemon_(computing)), a daemon is a computer program that runs as a \nbackground process, rather than being under the direct control of an interactive user.\n\nAs just previously stated, this tool allows Grand Theft Auto V modding enthusiasts to run common tasks derived from \nmodding activities with almost no user-interaction. \nThe main benefit of `gtavd` is to ease overall modding operational overhead (e.g. updating the dlclist.xml file \neverytime a new addon mod is added, enabling/disabling specific scripts, keeping files in-sync between multiple devices).\n\n## Table of Contents\n\n- [gtavd](#gtavd)\n  - [Table of Contents](#table-of-contents)\n  - [How-To](#how-to)\n    - [Install Daemon](#install-daemon)\n    - [Run as a Program (Standalone version)](#run-as-a-program-standalone-version)\n    - [Change Configuration](#change-configuration)\n    - [Restart/Stop the Service](#restartstop-the-service)\n    - [Access to Logs for Troubleshooting](#access-to-logs-for-troubleshooting)\n  - [Features](#features)\n    - [Dlclist.xml Automatic Generation](#dlclistxml-automatic-generation)\n  - [Feature Roadmap](#feature-roadmap)\n\n## How-To\n\n### Install Daemon\n\n`gtavd` is bundled with the **_gtavd.exe_** binary executable and a **_service-installer.bat_** Windows script. \nTo install the daemon, run the _service-installer.bat_ script with _Administrative Privileges/Run as Admin_. \nLook at the script output to check if an error happened during the execution. If no error was found, \nverify if the daemon is running by opening the _Task Manager_ and looking for the _gtavd.exe_ background process.\n\n### Run as a Program (Standalone version)\n\n`gtavd` is bundled with a **_gtavd_standalone.exe_** binary executable. This executable contains most of the features \nthe daemon offers. Nevertheless, the _standalone_ version WILL NOT run as a background process -no Windows Service is \nrequired-. \n\nTo run the executable, double-click the file. As a matter of fact, this version will prompt a Windows console \n(_CMD or Powershell_).\n\n### Change Configuration\n\n`gtavd` is fully configurable using the [**gtavd.config**](testdata/configs/gtavd.config.yaml) file. It contains a set of definitions the daemon will use to perform tasks. Be aware some configurations such as _module enabling_ require the RESTART of the service to take effect.\n\nThe configuration file is located under the user's HOME path (*e.g. C:/Users/YOUR_USERNAME/.gtavd*). Enabling the \n**Show hidden files** _Windows Explorer_ feature MIGHT be required in order to be able to see the _.gtavd_ folder.\n\n### Restart/Stop the Service\n\n`gtavd` runs as a [Windows service](https://docs.microsoft.com/en-us/dotnet/framework/windows-services/introduction-to-windows-service-applications). In order to restart or stop the service: \n\n- Go to task manager, click on **More details** and look for the **_gtavd.exe_** process. \n- Once found, click on the left arrow to expand the process item and the service will be shown (represented as the only item within the process with a gear icon).\n- To stop the service, right-click the service and select **Stop**.\n- To restart the service, right-click the service and select **Open Services**.\n  - A new window will open with the services list, look for the _Grand Theft Auto V Modification Daemon_ service.\n  - Once found, right-click the service and select **Restart**.\n\n### Access to Logs for Troubleshooting\n\n`gtavd` makes use of the [_rotating-file_](https://en.wikipedia.org/wiki/Log_rotation) logging technique. This means it \ngenerates logs gzip-compressed and partitioned by default along a log removal after _n_ days mechanism \n(_default is 14 days_). Furthermore, the logs are partitioned by size (_default is 128 MB_).\nFinally, `gtavd` streams logs into the _stderr_ too.\n\nThe log files are located under the user's HOME path (*e.g. C:/Users/YOUR_USERNAME/.gtavd/logs*). Enabling the \n**Show hidden files** _Windows Explorer_ feature MIGHT be required in order to be able to see the _.gtavd_ folder.\n\n## Features\n\n### Dlclist.xml Automatic Generation\n\nThe `dlclist` module is a background-running task detecting changes of both _/mods/x64/dlcpacks_ and _/x64/dlcpacks_ directories of a Grand Theft Auto V game. When a change is detected, the module receives a notification and generates automatically a **dlclist.xml** file ready to be imported into _update.rpf_ file using _OpenIV_. \n\n## Feature Roadmap\n\n- `Script blacklisting`. Enable or disable script mods (_e.g. .rph, .ini, .dll, .asi_) using a blacklist mechanism. \nBlacklisted scripts will be moved to a _temporary_ folder, so they can be later re-enabled. \n- `Cloud-sync of configuration files`. Useful to keep a global configuration between multiple machines.\n- `Cloud-sync of mods files`. Useful to keep a set installed mods between multiple machines. It MIGHT just keep in-sync \nthe _mods_ folder and lightweight scripts to reduce overall cloud storage consumption.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaestre3d%2Fgtavd","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmaestre3d%2Fgtavd","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaestre3d%2Fgtavd/lists"}