Grasscutter 私服命令实操手册：/give 送角色、/tp 传送、/weather 改天气，什么情况打什么
【免费下载链接】GrasscutterA server software reimplementation for a certain anime game.项目地址: https://gitcode.com/GitHub_Trending/gr/Grasscutter
Grasscutter 的命令系统就是你私服的"服务器管理工具箱"：不用背命令、不用翻代码，想到什么就在游戏里输入对应的那一行。比如想直接要一个 90 级满命旅行者？输入/give 10000002 lv90 c6 sl10，瞬间完成。下面这份手册按场景组织，每一章只回答一个问题——"我现在遇到这种情况，该输入什么？"
第一步：把 /help 当成随身字典 📖
不记得命令格式时，永远先问/help，它会把当前权限下你能用的所有命令、用法和别名直接打印出来。这是 Grasscutter 命令系统的自学习机制：每条命令都通过注解自动注册，/help直接从注册表里读取，所以它永远是最新最全的。
/help # 列出你可用的全部命令 /help give # 查看某条命令的完整用法、别名、所需权限权限方面一句话带过：命令大致分player.（玩家对自己可用）和server.（管理员级别）两类，/help <命令>会直接告诉你这条命令需要什么权限，没有权限时也会明确提示。想给别人加权限，用/permission add <permission>（目标玩家前缀@）。
想换地图或换天气？两条命令的事 🗺️
把自己或别人送到任何坐标
/tp支持坐标传送，第四个参数可选——填了场景 ID 就顺便切场景：
/tp 560 3100 -340 # 传送到当前场景的指定坐标 /tp 0 0 0 1003 # 传送到 1003 场景的中心点 /tp @10000001 0 0 0 # 把目标玩家 @10000001 传送到坐标注意：参数是x y z [sceneId]，坐标不是数字会提示位置无效。
想下雨就下雨，想看雪就看雪
/weather不带参数会告诉你当前天气；带参数则是[weatherId] [天气类型]，天气类型支持sunny / cloudy / rain / thunderstorm / snow / mist / desert：
/weather # 查询当前天气 /weather rain # 切换为雨天 /weather 101 snow # 指定天气 ID 并设为雪天拍照党可以试试/weather mist，配合高台视角出片率很高。
角色、武器、圣遗物、材料：/give 一个命令全给你 🎁
一行命令送出满命 90 级角色
/give的别名是/g、/item，核心格式是<ID或关键字> [lv等级] [r精炼] [x数量] [c命座] [sl技能等级]：
/give 10000002 lv90 c6 sl10 # 角色：90 级、6 命、10 级技能 /give 11502 lv90 r5 x1 # 武器：90 级、精炼 5 阶 /give avatars lv90 c6 # 关键字 avatars：一次性给全部角色 /give mats x999 # 关键字 mats：每种材料来 999 个打副本前顺手打两条：/heal把当前队伍血条拉满，/killall清空当前场景所有怪物（可选场景 ID 参数），再也不想手动清怪。
圣遗物还能指定主副属性
圣遗物（1000~1100 段的 ID 之外的装备 ID）走单独分支：<圣遗物ID> lv<0-20> <主属性> <副属性>,<强化次数>...：
/give 15001 lv20 1004 1012,3 1022,2 # 15001 圣遗物 ID # lv20 20 级（输入 0-20，与游戏内显示一致） # 1004 主属性：攻击百分比 # 1012,3 副属性 1012（暴击率）强化 3 次 # 1022,2 副属性 1022（攻击力）强化 2 次主副属性也可以直接写属性名（如atk、crit），不写清次数就默认拉满。
有人捣乱或要处理账号时 🛡️
管理玩家的目标统一写在参数里，用@UID指人：
/ban @10000002 1893456000 "作弊行为" # 封禁：时间为 Unix 时间戳，默认 2051 年 /kick @10000003 # 踢下线：直接关闭其连接 /account create tester 12345678 # 服务端控制台执行：建账号（可选绑定 UID）/account只能在服务器控制台（不是游戏内）执行，除create外还有delete、list、resetpass。封禁时间是个数字时间戳——不想算的话直接留空，默认封到 2051 年。
想加自己的命令？扩展三步走，报错按序排查 🔧
三步加一条自定义命令
开发流程很简单：① 用@Command注解声明命令标签、用法和权限；② 在execute方法里写执行逻辑；③ 插件初始化时把命令注册进命令表即可。整个命令系统就是注解驱动注册、权限校验与执行逻辑分离，你只管写业务。完整示例可参考 命令源码目录 里的任何一个命令类，照抄结构就能跑。
命令不生效？按这个顺序排查
- 权限：
/help <命令>看它要求什么权限，/permission list @<UID>确认账号确实有 - 参数：对照
/help输出的 usage 逐位核对，ID 是否存在、等级是否越界（角色 1-90、圣遗物 0-20） - 日志：翻服务器控制台输出和
logs/目录，异常栈基本直接指到出错的那一步 - 版本：客户端与 Grasscutter 资源版本是否匹配，版本错配时部分命令行为会异常
更多细节建议直接翻 官方文档，想参与改进可以看 贡献指南——从照着写一条自定义命令开始，是你上手这个项目最快的路径。
【免费下载链接】GrasscutterA server software reimplementation for a certain anime game.项目地址: https://gitcode.com/GitHub_Trending/gr/Grasscutter
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
