{"id":21107602,"url":"https://github.com/zptxdev/warden","last_synced_at":"2025-07-14T06:35:04.439Z","repository":{"id":37069347,"uuid":"350671534","full_name":"ZPTXDev/Warden","owner":"ZPTXDev","description":"Open-source moderation and utility bot for small communities.","archived":false,"fork":false,"pushed_at":"2025-06-09T22:08:58.000Z","size":1733,"stargazers_count":4,"open_issues_count":19,"forks_count":2,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-09T23:20:33.872Z","etag":null,"topics":["discord","discord-bot","discord-js","localization","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ZPTXDev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":["ZPTXDev","zapteryx"]}},"created_at":"2021-03-23T10:34:32.000Z","updated_at":"2025-03-27T21:32:45.000Z","dependencies_parsed_at":"2024-01-09T23:25:16.559Z","dependency_job_id":"95a7890f-ae2c-4cc7-bb42-98092ac05331","html_url":"https://github.com/ZPTXDev/Warden","commit_stats":null,"previous_names":[],"tags_count":46,"template":false,"template_full_name":null,"purl":"pkg:github/ZPTXDev/Warden","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZPTXDev%2FWarden","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZPTXDev%2FWarden/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZPTXDev%2FWarden/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZPTXDev%2FWarden/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ZPTXDev","download_url":"https://codeload.github.com/ZPTXDev/Warden/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZPTXDev%2FWarden/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265253387,"owners_count":23735093,"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":["discord","discord-bot","discord-js","localization","typescript"],"created_at":"2024-11-20T00:41:07.863Z","updated_at":"2025-07-14T06:35:04.416Z","avatar_url":"https://github.com/ZPTXDev.png","language":"TypeScript","funding_links":["https://github.com/sponsors/ZPTXDev","https://github.com/sponsors/zapteryx"],"categories":[],"sub_categories":[],"readme":"# Warden\nWarden is a simple-to-use moderation and utility bot with features such as auto-moderation, text-to-speech, and more.\n\n# Using Warden\nWarden utilizes slash commands, buttons, and menus. After deploying the commands, type `/` into your chat to list Warden's commands.\n\n# Public Instance\nWarden is available for public use [here](https://go.zptx.dev/InviteWarden). Keep in mind that this instance of Warden will only run the latest stable version.\n\n# Hosting Warden\nHosting Warden is fairly simple. Make a copy of `settings.example.json`, edit the fields as necessary and rename it to `settings.json`. An explanation on each property is available [here](CONFIGURATION.md).\n\nYou are required to host your own instance of [Lavalink](https://github.com/freyacodes/Lavalink) and specify the connection details in `settings.json`.\n\n## Prerequisites\n- Node.js v16.9.0 (or higher)\n- npm (should come bundled with Node.js)\n- Lavalink (latest release)\n- Bot token from [Discord](https://discord.com/developers/applications)\n\n## Starting Warden for the first time\nRun `npm ci` to install packages required to run Warden.\n\nRun `npm run build` to compile the source code. Alternatively, you can run `npm run build-start` to compile the source code and start Warden in one command.\n\nYou can deploy slash commands after the build by running `npm run slash-deploy`.\n\nFor subsequent startups, you can simply run `npm start`, which skips the compilation step.\n\n# FAQ\n## Can you add x feature to Warden?\nYes, if it is meaningful. Submit an issue [here](https://github.com/ZPTXDev/Warden/issues) and I'll be happy to take a look.\n\n## I changed the language through the `/settings` command. Why isn't it updating in slash commands?\nSlash commands are defined when running `npm run slash-deploy`.\n\nThis means that slash command descriptions will follow the language set in `settings.json` (`defaultLocaleCode` \nkey).\n\n## I changed `defaultLocaleCode`, but it isn't updating in slash command descriptions. Why?\nYou need to re-deploy the commands using `npm run slash-deploy` for the new locale to take effect.\n\nDue to Discord's limitations and the localizations we have, we don't currently use Discord's localized command name \u0026 description functionality. This may be worked on in the future.\n\n# Translating\nTake a look at our [Crowdin project](https://translate.zptx.dev).\n\n# Contributing\nRefer to [CONTRIBUTING.md](CONTRIBUTING.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzptxdev%2Fwarden","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzptxdev%2Fwarden","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzptxdev%2Fwarden/lists"}