{"id":48553250,"url":"https://github.com/devvyyxyz/xeno-bot","last_synced_at":"2026-04-08T09:31:26.364Z","repository":{"id":340934974,"uuid":"1168189077","full_name":"devvyyxyz/xeno-bot","owner":"devvyyxyz","description":"Build your xenomorph hive! Eggs will randomly spawn in a channel. be the first to collect them and hatch your xenos. Grow your hive, trade with friends, and compete to create the ultimate collection.","archived":false,"fork":false,"pushed_at":"2026-04-07T03:33:04.000Z","size":4783,"stargazers_count":4,"open_issues_count":3,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-07T05:18:24.032Z","etag":null,"topics":["bot","css","discord","html","js"],"latest_commit_sha":null,"homepage":"https://top.gg/bot/1476427270326583306","language":"JavaScript","has_issues":false,"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/devvyyxyz.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-27T05:24:51.000Z","updated_at":"2026-04-07T03:31:58.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/devvyyxyz/xeno-bot","commit_stats":null,"previous_names":["devvyyxyz/xeno-bot"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/devvyyxyz/xeno-bot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devvyyxyz%2Fxeno-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devvyyxyz%2Fxeno-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devvyyxyz%2Fxeno-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devvyyxyz%2Fxeno-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/devvyyxyz","download_url":"https://codeload.github.com/devvyyxyz/xeno-bot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devvyyxyz%2Fxeno-bot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31549350,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-07T16:28:08.000Z","status":"online","status_checked_at":"2026-04-08T02:00:06.127Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["bot","css","discord","html","js"],"created_at":"2026-04-08T09:31:25.505Z","updated_at":"2026-04-08T09:31:26.344Z","avatar_url":"https://github.com/devvyyxyz.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Xeno Bot Banner](https://placehold.co/1280x400?text=Xeno+Bot)\n\n# 👾 Xeno Bot\n\n[![Discord.js](https://img.shields.io/badge/discord.js-v14-blue.svg)](https://discord.js.org/)\n[![Node.js](https://img.shields.io/badge/node-%3E%3D18-green.svg)](https://nodejs.org/)\n[![License](https://img.shields.io/github/license/devvyyxyz/xeno-bot)](LICENSE)\n[![GitHub Stars](https://img.shields.io/github/stars/devvyyxyz/xeno-bot)](https://github.com/devvyyxyz/xeno-bot/stargazers)\n[![GitHub Forks](https://img.shields.io/github/forks/devvyyxyz/xeno-bot)](https://github.com/devvyyxyz/xeno-bot/network)\n\nBuild your xenomorph hive! Eggs will randomly spawn in a channel. be the first to collect them and hatch your xenos. Grow your hive, trade with friends, and compete to create the ultimate collection.\n\n---\n\n## 🔗 Links\n\n- 🤖 **Invite Bot** — https://discord.com/oauth2/authorize?client_id=1476427270326583306\n- 🗳 **Top.gg Page** — https://top.gg/bot/1476427270326583306\n- 📚 **Documentation** — https://xeno-bot-docs.devvyy.xyz/\n- 💬 **Support Server** — https://discord.gg/WmFDeMKvzj\n- 🧑‍💻 **GitHub Repository** — https://github.com/devvyyxyz/xeno-bot\n\n---\n\n# ✨ Features\n\n- ⚡ Built with **discord.js v14**\n- 🧩 **Modular command \u0026 event system**\n- 🛠 **Developer friendly architecture**\n- 🗄 **SQLite + PostgreSQL support**\n- 📊 **Remote logging support**\n- 🚨 **Optional Sentry error monitoring**\n- 🔧 **Development \u0026 production bot profiles**\n- 🌌 **Sci-fi themed bot experience**\n\n---\n\n# 🚀 Getting Started (For Users)\n\nAdding Xeno Bot to your server is quick and easy.\n\n### 1️⃣ Invite the bot\n\nUse the invite link below:\n\n[https://discord.com/oauth2/authorize?client_id=YOUR_CLIENT_ID](https://discord.com/oauth2/authorize?client_id=1476427270326583306)\n\n### 2️⃣ Grant permissions\n\nThe bot will request permissions needed to operate commands and respond to interactions.\n\n### 3️⃣ Start using commands\n\nOnce invited, you can begin using slash commands such as:\n\n```\n\n/help\n/profile\n/stats\n\n````\n\nMore commands and features are documented in the full documentation.\n\n---\n\n# 📚 Documentation\n\nFull documentation for setup, commands, configuration, and development can be found here:\n\n**https://docs.xeno-bot.xyz**\n\nDocumentation includes:\n\n- Command reference\n- Configuration guides\n- Self-hosting instructions\n- Development architecture\n\n---\n\n# 🌌 Theming \u0026 Lore\n\nXeno Bot takes inspiration from the **Alien franchise**, bringing a biomechanical sci-fi atmosphere to Discord servers.\n\nThe bot’s design and concept revolve around the mysterious **Xenomorph species**, advanced technology, and deep space exploration themes.\n\nFuture features may expand on this theme with:\n\n- Alien-inspired commands  \n- Sci-fi economy elements  \n- Interactive lore systems  \n\n---\n\n# 🛠 Self Hosting\n\nIf you want to run your own instance of Xeno Bot:\n\n### Requirements\n\n- Node.js **18+**\n- A Discord bot token\n- npm\n\n### Installation\n\nClone the repository:\n\n```bash\ngit clone https://github.com/devvyyxyz/xeno-bot.git\ncd xeno-bot\n````\n\nInstall dependencies:\n\n```bash\nnpm install\n```\n\nCreate your environment file:\n\n```bash\ncp .env.example .env\n```\n\nFill in your bot credentials inside `.env`.\n\nStart the bot:\n\n```bash\nnpm start\n```\n\n---\n\n### Redis (optional but recommended)\n\nXeno Bot can use Redis for background job queues, caching, and faster pub/sub operations. Redis is optional for many core features, but recommended if you plan to run workers or use queue-backed features.\n\n- Environment vars:\n\t- `REDIS_URL` — full connection URL (overrides host/port/password)\n\t- `REDIS_HOST` — host (default: `127.0.0.1`)\n\t- `REDIS_PORT` — port (default: `6379`)\n\t- `REDIS_PASSWORD` — password (optional)\n\t- `AUTO_START_REDIS` — when set to `1` for development scripts, the bot will attempt to auto-start Redis (Docker or local `redis-server`) and wait briefly for readiness. Default is controlled in `.env`.\n\t- `AUTO_START_REDIS_TIMEOUT_MS` — timeout for auto-start helper (milliseconds)\n\t- `REDIS_REQUIRED` — when set to `1|true|yes`, startup will fail if Redis is not reachable.\n\nIf you don't run Docker on your machine, the auto-start helper will try to spawn a local `redis-server` binary (if installed).\n\nPlatform-specific quick-start\n\n- macOS (Homebrew)\n\n```bash\n# If you don't have Homebrew, install it first:\n/bin/bash -c \"$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)\"\n# Install and start Redis:\nbrew install redis\nbrew services start redis\n# Verify\nredis-cli ping  # should reply PONG\n```\n\n- Linux (Debian/Ubuntu)\n\n```bash\nsudo apt update\nsudo apt install redis-server\nsudo systemctl enable --now redis-server\nredis-cli ping\n```\n\n- Windows\n\nUse WSL and follow the Linux steps inside the WSL shell, or run Redis via Docker:\n\n```bash\ndocker run -p 6379:6379 --name xeno-redis -d redis:7-alpine\nredis-cli -h 127.0.0.1 ping\n```\n\n- Docker (cross-platform)\n\n```bash\ndocker run -p 6379:6379 --name xeno-redis -d redis:7-alpine\nredis-cli -h 127.0.0.1 ping\n```\n\nTo disable auto-start in development, set `AUTO_START_REDIS=0` in your `.env` file.\n\n- Dev note: See the developer Redis guide for local-dev limitations and recommendations: [docs/DEV_REDIS.md](docs/DEV_REDIS.md)\n\n\n# 🤝 Contributing\n\nContributions are welcome and appreciated.\n\nIf you'd like to contribute:\n\n1. Fork the repository\n2. Create a new branch\n\n```\ngit checkout -b feature/my-feature\n```\n\n3. Commit your changes\n4. Push your branch\n5. Open a Pull Request\n\nPlease open an **issue first** if you're planning a large feature or change.\n\n---\n\n# 🐛 Issues \u0026 Support\n\nIf you encounter bugs or problems:\n\n### GitHub Issues\n\nReport bugs or request features here:\n\n[https://github.com/devvyyxyz/xeno-bot/issues](https://github.com/devvyyxyz/xeno-bot/issues)\n\n### Support Server\n\nJoin the community support server: https://discord.gg/WmFDeMKvzj\n\n---\n\n# ⭐ Star History\n\nIf you like the project, consider **starring the repository**.\n\nStar growth over time:\n\n[![Star History Chart](https://api.star-history.com/svg?repos=devvyyxyz/xeno-bot\\\u0026type=Date)](https://star-history.com/#devvyyxyz/xeno-bot\u0026Date)\n\n---\n\n# 📄 License\n\nThis project is licensed under the **MIT License**.\n\nSee the full license here:\n\n[https://github.com/devvyyxyz/xeno-bot/blob/main/LICENSE](https://github.com/devvyyxyz/xeno-bot/blob/main/LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevvyyxyz%2Fxeno-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevvyyxyz%2Fxeno-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevvyyxyz%2Fxeno-bot/lists"}