Void-Nuke新手指南:10分钟玩转红黑终端菜单与39条命令编号速查清单
Void-Nuke新手指南:10分钟玩转红黑终端菜单与39条命令编号速查清单
Void-Nuke 是一款用 Python 编写的 Discord 服务器管理命令行工具(CLI),采用红黑配色的终端菜单界面,内置 39 条编号命令,覆盖频道管理、角色管理、成员工具、服务器信息与备份辅助等场景。本指南面向新手,带你 10 分钟完成安装、配置并掌握命令编号速查清单,适合在自己创建的 Discord 服务器上进行学习实践。
一、Void-Nuke 是什么?
Void-Nuke 是一个单文件 Python 机器人(核心代码仅 main.py 一个文件),启动后呈现一个炫酷的红黑终端界面:
- 🖥️ Rich TUI 红黑菜单:等宽表格 + 进度条 + 故障动画,命令行操作零门槛
- 🔢 39 条编号命令:输入两位数字编号即可执行,无需记忆复杂参数
- 📦 模块化设计:服务器结构管理(第 1 页)+ moderation 与实用工具(第 2 页)
- ⚠️ 仅限教育用途:只在你自己拥有的服务器,或获得明确书面授权的服务器上练习
📌 完整的条款说明见 DISCLAIMER.md,许可证为 MIT(LICENSE)。
二、一键安装步骤(3 步搞定)
项目专为 Windows 设计,双击 BAT 脚本即可完成全部流程:
| 步骤 | 脚本 | 作用 |
|---|---|---|
| 1 | python_installer.bat | 检查本机 Python 环境(需 Python 3.10+) |
| 2 | setup.bat | 安装依赖(discord.py、aiohttp、colorama) |
| 3 | start.bat | 启动 Void-Nuke 命令行界面 |
1 — python_installer.bat checks Python
2 — setup.bat installs dependencies
3 — start.bat launches the CLI
🎯 小贴士:启动后程序会先播放一段"红色字符雨"开机动画,随后依次要求输入两项内容:
token:Discord Bot 的 Token(在 Discord Developer Portal 创建应用后获取)server id:目标服务器的 ID(服务器设置中开启"开发者模式"后右键复制)
三、如何开启 Bot Intents(必须配置)
在 Developer Portal 中,进入 Applications → 你的机器人 → Bot → Privileged Gateway Intents,开启以下两项:
| Intent | 是否必需 |
|---|---|
| Server Members Intent | ✅ |
| Message Content Intent | ✅ |
| Presence Intent | ❌ |
⚠️ 同时要把 Bot 邀请进你的目标服务器,并授予与所执行操作匹配的权限,否则会看到
no perm错误提示。
四、10分钟玩转红黑终端菜单
登录成功后进入主菜单,界面顶部显示机器人名称、服务器名称与成员数,下方是 4 列编号命令表格。操作只需记住 4 个按键:
| 按键 | 作用 |
|---|---|
n |
下一页 |
b |
上一页 |
01 – 39 |
直接运行对应编号的命令 |
q |
退出程序 |
每条命令执行后都会输出带时间戳的日志([+] 成功、[-] 失败、[!] 警告),结尾附一份 ok / err / 耗时 汇总卡片,操作反馈非常直观。
🧪 新手建议:第一次使用先从 25 Server Info 这类只读命令入手,再尝试 10 Create Channels、11 Create Roles 这类无破坏性命令,熟悉节奏后再练习清理类命令。
五、39条命令编号速查清单
第 1 页:服务器结构管理(01–20)
| 编号 | 命令 | 功能说明 |
|---|---|---|
01 |
Nuke | 一键重置:清空全部频道/角色并批量重建 |
02 |
Auto Raid | 批量创建频道、角色并投递消息 |
03 |
Ban All | 全服成员批量封禁 |
04 |
Kick All | 全服成员批量踢出 |
05 |
Mute All | 按指定分钟数全员静音 |
06 |
Unban All | 批量解除封禁 |
07 |
Del Channels | 删除全部频道 |
08 |
Del Emojis | 删除全部自定义表情 |
09 |
Del Stickers | 删除全部贴纸 |
10 |
Create Channels | 批量创建文本/语音频道 |
11 |
Create Roles | 批量创建角色 |
12 |
Create Cats | 批量创建频道分类(Category) |
13 |
Rename Channels | 批量重命名频道 |
14 |
Rename Roles | 批量重命名角色 |
15 |
Edit Server | 修改服务器名称、头像、简介 |
16 |
Rename Members | 批量修改成员昵称 |
17 |
Fix Nicks | 修复以特殊字符开头的昵称排序问题 |
18 |
Get Admin | 为指定成员或全员授予全权限角色 |
19 |
Impersonate | 以指定成员头像昵称发送消息 |
20 |
Ghost Ping | 批量 @ 全员(消息自动删除) |
第 2 页:Moderation 与实用工具(21–39)
| 编号 | 命令 | 功能说明 |
|---|---|---|
21 |
Remove Roles | 移除所有成员的自定义角色 |
22 |
Message All | 向全服成员批量发送私信 |
23 |
DM Spam User | 按用户 ID 批量发送私信 |
24 |
Webhook Spam | 批量创建 Webhook 投递消息 |
25 |
Server Info | 查看服务器名称、ID、成员、封禁、频道、角色等统计 |
26 |
Clone Server | 将服务器频道结构导出为 JSON 备份文件 |
27 |
Webhook Logs | 将服务器消息实时转发到指定 Webhook |
28 |
Lockdown | 批量锁定全部文本频道发言权限 |
29 |
Sourdine VC | 全员语音成员一键禁音 |
30 |
Kick VC All | 将全部语音成员移出频道 |
31 |
Move All VC | 将全部语音成员移至指定频道 |
32 |
Invite Spam | 批量生成一次性邀请链接 |
33 |
Spam | 向所有频道批量发送文本消息 |
34 |
Thread Spam | 批量创建话题(Thread) |
35 |
Reaction Spam | 批量为历史消息添加表情回应 |
36 |
Voice Spam | 高频连接/断开语音通道 |
37 |
Spoiler Spam | 批量发送剧透(Spoiler)格式消息 |
38 |
Poll Spam | 批量创建投票(Poll) |
39 |
Event Spam | 批量创建服务器定时活动 |
菜单第 3 页另有 41–45 编号选项,需按仓库提示星标后解锁体验;输入 40 或 q 即可退出。
六、使用注意事项与扩展阅读
- ⚖️ 合法合规:严禁用于攻击他人服务器、绕过安全系统或违反平台服务条款的行为,具体边界请阅读 DISCLAIMER.md
- 🔐 Token 安全:Bot Token 等同密码,请勿提交到代码库或分享给他人
- 🐍 源码阅读:命令实现集中在 main.py 的
COMMANDS区块,菜单定义见_MENU变量,是学习 Python 异步编程(asyncio)与 Discord API 的好素材 - 📖 项目说明:更多安装细节与功能概览见 README.md
总结:Void-Nuke 用"红黑终端 + 数字编号"的极简交互,把 39 项服务器管理操作装进了一个菜单。只需三步安装脚本 + 两项 Intent 配置,10 分钟就能在自建服务器上跑通第一条命令——祝你在教育演练中玩得开心!
