{"id":14983457,"url":"https://github.com/electrocute4u/tsumiki","last_synced_at":"2025-09-20T21:18:56.242Z","repository":{"id":161068252,"uuid":"213053770","full_name":"Electrocute4u/Tsumiki","owner":"Electrocute4u","description":"Tsumiki is a Discord bot written in Javascript that is running on v12 of Discord.js Library.","archived":false,"fork":false,"pushed_at":"2021-11-28T14:43:37.000Z","size":204,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-09T12:04:30.650Z","etag":null,"topics":["acchi","action-commands","anime","bot","discord","discord-bot","discord-js","discord-js-bot","discord-library","javascript","kocchi","miniwa","tsumiki","waifu"],"latest_commit_sha":null,"homepage":"","language":null,"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/Electrocute4u.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":"2019-10-05T18:49:33.000Z","updated_at":"2023-04-24T05:07:28.000Z","dependencies_parsed_at":null,"dependency_job_id":"6ebe42c9-e469-4488-95dc-a7dfb3d3c1e6","html_url":"https://github.com/Electrocute4u/Tsumiki","commit_stats":{"total_commits":64,"total_committers":1,"mean_commits":64.0,"dds":0.0,"last_synced_commit":"119e0f3d4f915fcc41814dc2eab19a38a7c6cb65"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Electrocute4u/Tsumiki","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Electrocute4u%2FTsumiki","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Electrocute4u%2FTsumiki/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Electrocute4u%2FTsumiki/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Electrocute4u%2FTsumiki/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Electrocute4u","download_url":"https://codeload.github.com/Electrocute4u/Tsumiki/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Electrocute4u%2FTsumiki/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":276159979,"owners_count":25595433,"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","status":"online","status_checked_at":"2025-09-20T02:00:10.207Z","response_time":63,"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":["acchi","action-commands","anime","bot","discord","discord-bot","discord-js","discord-js-bot","discord-library","javascript","kocchi","miniwa","tsumiki","waifu"],"created_at":"2024-09-24T14:07:14.100Z","updated_at":"2025-09-20T21:18:56.175Z","avatar_url":"https://github.com/Electrocute4u.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ca\u003e\u003cimg src=\"https://i.imgur.com/wtIunV6.png\" style=\"width: 100%;\" /\u003e\u003c/a\u003e\n\u003ch1 align=\"center\" size=\"30px\"\u003eTsumiki\u003c/h1\u003e\n\u003ch3 align=\"center\"\u003e\nThe perfect Anime Action Bot for your Discord server!\n\u003c/h3\u003e\n\u003cp align=\"center\"\u003e\n\u003cimg alt=\"Discord\" src=\"https://img.shields.io/discord/396117030375522307?style=for-the-badge\"\u003e\n\u003cimg alt=\"GitHub\" src=\"https://img.shields.io/github/license/electrocute4u/tsumiki?style=for-the-badge\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n\u003cimg alt=\"GitHub watchers\" src=\"https://img.shields.io/github/watchers/electrocute4u/tsumiki?style=social\"\u003e\n\u003cimg alt=\"Twitter Follow\" src=\"https://img.shields.io/twitter/follow/BotTsumiki?style=social\"\u003e\n\u003cimg alt=\"GitHub followers\" src=\"https://img.shields.io/github/followers/electrocute4u?style=social\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n\u003cimg alt=\"npm\" src=\"https://img.shields.io/badge/discord.js-v.12.5.3-blue?\u0026label=Discord.js\u0026style=for-the-badge\"\u003e\n\u003cimg alt=\"npm\" src=\"https://img.shields.io/npm/v/npm?color=lightblue\u0026label=NPM\u0026style=for-the-badge\"\u003e\n\u003cimg alt=\"npm\" src=\"https://img.shields.io/npm/v/mongoose?color=lightgreen\u0026label=Mongoose\u0026style=for-the-badge\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\u003ca href=\"https://top.gg/bot/560893917839622158\" target=\"_blank\" rel=\"noopener\"\u003eTop.gg Bot page\u003c/a\u003e \u0026bull; \u003ca href=\"https://twitter.com/Electrocute4u\" target=\"_blank\" rel=\"noopener\"\u003eTwitter Page\u003c/a\u003e \u0026bull; \u003ca href=\"https://twitter.com/BotTsumiki\" target=\"_blank\" rel=\"noopener\"\u003eMy Github\u003c/a\u003e \u0026bull; \u003ca href=\"https://top.gg/servers/396117030375522307/join\" target=\"_blank\" rel=\"noopener\"\u003eDiscord Server\u003c/a\u003e\u003c/p\u003e\n\u003cp align=\"center\"\u003e\u003ca href=\"https://discord.js.org/#/docs/main/stable/general/welcome\" target=\"_blank\" rel=\"noopener\"\u003eDiscord.js Documentation\u003c/a\u003e \u0026bull; \u003ca href=\"https://www.javascript.com/\" target=\"_blank\" rel=\"noopener\"\u003eJavascript Website\u003c/a\u003e\u003c/p\u003e\n\n## [Table of contents](table-of-contents)\n\n\u003cdetails\u003e\n \n\u003csummary\u003e\"Click to expand the Table of Contents\" \u003c/summary\u003e\n \n- [About the bot](#about-the-discord-bot)\n- [Who is it based on?](#who-is-it-based-on)\n- [Features](#features)\n- [Mention System 3.0](#mention-system-30)\n- [F.A.Q](#faq)\n- [Useful links](#useful-links)\n- [Join the Official Server](#join-the-official-support-server)\n- [BotList Widgets](#botlist-widgets)\n- [License](#license)\n\n\u003c/details\u003e\n\n\n# [About the Discord bot](#about-the-discord-bot)\nThe bot is running on **Discord.js Library** and was developed using **JavaScript** programming language. \\\nIt has various different commands, but the main attraction of the bot is its Action commands (hug, pat, kiss etc). \\\nThe bot is mostly anime-themed, but it can also be used by anyone, it doesn't have to be just for weebs. \\\nWhat sets this bot out amongst countless other bots is its **[Mention System](#mention-system)**.\n\n## [Who is it based on?](#who-is-it-based-on)\n[Tsumiki Miniwa](https://acchikocchi.fandom.com/wiki/Tsumiki_Miniwa) is a main character from [Acchi Kocchi](https://myanimelist.net/anime/12291/Acchi_Kocchi_TV).\n\n## [Features](#features)\n### The bot currently has:\n- 25+ Action commands (Hug, kiss, pat etc) with more being added over time!\n- Powerful and advanced [Mention System](#mention-system-30)\n- Pagination (React with the emojis for next/back)\n- A database that handles everything from server list cache to bot updates and more.\n- Custom Server Prefix and Description\n- Server Modules that can be turned on/off\n- Marriage. Do keep in mind that this is not real and bots are not marriageable! uwu\n- Role Hierarchy (VIP, Premium, Developer etc)\n- Classical prediction commands and a few custom ones (i.e like, love and pick)\n- Waifurate and Husbandorate\n- Kitsu.io and MyAnimeList database Anime OR Manga search (with random suggestions!)\n- Detailed serverinfo with Server Description, Server Avatar and Splash Invite Screen (Direct links for 32 and up to 2048 size image)\n- Detailed statistic command (total + daily command usage, cached users, bot groups, ping, RAM usage, bot version and more)\n\n...And so much more!\n\n## [Mention System 3.0](#mention-system-30)\n### What is a Mention System?\nA Mention System is a system that will help find a user with various methods and with advanced algorithms. \\\nFor the common developer or someone who don't really need a fancy system, they more or less just use a `user ID` or a `@Mention` as their only options. \\\nHowever, I decided to expand my horizon and follow the bigger fish and then improve it to go even further beyond the limits.\n\n### What are the benefits of this system?\n*You can silently find a global Discord or local Server user and then use them in any command with this system.* \\\n*This is all without having to worry about `@pinging` them like most bots utilize nowadays.* \\\n*Because we all have that one person who ALWAYS hate `@Mentions`, right?* \\\n*And let's all be real, who would sit for 3 hours listening to the kid ranting that you pinged them over and over again in commands...* \\\n*Because I don't and that's why this system came into the lights and because I hate being an nuisance to others if I can help it.*\n\n\u003ca\u003e\u003cimg src=\"https://i.imgur.com/4PeiuQk.jpg\" style=\"width: 100%;\" /\u003e\u003c/a\u003e\n\n### From a tiny hobby project to an advanced system\nWith its powerful and advanced, yet enriching `Mention System` it can be on par or even rival bigger bots with ease. \\\nFirst it was just a tiny hobby project for me to toy around with, which was barely enough to put most bots off the chart. Furthermore, developing it into V.2 enhanced it even a step further and it got even more powerful with its newely added global user support. \\\nWith the latest version, being 3.0 released, it now features even server role users support, which revolutionized it.\n\n### If this is not enough to satisfy the most average Discord user, I'll fall from grace, literally.\n\u003cdetails\u003e\n\u003csummary\u003e\"If you still dislike it... Here, watch me fall from grace\" \u003c/summary\u003e\n\u003ca\u003e\u003cimg src=\"https://i.imgur.com/ZAN7xZl.gif\" style=\"width: 100%;\" /\u003e\u003c/a\u003e\n\u003c/details\u003e\n\n\nSee below for everything the new and powerful `Mention System 3.0` recently released can do! \\\nThere are several ways to find a user and use them in commands silently!\n### Finding a Discord user on your server:\n- Server nickname\n- Discord username (i.e Username or Username#1234) \n- Descriminator (I.e #1234 or 1234)\n- User ID (I.e 209972381622468604)\n- Mention (I.e @Username)\n\n### `[New]` Find a user or multiple user(s) on your server with a role:\n**Note:** The user in the role mentioned/found would have to be cached beforehand! \\\nThis means that if no user in that role has been cached yet, it will return as empty.\n- Role tag (i.e @CoolestGroup or \u003c@\u0026396819590266486784\u003e)\n- Role ID (i.e 396819590266486784)\n- Role name (i.e Developer)\n\n### Finding a global user \u0026 use them later on:\n- User ID\n**Note:** Once the user is cached, they can easily be mentioned in other servers [Example](https://i.imgur.com/5D0lgIU.gif) with the following methods:\n- Discord username (i.e Username or Username#1234) \n- User ID (I.e 209972381622468604)\n- Descriminator (I.e #1234 or 1234)\n\n### Caching and what it does:\nOnce a Discord user is active (i.e sends a message) on a server and a channel the bot has access to, it will automatically cache that user and store the user until the next bot restart. This bot's mention system is using this cache by searching through it using advanced algorithms to find a specific user and to make sure that **8 out of 10** times it finds the correct user. There are also ways to manually cache users (mainly by tagging them with a `@mention`) or by using their `Discord ID` on any of the available commands using this system.\n\n## [F.A.Q](#faq)\n*Here is a short FAQ with the most common questions one mostly asks about.*\n\n### Main purpose of the Discord bot\nTsumiki aims for the \"best\" action bot on the discord bot market. And its main purpose is to produce anime action commands and have the most powerful and advanced mention system there is.\n\n### Unique about the Mention System?\nIt allows a user to go beyond that of what most bots offers to them with mentioning. A Discord ID or @Mention is fine as is, but it felt like a pain after a while. Therefore I coded my own system that allows one to find global discord users with ID, local users with username, nickname, descrimnator and more.\n\n### What are all of Discord bot's features?\nEverything is listed in in [Features](#features)\n\n### Do the bot have any premium content? Can I support the project?\nThe Discord bot currently are 100% free and has no limitations with premium perks. But the system is in place and it may become active in the future.\nAs for supporting it, any donations are welcome. Feel free to PM **Kuuko#0001** on Discord for further details.\n\n### How often is there updates?\nThis is a hobby project and a learning ground for me since 2019, with continues updates almost weekly. However as of lately (2021), I've taken a step back and become less active in the project. But I am still around to patch bugs and at times dedicate myself fully to the project.\n\n## [Useful links](#useful-links)\n- [Bot invite link](https://discord.com/oauth2/authorize?client_id=560893917839622158\u0026scope=bot\u0026permissions=201714880) \n- [Issues](https://github.com/Electrocute4u/Tsumiki/issues) \n- [Support server](https://discord.gg/REEZSj2Uj7) \n- **Patreon:** -Coming soon-\n\n## Join the official Support server\n\u003cp\u003e\u003ca href=\"http://www.discord.gg/2cbUzfRqkb\"\u003e\u003cimg src=\"https://discordapp.com/api/guilds/396117030375522307/widget.png?style=banner2\" alt=\"\" width=\"342\" height=\"81\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n## [BotList Widgets](#botlist-widgets)\n\n### Top.gg \\[[Link](https://top.gg/bot/560893917839622158)\\]\n[![Top.gg](https://top.gg/api/widget/560893917839622158.svg)](https://top.gg/bot/560893917839622158)\n\n\n## [License](#license)\nReleased under [MIT](https://opensource.org/licenses/MIT) license.\n\nThe bot is named after the main character of [Acchi Kocchi](https://myanimelist.net/anime/12291/Acchi_Kocchi_TV), a Manga and Anime by [Ishiki](https://myanimelist.net/people/13057/Ishiki)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Felectrocute4u%2Ftsumiki","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Felectrocute4u%2Ftsumiki","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Felectrocute4u%2Ftsumiki/lists"}