F Minecraft Mod

一个用于管理的Minecraft模组

管理

F Minecraft Mod

一个用于管理的 Minecraft 模组。

注意

这是一个服务端模组,即使客户端没有安装也能正常工作。

所有功能默认禁用,可通过命令或配置文件进行配置。

功能

通知

跟踪对管理员或你的朋友有用的事件。

  • 超过阈值时的实体数量警告
  • 自动实体密度分析
  • 玩家死亡坐标
  • Boss、命名实体和杀手生物死亡
  • 检测 AFK 状态
  • 带有距离和生命值的弹射物命中消息
  • Boss 战信息
  • 快速旅行检测
  • 传送通知
  • 生物群系变化通知
  • 睡眠时间提醒

所有通知消息均可配置。

玩家信息命令

获取并分享详细的玩家信息:

  • 坐标和距离
  • 生命值、饥饿值、饱和度、经验值
  • 物品栏内容(带悬停详情)
  • 当前手持物品
  • 旅行统计

音符盒歌曲播放器

在游戏内向玩家播放 Note Block Studio(.nbs)歌曲。

  • 向特定玩家或所有在线玩家播放歌曲
  • 控制播放速度和位置
  • 在动作栏中显示/隐藏进度
  • 暂停、恢复和停止播放

GPT 集成

直接在游戏内与大型语言模型聊天,支持 Markdown 语法高亮。

  • 支持 OpenAI 兼容 API
  • 对话历史管理
  • 系统提示和温度控制
  • 多种语言的代码块语法高亮

流程系统

使用游戏内基于节点的流程图引擎构建自定义自动化。无需重启服务器即可创建、编辑和执行逻辑流程。

  • 事件触发器(玩家操作、实体事件、计划任务等)
  • 算术、条件和数据操作节点
  • 将流程保存和加载为 .flow 文件
  • 服务器启动时自动加载流程

自定义规则系统

从游戏事件创建规则,评估条件,并自动运行操作。

  • 使用 /f rule 创建、编辑、启用和删除规则
  • 事件 -> 条件 -> 操作流水线,为满足和不满足的条件分别设置操作
  • 将规则保存和加载为 .rule 文件
  • 带 Tab 补全和公式条件的参数化规则组件
  • 规则触发历史、执行日志以及测试/触发命令
  • 服务器启动时自动加载规则

可视化编辑器

在客户端编辑流程和规则(需要 Mod Menu,仅限单人游戏)。

  • 规则编辑器,包含事件选择器、条件/操作部分、公式框和生成的参数控件
  • 流程编辑器,支持可拖动节点、连接和撤销/重做
  • 两个编辑器均支持客户端撤销/重做

使用指南

所有命令均以 /f 开头,除非另有说明,否则需要 OP 权限。

基本命令

  • /f - 显示模组版本信息
  • /f reload - 重新加载配置文件
  • /f options - 查看或更改模组设置

Say 命令

使用富文本格式和动态占位符向所有玩家广播消息(无需 OP):

/f say <message>

格式代码:

使用带有 & 前缀的 Minecraft 颜色代码:

  • &0-&f - 颜色
  • &l - 粗体,&o - 斜体,&n - 下划线,&m - 删除线,&k - 混淆
  • &r - 重置格式

自定义样式:

  • ${color:RRGGBB} - 应用十六进制颜色(例如 ${color:FF5733})
  • ${link:url} - 创建可点击的 URL 链接
  • ${copy:text} - 创建点击复制文本
  • ${hint:text} - 添加悬停提示
  • ${suggest:command} - 点击时建议命令
  • ${markdown} - 将内容解析为 Markdown

玩家占位符:

  • ${player} - 玩家显示名称
  • ${health}, ${hp} - 当前生命值
  • ${maxhealth}, ${maxhp} - 最大生命值
  • ${level} - 经验等级
  • ${hunger} - 饥饿值
  • ${saturation} - 饱和度
  • ${x}, ${y}, ${z} - 玩家坐标
  • ${pitch}, ${yaw} - 玩家朝向
  • ${biome} - 当前生物群系
  • ${coord} - 格式化坐标
  • ${mainhand}, ${offhand} - 手持物品

示例:

  • /f say &a你好 &b${player}&a!你的生命值为 ${hp}/${maxhp}
  • /f say ${color:FF5733}警告!${player} 位于 ${coord}
  • /f say 看看这个:${link:https://example.com}${hint:点击打开}点击这里!
  • /f say ${suggest:/tp @s yourName}${hint:点击建议传送}点击传送到我的位置

GPT 命令

首先在配置中配置 GPT 服务器 URL 和 API 密钥。

  • /f gpt new <message> - 开始新对话
  • /f gpt reply <message> - 在当前对话中回复
  • /f gpt regenerate - 重新生成上一条回复
  • /f gpt edit <index> <text> - 编辑之前的消息
  • /f gpt history [page] - 查看对话历史

信息命令

获取其他玩家的信息:

  • /f get coord <player> - 获取玩家坐标
  • /f get distance <player> - 获取与玩家的距离
  • /f get health <player> - 获取玩家生命值
  • /f get status <player> - 获取综合状态
  • /f get inventory <player> - 查看玩家物品栏
  • /f get item <player> - 查看手持物品
  • /f get crowd [number] [radius] - 查找最拥挤的实体区域

分享你自己的信息(无需 OP):

  • /f share coord - 分享你的坐标
  • /f share distance - 分享与他人的距离
  • /f share health - 分享你的生命值
  • /f share status - 分享综合状态
  • /f share inventory - 分享你的物品栏
  • /f share item - 分享手持物品

音符盒歌曲命令

将 .nbs 文件放入 config/fminecraftmod/ 文件夹,然后:

  • /f song play <players> <song> - 播放歌曲
  • /f song get <players> - 检查播放状态
  • /f song cancel <players> - 停止播放
  • /f song seek <players> <time> - 跳转到特定时间(秒)
  • /f song speed <players> <multiplier> - 设置播放速度(例如 1.5)

流程命令

创建和管理自定义自动化流程:

  • /f flow create <name> <event_type> <first_node_name> - 创建新流程
  • /f flow list - 列出所有流程
  • /f flow enable <name> [true|false] - 启用/禁用流程
  • /f flow rename <old> <new> - 重命名流程
  • /f flow copy <source> <target> - 复制流程
  • /f flow delete <name> - 删除流程

编辑流程:

  • /f flow edit <flow> new <node_type> <node_name> - 添加节点
  • /f flow edit <flow> remove <node_name> - 移除节点
  • /f flow edit <flow> rename <old> <new> - 重命名节点
  • /f flow edit <flow> const <node> <input_index> <value> - 设置常量输入
  • /f flow edit <flow> reference <node> <input> <source> <output> - 连接节点
  • /f flow edit <flow> disconnect <node> <input> - 断开输入
  • /f flow edit <flow> next <node> <branch> <target> - 设置下一节点
  • /f flow edit <flow> final <node> <branch> - 标记为最终节点
  • /f flow edit <flow> undo - 撤销上次编辑
  • /f flow edit <flow> redo - 重做上次撤销

保存和加载流程:

  • /f flow save <name> - 保存到文件(config/fminecraftmod/)
  • /f flow save * - 保存所有流程
  • /f flow load <filename> - 从文件加载
  • /f flow load * - 加载所有 .flow 文件

触发和执行:

  • /f flow history [page] - 查看执行历史
  • /f flow log <index> - 查看详细执行日志
  • /f trigger <trigger_name> [args] - 执行触发节点(无需 OP)

规则命令

创建和管理自定义规则:

  • /f rule create <name> <event> - 创建规则
  • /f rule copy <rule> <name> - 复制规则
  • /f rule list - 列出所有规则
  • /f rule enable <name> [true|false] - 启用/禁用或查询规则
  • /f rule rename <old> <new> - 重命名规则
  • /f rule delete <name> - 删除规则

编辑规则:

  • /f rule edit <rule> event <event> - 更改事件类型
  • /f rule edit <rule> condition add <type> ... - 添加条件
  • /f rule edit <rule> condition set <formula> - 设置主条件公式
  • /f rule edit <rule> condition remove <condition> - 移除条件
  • /f rule edit <rule> condition rename <old> <new> - 重命名条件
  • /f rule edit <rule> action add <type> ... - 添加操作(条件满足时)
  • /f rule edit <rule> action remove <action> - 移除操作
  • /f rule edit <rule> action rename <old> <new> - 重命名操作
  • /f rule edit <rule> punish add <type> ... - 添加惩罚(条件不满足时)
  • /f rule edit <rule> punish remove <action> - 移除惩罚
  • /f rule edit <rule> punish rename <old> <new> - 重命名惩罚

保存、加载和调试:

  • /f rule save <name> - 将规则保存到 config/fminecraftmod/
  • /f rule save * - 保存所有规则
  • /f rule load <filename> - 加载规则文件,* 表示全部
  • /f rule view <name> - 显示规则定义
  • /f rule history [page] - 查看规则触发历史
  • /f rule log <index> - 查看详细触发日志
  • /f rule test <name> - 评估条件而不运行操作
  • /f rule trigger <name> - 触发规则并运行其操作

配置示例

使用 /f options 启用功能:

  • /f options serverTranslation [true|false] - 服务端翻译
  • /f options entityDeathMessage [location] - 实体死亡消息
  • /f options passiveDeathMessage [location] - 被动实体死亡
  • /f options hostileDeathMessage [location] - 敌对实体死亡
  • /f options playerDeathCoordLocation [location] - 玩家死亡坐标
  • /f options gptUrl [url] - GPT API 端点
  • /f options autoLoadRuleFiles [true|false] - 启动时自动加载 .rule 文件
  • /f options autoLoadFlowFiles [true|false] - 启动时自动加载 .flow 文件
  • 等等。

提示:使用 Tab 键自动补全命令。