4 个真实场景掌握 Grasscutter 命令系统原神私服管理快速上手指南【免费下载链接】GrasscutterA server software reimplementation for a certain anime game.项目地址: https://gitcode.com/GitHub_Trending/gr/GrasscutterGrasscutter 是《原神》的非官方服务端实现玩家的一切行为最终都由它响应它的命令系统就是开服后的总开关。这篇文章不罗列文档而是按开服管理员真实会遇到的 4 个场景带你实操账号权限、玩家管理、玩法调试、自定义命令开发全部命令用法都可在 command 包目录 的源码中查证。场景一开服第一天先搞定权限分级与账号初始化Grasscutter 的权限体系很直白每条命令在注解里声明它需要哪个权限节点见 Command.java。服务器控制台执行的命令不经过玩家校验天然全通所以你前期都可以直接在控制台操作玩家账号玩家账号则需要逐级授权。权限节点按前缀划分三级你在给账号授权时按这个粒度选前缀级别典型命令player.*玩家级对自己操作/tp、/heal、/give、/weatheradmin.*管理级/announce、/mail、/sendserver.*服务器维护级/ban、/kick、/stop、/reload节点支持通配符所以如何给玩家开管理员权限一条命令就够见 PermissionCommand.java/permission 目标UID add server.* # 授予维护级权限 /permission 目标UID add * # 直接超级权限通配所有节点建议只给必需的节点、别急着发*撤销用remove一键清空用clear随时/permission UID list核对。注意对其他玩家执行操作时还会校验permissionTargeted如player.give.others所以授权后最好让对方自己跑一次验证遇到 no permission 就检查是不是漏了others节点。场景二日常运营在线列表、踢人与封禁三件套玩家上线后你可以用/list查在线名单。遇到挂机或开挂行为按程度处理命令效果参数说明/list列出在线玩家 UID无需参数/kick UID强制断开该玩家别名/restart无时长概念/ban UID [时长秒] [原因]封禁账号默认永封时长单位是秒如86400000约 10 年/ban 86400000 作弊这类写法里第一个参数是截止时间的秒数、第二个参数是封禁原因逻辑见 BanCommand.java。这些命令在控制台执行更方便且封禁对离线账号同样生效会直接拒绝登录建议封之前先记下 UID 和违规证据。误封可以用/unban UID解除。场景三玩法调试传送、天气与 /give 参数逐项拆透这是 Grasscutter 最爽的部分GiveCommand.java 支持按 ID 精确发放参数含义itemId / avatarId / all / weapons / mats / avatars单个物品、角色或全武器、全材料、全角色批量lvlevel等级角色会同步计算突破等级rrefinement武器精炼等级 1–5xamount数量cconstellation命座 0–6slskilllevel技能等级逐项拆解一个典型例子/give 10000002 lv90 c6 sl10 角色 10000002旅行者 90 级 6 命 技能 10 级。批量玩法/give avatars lv90 c6一次全角色拉满/give mats x999材料各来 999。圣遗物是重头戏格式为give relicId [lv] [x] [主属性ID] [副属性ID,强化次数]...例如15001 lv20 1004 1012,3 1022,215001圣遗物 IDlv20强化到 20 级1004指定主属性如攻击百分比1012,3副属性 ID 强化次数如暴击率强化 3 次1022,2再叠一条副属性如攻击力强化 2 次少写的副属性会由服务器按等级随机补齐想要毕业装就把主副属性都写全。另外/give 目标UID ...可以发给其他玩家但会额外校验player.give.others权限。传送和天气同样好上手TeleportCommand.java、WeatherCommand.java/tp x y z [sceneId] # 坐标传送可指定场景 /tp 目标UID x y z # 把别的玩家传过去 /weather 天气ID [类型] # 如 /weather 5 rain缺参数查询当前天气/weather不跟参数时只回显当前天气与气候类型想下雨就传天气 ID 加rain想下雪、起雾同理换类型词即可。活动类玩法比如风之迹展览、舞台演出这类需要配置多阶段信息的场景也能在调试时配合这些命令搭好初始状态再进场景验收场景四进阶扩展自定义命令开发与失败排查三步写出一个自定义命令注解定义仿照 command/commands 下的类写一个CommandHandler注册把新命令挂进 CommandMap.java 的命令注册表本地化在语言资源里补上该命令的描述与成功提示文案。Command(label mycommand, usage {参数}, permission player.mycommand) public class MyCommand implements CommandHandler { public void execute(Player sender, Player target, ListString args) { ... } }permission不填则人人可用threading true表示允许异步执行别拿它会改主线程状态的东西乱开。命令执行失败按这四步排查执行流程其实很短卡点都在固定位置输入经 CommandMap 解析标签/别名找到处理器DefaultPermissionHandler 依次校验permission对自己和permissionTargeted对他人处理器解析参数并调用execute返回本地化后的结果或错误消息。所以遇到失败依次检查报 no permission → 回到场景一补权限注意others节点参数错 → 用/help 命令对照usage格式目标问题 → 确认目标 UID 在线/离线状态符合命令的targetRequirement仍然不行 → 看服务端日志并核对你跑的版本与资源文件是否匹配。命令速查表命令用途备注/help [命令名]查看命令列表 / 单条命令详情含别名与权限要求第一顺位工具/permission UID add\|remove\|clear\|list管理玩家权限通配符支持*、**、-排除/list在线玩家列表无需权限节点也能在控制台用/kick UID//ban UID [秒] [原因]踢人 / 封禁误封用/unban/give ID [lv] [r] [x] [c] [sl]发物品、角色、圣遗物别名/g、/item/tp x y z [sceneId]坐标/场景/玩家传送别名/teleport/weather [ID] [类型]查询/设置天气别名/w/announce [内容]全服公告见 AnnounceCommand.java下一步官方文档入口docs/README_zh-CN.md贡献与二次开发规范CONTRIBUTING.md插件 API扩展服务端功能plugin 包建议把/help当字典随身查跑通场景一到三之后你的私服基本就能自转了。【免费下载链接】GrasscutterA server software reimplementation for a certain anime game.项目地址: https://gitcode.com/GitHub_Trending/gr/Grasscutter创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 4 个真实场景掌握 Grasscutter 命令系统：原神私服管理快速上手指南
4 个真实场景掌握 Grasscutter 命令系统原神私服管理快速上手指南【免费下载链接】GrasscutterA server software reimplementation for a certain anime game.项目地址: https://gitcode.com/GitHub_Trending/gr/GrasscutterGrasscutter 是《原神》的非官方服务端实现玩家的一切行为最终都由它响应它的命令系统就是开服后的总开关。这篇文章不罗列文档而是按开服管理员真实会遇到的 4 个场景带你实操账号权限、玩家管理、玩法调试、自定义命令开发全部命令用法都可在 command 包目录 的源码中查证。场景一开服第一天先搞定权限分级与账号初始化Grasscutter 的权限体系很直白每条命令在注解里声明它需要哪个权限节点见 Command.java。服务器控制台执行的命令不经过玩家校验天然全通所以你前期都可以直接在控制台操作玩家账号玩家账号则需要逐级授权。权限节点按前缀划分三级你在给账号授权时按这个粒度选前缀级别典型命令player.*玩家级对自己操作/tp、/heal、/give、/weatheradmin.*管理级/announce、/mail、/sendserver.*服务器维护级/ban、/kick、/stop、/reload节点支持通配符所以如何给玩家开管理员权限一条命令就够见 PermissionCommand.java/permission 目标UID add server.* # 授予维护级权限 /permission 目标UID add * # 直接超级权限通配所有节点建议只给必需的节点、别急着发*撤销用remove一键清空用clear随时/permission UID list核对。注意对其他玩家执行操作时还会校验permissionTargeted如player.give.others所以授权后最好让对方自己跑一次验证遇到 no permission 就检查是不是漏了others节点。场景二日常运营在线列表、踢人与封禁三件套玩家上线后你可以用/list查在线名单。遇到挂机或开挂行为按程度处理命令效果参数说明/list列出在线玩家 UID无需参数/kick UID强制断开该玩家别名/restart无时长概念/ban UID [时长秒] [原因]封禁账号默认永封时长单位是秒如86400000约 10 年/ban 86400000 作弊这类写法里第一个参数是截止时间的秒数、第二个参数是封禁原因逻辑见 BanCommand.java。这些命令在控制台执行更方便且封禁对离线账号同样生效会直接拒绝登录建议封之前先记下 UID 和违规证据。误封可以用/unban UID解除。场景三玩法调试传送、天气与 /give 参数逐项拆透这是 Grasscutter 最爽的部分GiveCommand.java 支持按 ID 精确发放参数含义itemId / avatarId / all / weapons / mats / avatars单个物品、角色或全武器、全材料、全角色批量lvlevel等级角色会同步计算突破等级rrefinement武器精炼等级 1–5xamount数量cconstellation命座 0–6slskilllevel技能等级逐项拆解一个典型例子/give 10000002 lv90 c6 sl10 角色 10000002旅行者 90 级 6 命 技能 10 级。批量玩法/give avatars lv90 c6一次全角色拉满/give mats x999材料各来 999。圣遗物是重头戏格式为give relicId [lv] [x] [主属性ID] [副属性ID,强化次数]...例如15001 lv20 1004 1012,3 1022,215001圣遗物 IDlv20强化到 20 级1004指定主属性如攻击百分比1012,3副属性 ID 强化次数如暴击率强化 3 次1022,2再叠一条副属性如攻击力强化 2 次少写的副属性会由服务器按等级随机补齐想要毕业装就把主副属性都写全。另外/give 目标UID ...可以发给其他玩家但会额外校验player.give.others权限。传送和天气同样好上手TeleportCommand.java、WeatherCommand.java/tp x y z [sceneId] # 坐标传送可指定场景 /tp 目标UID x y z # 把别的玩家传过去 /weather 天气ID [类型] # 如 /weather 5 rain缺参数查询当前天气/weather不跟参数时只回显当前天气与气候类型想下雨就传天气 ID 加rain想下雪、起雾同理换类型词即可。活动类玩法比如风之迹展览、舞台演出这类需要配置多阶段信息的场景也能在调试时配合这些命令搭好初始状态再进场景验收场景四进阶扩展自定义命令开发与失败排查三步写出一个自定义命令注解定义仿照 command/commands 下的类写一个CommandHandler注册把新命令挂进 CommandMap.java 的命令注册表本地化在语言资源里补上该命令的描述与成功提示文案。Command(label mycommand, usage {参数}, permission player.mycommand) public class MyCommand implements CommandHandler { public void execute(Player sender, Player target, ListString args) { ... } }permission不填则人人可用threading true表示允许异步执行别拿它会改主线程状态的东西乱开。命令执行失败按这四步排查执行流程其实很短卡点都在固定位置输入经 CommandMap 解析标签/别名找到处理器DefaultPermissionHandler 依次校验permission对自己和permissionTargeted对他人处理器解析参数并调用execute返回本地化后的结果或错误消息。所以遇到失败依次检查报 no permission → 回到场景一补权限注意others节点参数错 → 用/help 命令对照usage格式目标问题 → 确认目标 UID 在线/离线状态符合命令的targetRequirement仍然不行 → 看服务端日志并核对你跑的版本与资源文件是否匹配。命令速查表命令用途备注/help [命令名]查看命令列表 / 单条命令详情含别名与权限要求第一顺位工具/permission UID add\|remove\|clear\|list管理玩家权限通配符支持*、**、-排除/list在线玩家列表无需权限节点也能在控制台用/kick UID//ban UID [秒] [原因]踢人 / 封禁误封用/unban/give ID [lv] [r] [x] [c] [sl]发物品、角色、圣遗物别名/g、/item/tp x y z [sceneId]坐标/场景/玩家传送别名/teleport/weather [ID] [类型]查询/设置天气别名/w/announce [内容]全服公告见 AnnounceCommand.java下一步官方文档入口docs/README_zh-CN.md贡献与二次开发规范CONTRIBUTING.md插件 API扩展服务端功能plugin 包建议把/help当字典随身查跑通场景一到三之后你的私服基本就能自转了。【免费下载链接】GrasscutterA server software reimplementation for a certain anime game.项目地址: https://gitcode.com/GitHub_Trending/gr/Grasscutter创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考