{"id":13316243,"url":"https://github.com/Workbench-Team/natsuki-ggproject","last_synced_at":"2025-03-10T22:32:53.594Z","repository":{"id":104200671,"uuid":"225442030","full_name":"Workbench-Team/natsuki-ggproject","owner":"Workbench-Team","description":"Natsuki is a discord bot of GG project","archived":true,"fork":false,"pushed_at":"2021-02-23T02:04:41.000Z","size":2640,"stargazers_count":3,"open_issues_count":6,"forks_count":2,"subscribers_count":5,"default_branch":"master","last_synced_at":"2024-07-29T19:13:27.303Z","etag":null,"topics":["backend","bot","dedicated","discord","discord-bot","discord-music-bot","discordapp","discordbot","discordia","lit","lua","luvi","luvit","natsuki","privileges","under-construction","under-development"],"latest_commit_sha":null,"homepage":"https://ggproject.xyz/discord","language":"Lua","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/Workbench-Team.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2019-12-02T18:28:27.000Z","updated_at":"2023-01-28T10:26:16.000Z","dependencies_parsed_at":null,"dependency_job_id":"eaac01f3-10d0-4708-90a8-0caae567b014","html_url":"https://github.com/Workbench-Team/natsuki-ggproject","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Workbench-Team%2Fnatsuki-ggproject","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Workbench-Team%2Fnatsuki-ggproject/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Workbench-Team%2Fnatsuki-ggproject/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Workbench-Team%2Fnatsuki-ggproject/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Workbench-Team","download_url":"https://codeload.github.com/Workbench-Team/natsuki-ggproject/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242939415,"owners_count":20209874,"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":["backend","bot","dedicated","discord","discord-bot","discord-music-bot","discordapp","discordbot","discordia","lit","lua","luvi","luvit","natsuki","privileges","under-construction","under-development"],"created_at":"2024-07-29T18:20:37.858Z","updated_at":"2025-03-10T22:32:53.576Z","avatar_url":"https://github.com/Workbench-Team.png","language":"Lua","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Natsuki Discord bot\nNatsuki is a discord bot of GG project and dedicated firstly for GG project\nSome modules need to rewrite to work with configs and be adaptive for any bot\n\n### GG project info\nThe project is dedicated to creating unique servers on the Internet. Of course, all servers can be unique, but we try to make them as unique and interesting as possible.\n\n# Features\n  - Read and reply DM\n  - Simple command handler\n  - Embed generator\n  - Privileges (need to rewrite)\n  - Read `modules/list.lua` to know all features\n\n### TODO\n  - New privileges system\n  - Votes for GG Events\n  - Automatic check reviews of GG Project\n  - Rewrite voice module for any stream and playing music\n  - Archive of appelas of GG project\n  - Command to give clan roles for clan owners of GG project\n  - Write all servers where bot is\n  - Translation to other languages\n\n## Install and config\n\n### Install and launch\n```sh\n  $ git clone https://github.com/GG-Project/natsuki.git\n  $ cd natsuki/\n  $ luvit natsuki.lua\n```\n\n### Dependencies\nTo launch bot you need [discordia](https://github.com/SinisterRectus/discordia) library, that works on [luvit](http://luvit.io). Just follow instructions on discordia repository, how to install it\n\n### Configs\n\nBefore launch bot, create `config.json` in home folder and config token for it:\n```json\n{\n  \"token\": \"Token of your discord bot\",\n  \"example_backend_url\": \"http://127.0.0.1:1080/api/\"\n}\n```\nOther configs in that `config.json` requires with some modules\n\nTo disable some modules you need to comment lines in `modules/list.lua`\n\nConfigs, that allows to use some modules:\nConfigs | Config description | Allowed modules\n--- | --- | ---\n`backend_url`, `backend_token` | Use [backend](https://github.com/GG-Project/backend) | `admin`, `privileges`, `accounts_link`\n`qiwi_hook_id` | Qiwi donate notifier. DEPRECATED | `qiwidonat`\n`economy_smile`, `economy_curse_in` | Economy valute emoji and curse. DEPRECATED | `economy`\n`donation_channel_id` | Notify to specified channel id about donate. DEPRECATED | `money`\n\n### Privileges\n`groups.lua` config for `admin` module:\n```lua\ngroups = {\n  ['discord_user_id'] = 'owner',\n  ['other_discord_user_id'] = 'admin'\n}\n```\n\n## Backend\nTo work with backend, you need to config and launch backend server from [this repository](https://github.com/GG-Project/backend)\n\n### Config\nJust create `config.json` with following configs:\n```json\n{\n  \"listen_port\": \"backend server port\",\n  \"tokens\": [\"backend token 1\", \"backend token 2\", \"and more tokens\"],\n  \"privilege_servers\": [\"server_name_1\", \"server_name_2\"],\n  \"mysql_db_host\": \"database_remote_ip\",\n  \"mysql_db_port\": 3306,\n  \"mysql_db_user\": \"database_user\",\n  \"mysql_db_password\": \"database_user_password\",\n  \"mysql_db_name\": \"database_name\"\n}\n```\n\n### Launch\n```sh\n  $ cd backend/\n  $ luvit http.lua\n```\n\n# License\n[GNU General Public License v3.0](https://github.com/ProfessorBrain/natsuki/blob/master/LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FWorkbench-Team%2Fnatsuki-ggproject","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FWorkbench-Team%2Fnatsuki-ggproject","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FWorkbench-Team%2Fnatsuki-ggproject/lists"}