{"id":17347871,"url":"https://github.com/floriansw/lbmaster-advanced-groups-api","last_synced_at":"2025-06-11T19:38:01.641Z","repository":{"id":88741772,"uuid":"457010477","full_name":"FlorianSW/lbmaster-advanced-groups-api","owner":"FlorianSW","description":null,"archived":false,"fork":false,"pushed_at":"2022-09-03T20:29:38.000Z","size":2128,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-27T11:21:34.039Z","etag":null,"topics":[],"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/FlorianSW.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":["https://www.paypal.com/donate?hosted_button_id=C2EYFV3G8Y8P6"]}},"created_at":"2022-02-08T16:21:00.000Z","updated_at":"2023-05-02T17:37:57.000Z","dependencies_parsed_at":null,"dependency_job_id":"4d5166e3-ff96-4377-95d3-73241512914e","html_url":"https://github.com/FlorianSW/lbmaster-advanced-groups-api","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/FlorianSW/lbmaster-advanced-groups-api","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FlorianSW%2Flbmaster-advanced-groups-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FlorianSW%2Flbmaster-advanced-groups-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FlorianSW%2Flbmaster-advanced-groups-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FlorianSW%2Flbmaster-advanced-groups-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FlorianSW","download_url":"https://codeload.github.com/FlorianSW/lbmaster-advanced-groups-api/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FlorianSW%2Flbmaster-advanced-groups-api/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259325618,"owners_count":22841059,"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":[],"created_at":"2024-10-15T16:50:23.745Z","updated_at":"2025-06-11T19:38:01.615Z","avatar_url":"https://github.com/FlorianSW.png","language":"Go","funding_links":["https://www.paypal.com/donate?hosted_button_id=C2EYFV3G8Y8P6"],"categories":[],"sub_categories":[],"readme":"# LBmaster Advanced Groups API\n\nThis is a little tool that can be run next to the Advanced Groups Mod from\nLBmaster (https://lbmaster.de/product.php?id=4). It simply offers a basic API for the configuration to manage dynamic\nparts from somewhere else.\n\nCurrently, only prefix Groups management is implemented in the API, which is the most dynamic part of the config.\n\n## Prerequisites\n\nThis tool does work only, if:\n\n- You have a dedicated server box, where you can run executables on, Game-Service-Providers (GSP, like GTX, Nitrado or\n  so) will not work\n- You have installed and configured the Advanced Groups Mod already (that's out of the scope of this Readme)\n- You have some basic understanding of Server maintenance\n\n## Setup\n\nBasically, it's as easy as that:\n\n- Download the latest version of this tool from\n  the [automated builds](https://github.com/FlorianSW/lbmaster-advanced-groups-api/actions/workflows/build.yml) (take\n  the most-top green build) or from the [releases page](https://github.com/FlorianSW/lbmaster-advanced-groups-api/releases)\n    - There is a windows and linux binary, take the one for your platform\n- Copy the binary to some location on your server (the server where your DayZ server runs as well)\n- Start the executable once (if a window opens, close that for now)\n- A new file, `config.json`, should have been created next to the executable in the same directory; open it in your\n  favorite text editor\n- Change the following config, according to your setup:\n    - the `port` -\u003e it defaults to `8080`, which is fine. If the port, however, is already used, choose some other\n      port (e.g. when you run multiple instances of this tool)\n    - the `advanced_groups_config_path` -\u003e the absolute path to the Advanced Groups config file (`\\` needs to be escaped\n      with another backslash, e.g. a path like `D:\\some\\path\\Config.json` becomes `D:\\\\some\\\\path\\\\Config.json`)\n- Start the tool again by double-clicking it\n\nThat's it, the tool should start and be ready to serve your requests. You might need to change your firewall or router\nsettings to either forward or whitelist traffic for the port you just configured in the `cconfig.json` file.\n\n## Usage\n\nThe tool offers a REST-like API, which allows you to modify some parts of the config of Advanced Groups.\n\n### Authentication\n\nThe tool uses a pre-configured API key to authenticate and authorize requests, which can be found in the `config.json`.\nEveryone who knows this API key can issue requests to the tool, and they will be fulfilled.\n\nIn order to make an authenticated request, add the `Authorization` header to your HTTP requests with the `Bearer`\nscheme, e.g.\n\n```\nAuthorization: Bearer abc123\n```\n\nGiven the API key is `abc123`.\n\n### Available endpoints\n\nThe following list will give you an overview of available endpoints offered by this tool:\n\n#### `GET /api/prefixGroups`\n\nLists available prefix groups.\n\nExample response:\n\n```json\n[\n  {\n    \"index\": 0,\n    \"prefix\": \"[VIP] \"\n  }\n]\n```\n\n#### `GET /api/prefixGroups/\u003cindex\u003e`\n\nLists members of that prefix group.\n\n_Parameters_:\n\n- \u003cindex\u003e: The index of the prefix group to query, e.g. `0`\n\nExample request:\n`GET /api/prefixGroups/0`\n\nExample response:\n\n```json\n[\n  \"76561111111111111\",\n  \"76561122222222222\"\n]\n```\n\n#### `PUT /api/prefixGroups/\u003cindex\u003e/\u003csteamUID\u003e`\n\nAdds the requested Steam UID to the given prefix Group.\n\n_Parameters_:\n\n- \u003cindex\u003e: The index of the prefix group to query, e.g. `0`\n- \u003csteamUID\u003e: The steam UID of the profile you want to add to the prefix group\n\nExample request:\n`GET /api/prefixGroups/0/76561122222222222`\n\nExample response:\n\nThe response is always empty. A successful request is indicated by a `204` status code.\n\n#### `DELETE /api/prefixGroups/\u003cindex\u003e/\u003csteamUID\u003e`\n\nRemoves the requested Steam UID from the given prefix Group.\n\n_Parameters_:\n\n- \u003cindex\u003e: The index of the prefix group to query, e.g. `0`\n- \u003csteamUID\u003e: The steam UID of the profile you want to remove from the prefix group\n\nExample request:\n`DELETE /api/prefixGroups/0/76561122222222222`\n\nExample response:\n\nThe response is always empty. A successful request is indicated by a `204` status code.\n\n#### `GET /api/prefixGroups/\u003cindex\u003e/\u003csteamUID\u003e`\n\nCan be used to check if a specific Steam UID is member of the given prefix Group.\n\n_Parameters_:\n\n- \u003cindex\u003e: The index of the prefix group to query, e.g. `0`\n- \u003csteamUID\u003e: The steam UID of the profile you want to check the membership of\n\nExample request:\n`GET /api/prefixGroups/0/76561122222222222`\n\nExample response:\n\nThe response is always empty.\nIf the steam UID _is_ member of the prefix group, the status code will be 204.\nIf the steam UID _is not_ member of the prefix group, the status code will be 404.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffloriansw%2Flbmaster-advanced-groups-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffloriansw%2Flbmaster-advanced-groups-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffloriansw%2Flbmaster-advanced-groups-api/lists"}