{"id":19484226,"url":"https://github.com/its3rr0rswrld/nala","last_synced_at":"2025-07-17T05:41:58.608Z","repository":{"id":257669331,"uuid":"723885130","full_name":"Its3rr0rsWRLD/Nala","owner":"Its3rr0rsWRLD","description":"Nala, an open-source Discord bot for all of your random needs!","archived":false,"fork":false,"pushed_at":"2024-11-29T02:20:41.000Z","size":5988,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-08T07:42:27.322Z","etag":null,"topics":["automation","bot","chatbot","community","developer-tools","discord","discord-bot","javascript","nodejs","open-source"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/Its3rr0rsWRLD.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":"2023-11-27T00:53:12.000Z","updated_at":"2024-11-29T02:20:45.000Z","dependencies_parsed_at":"2024-10-25T05:14:14.813Z","dependency_job_id":"aa4a2f20-a641-4b00-8a35-f0d12dafc2ec","html_url":"https://github.com/Its3rr0rsWRLD/Nala","commit_stats":null,"previous_names":["its3rr0rswrld/nala"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Its3rr0rsWRLD%2FNala","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Its3rr0rsWRLD%2FNala/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Its3rr0rsWRLD%2FNala/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Its3rr0rsWRLD%2FNala/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Its3rr0rsWRLD","download_url":"https://codeload.github.com/Its3rr0rsWRLD/Nala/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240718995,"owners_count":19846485,"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":["automation","bot","chatbot","community","developer-tools","discord","discord-bot","javascript","nodejs","open-source"],"created_at":"2024-11-10T20:19:51.157Z","updated_at":"2025-02-25T17:48:27.698Z","avatar_url":"https://github.com/Its3rr0rsWRLD.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://discord.com/oauth2/authorize?client_id=1223073528954490940\u0026scope=bot\"\u003e\n    \u003cimg src=\"images/nala.gif\" alt=\"Nala\" /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n# Nala\n\n**Nala** is an open-source Discord bot designed to meet various needs with a\nflexible command structure and seamless integration with Discord's API.\n\n[![Join Our Discord](https://img.shields.io/badge/Discord-Join%20Us-7289DA?logo=discord\u0026logoColor=white)](https://dsc.gg/3rr0r)  \n[![Invite Nala](https://img.shields.io/badge/Invite%20Nala-Click%20Here-blue?logo=discord\u0026logoColor=white)](https://discord.com/oauth2/authorize?client_id=1223073528954490940\u0026scope=bot)\n\n## Features\n\n- **Slash Commands**: Easily define and manage commands.\n- **Subcommands**: Organize commands for better functionality.\n- **Utility Functions**: Built-in utilities for logging and temporary replies.\n- **Customizable Configuration**: Manage settings for initialization and command logging.\n- **Deno Compatibility**: Run the bot with [Deno](https://deno.land/) for improved performance and security.\n\n## Table of Contents\n\n- [Installation](#installation)\n  - [Node.js Setup](#nodejs-setup)\n  - [Deno Setup](#deno-setup)\n- [Usage](#usage)\n  - [Starting the Bot](#starting-the-bot)\n  - [Defining Commands](#defining-commands)\n- [Contributing](#contributing)\n- [License](#license)\n- [Support](#support)\n\n## Installation\n\n### Node.js Setup\n\n#### Prerequisites\n\n- [Node.js](https://nodejs.org/) (v14 or higher) OR [Deno](https://deno.land/)\n- [Git](https://git-scm.com/)\n\n#### Steps\n\n1. **Clone the Repository**\n\n   ```bash\n   git clone https://github.com/Its3rr0rsWRLD/nala.git\n   cd nala\n   ```\n\n2. **Install Dependencies**\n\n   ```bash\n   npm install\n   ```\n\n3. **Set Up Environment Variables**\n\n   Create a `.env` file in the root directory and add your Discord bot token:\n\n   ```env\n   TOKEN=your_discord_bot_token_here\n   ```\n\n4. **Configure Settings**\n\n   Edit `settings.json` to customize the bot's settings:\n\n   ```json\n   {\n     \"defaultTempReply\": 5000,\n     \"invalidCommand\": {\n       \"enabled\": true,\n       \"timeout\": 1,\n       \"message\": \"## Woops! How did this happen?\\nThis command does not exist! 😅\"\n     },\n     \"initMessage\": {\n       \"enabled\": true,\n       \"message\": \"Nala is ready for liftoff! 🚀\"\n     },\n     \"logCommandsInit\": true,\n     \"banCheckTime\": 60,\n     \"alertBanToUser\": true,\n     \"useOpenAIWhisperAPI\": false,\n     \"bugReport\": {\n       \"enabled\": true,\n       \"webhook\": \"\"\n     }\n   }\n   ```\n\n#### Steps\n\n1. **Clone the Repository**\n\n   ```bash\n   git clone https://github.com/Its3rr0rsWRLD/nala.git\n   cd nala\n   ```\n\n2. **Run the Bot with Deno**\n\n   Use the following command to start the bot:\n\n   ```bash\n   deno run --allow-net --allow-env --allow-read src/main.ts\n   ```\n\n3. **Set Up Environment Variables**\n\n   Ensure your `.env` file contains the bot token:\n\n   ```env\n   TOKEN=your_discord_bot_token_here\n   ```\n\n4. **Install Deno Dependencies** (Optional)\n\n   If any additional Deno modules are required, install them using:\n\n   ```bash\n   deno install [module]\n   ```\n\n## Usage\n\n### Starting the Bot\n\n#### With Node.js\n\nRun the bot using:\n\n```bash\nnpm start\n```\n\n#### With Deno\n\n```bash\ndeno run --allow-net --allow-env --allow-read src/main.ts\n```\n\n### Defining Commands\n\nPlace your command files in the `commands` directory. Each command file should export an object with `data` and `execute` properties.\n\n## Contributing\n\nWe welcome contributions!\n\n1. **Fork the Repository**\n\n   Click the \"Fork\" button at the top right of the GitHub page.\n\n2. **Create a New Branch**\n\n   ```bash\n   git checkout -b feature/my-new-feature\n   ```\n\n3. **Make Your Changes**\n\n   Add new features, fix bugs, or improve documentation.\n\n4. **Commit Your Changes**\n\n   ```bash\n   git add .\n   git commit -m \"Add new feature\"\n   ```\n\n5. **Push to Your Fork**\n\n   ```bash\n   git push origin feature/my-new-feature\n   ```\n\n6. **Create a Pull Request**\n\n   Go to the original repository and click \"New Pull Request\". Describe your changes and submit.\n\n## License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\n\n## Support\n\nIf you have any issues or questions, feel free to open an issue on GitHub or join our [Discord server](https://dsc.gg/3rr0r).","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fits3rr0rswrld%2Fnala","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fits3rr0rswrld%2Fnala","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fits3rr0rswrld%2Fnala/lists"}