
数学函数
让你使用命令或附魔来构建函数图
查看大图Math Function
中文介绍请跳往下面
用函数驱动的弹射物与图像,让数学在 Minecraft 中活起来!
📖 介绍
Math Function 是一个 Minecraft NeoForge 模组,将数学表达式转化为游戏中的交互式体验。无论你想把函数可视化为方块图像,还是让弹射物沿自定义曲线飞行,这个模组都能把数学之美直接带入你的世界。
一个模组,两大核心功能:
1. 方块图像生成 – 使用简单的命令,将任意函数可视化为 3D 方块结构。
2. 函数附魔 – 为武器和工具赋予自定义数学轨迹,让箭矢、TNT、烟花火箭乃至你自己的飞行都变成可控的函数曲线!
支持的函数
| 类别 | 函数 |
|---|---|
| 基础运算 | + - * / |
| 幂运算 | ^(如 x^2) |
| 一元运算符 | -x(负数) |
| 三角函数 | sin(x) cos(x) tan(x) |
| 对数 | log(x) ln(x) log(base, value) log2 log10 |
| 根号 | sqrt(x) sqrt(root, value)(如 sqrt(3, 27) = 立方根) |
| 取整 | floor(x)(向下取整)、ceil(x)(向上取整)、round(x)(四舍五入)、trunc(x)(去除小数) |
| 其他 | abs(x) exp(x) min(a, b) max(a, b) mod(a, b) |
| 随机 | Ran#(0~1)RanInt(min, max) |
| 常数 | e pi |
| 嵌套 | 3*x^2 + sin(2*x) |
自定义函数
使用 /customfunction 命令定义你自己的可复用函数!非常适合你经常使用的复杂表达式。
- 添加:
/customfunction add <name> <expression>– 例如/customfunction add square x^2 - 列表:
/customfunction list– 显示所有已保存的函数 - 查看:
/customfunction get <name>– 查看函数的定义 - 求值:
/customfunction eval <name> <x>– 快速计算值 - 修改:
/customfunction modify <name> <new_expression>– 更新函数 - 删除:
/customfunction remove <name>– 删除函数 - 全部删除:
/customfunction remove-all– 清空全部(仅限管理员)
自定义函数会保存到 custom_functions.json,并在重启后保留。它们可以在任何接受表达式的地方使用:/fx 命令、铁砧重命名和附魔轨迹。
注意:函数名称不能与内置函数(
sin、sqrt、log等)、常数(e、pi)或保留名称f(以避免与f(x)=前缀冲突)冲突。
🧪 方块图像命令
/fx "<expression>" <min_x> <max_x> <block> [scale] [mode] [coordinateSystem]
参数
| 参数 | 说明 |
|---|---|
expression |
以 x 为自变量的数学表达式(如 "x^2 + 3*x - 5")。支持 + - * / ^ sin cos tan sqrt log ln。 |
min_x、max_x |
函数的定义域(x 值)。 |
block |
用于构建图像的方块(如 minecraft:red_concrete)。 |
scale(可选) |
一个单位由多少方块表示(默认 = 1,范围 1–10)。 |
mode(可选) |
stand – 竖直图像(Y = f(x)),floor – 水平图像(Z = f(x))。 |
coordinateSystem(可选) |
true / false – 是否生成石英坐标系(原点在 (0,0),向左/下偏移 1 格)。 |
示例
/fx "x^2" -5 5 minecraft:blue_wool 2 stand true
创建一个从 x=-5 到 x=5 的蓝色羊毛抛物线,每单位 = 2 格,并带有坐标系。
⚔️ 函数附魔
将任意兼容物品重命名为 f(x)=expression 或 y=expression(例如 f(x)=x^2),附魔就会自动激活。无需命令——只需在铁砧中重命名物品!
兼容物品与行为
| 物品 | 效果 |
|---|---|
| 弓 / 弩 | 箭矢沿函数曲线 y = f(x) 飞行,其中 x 是水平距离,y 是相对发射点的高度。 |
| 打火石 | 点燃的 TNT 沿函数曲线飞行后爆炸。 |
| 烟花火箭 | 烟花沿曲线滑翔,并在撞到方块或实体时爆炸。 |
| 三叉戟(带激流) | 玩家在水/雨中冲刺时沿函数曲线飞行 – 随时按跳跃键停止! |
示例用法
- 获取一把弓,并为其附上 Math Function 附魔,或通过命令获得。
- 在铁砧中将弓重命名为
f(x)=sin(x)*2。 - 射出箭矢 – 它会沿美丽的正弦波飞行!
- 对于 TNT:将打火石重命名为
y=cos(x)并点燃 TNT。 - 对于三叉戟:将带激流的三叉戟重命名为
f(x)=x^2/10,然后在水中冲刺!
技术细节
- 初始高度自动设为 f(0),确保常函数也能正常工作。
- 实时数值微分计算切线速度,以实现平滑运动。
- 碰撞检测防止弹射物穿过方块。
- 超出范围、超时或撞击后,会干净地恢复为原版物理。
- 自 2.0 版本起支持,并随每次发布持续改进。
✨ 特性
- 实时表达式解析 – 快速可靠,无需外部库。
- 连续图像线条 – Bresenham 直线算法填补采样点之间的空隙。
- 自动间断处理 – 在无效点处断开(如
1/x在 0 附近、tan(x)在渐近线处)。 - 轴对齐放置 – 图像根据你看向的位置沿最近的轴向延伸。
- 弹射物轨迹 – 完整的基于函数的飞行,带粒子尾迹和碰撞。
- 多重射击兼容 – 使用多重射击附魔时,箭矢会略微分散。
- 默认安全 – 防止在世界高度之外渲染或超出性能限制。
- 玩家反馈 – 聊天消息显示表达式、方块名称、执行时间和原点坐标。
- 自定义函数 – 使用
/customfunction命令定义并复用你自己的数学函数。
🧩 要求
- Minecraft:1.21.1(NeoForge)
- NeoForge:21.1.176 或更高
📦 安装
- 从 Modrinth 或 GitHub Releases 下载最新的 JAR。
- 将其放入你的
mods文件夹。 - 使用已安装 NeoForge 的 Minecraft 启动游戏。
- 开始构建图像或发射由函数驱动的弹射物!
⚖️ 许可证
本模组基于 GNU 通用公共许可证 v3.0 发布。
你可以自由使用、修改和重新分发,前提是你以相同许可证共享你的修改。
详情请参阅 LICENSE 文件。
🔗 链接
中文介绍
📖 概述
Math Function 是一个 Minecraft NeoForge 模组,将数学表达式转化为游戏中的交互体验。无论是用方块生成函数图像,还是让弹射物沿自定义曲线飞行,这个模组都能让数学的美丽直接展现在你的世界里。
一个模组,两大核心功能:
1. 方块图像生成 – 通过简单的命令,将任意函数可视化为 3D 方块结构。
2. 函数附魔 – 为武器和工具赋予数学轨迹,让箭矢、TNT、烟花火箭甚至你自身的飞行都变成可控的函数曲线!
支持的函数
| 类别 | 函数 |
|---|---|
| 基础运算 | + - * / |
| 幂运算 | ^(如 x^2) |
| 一元负号 | -x(负数) |
| 三角函数 | sin(x) cos(x) tan(x) |
| 对数 | log(x) ln(x) log(底数, 真数) log2 log10 |
| 根号 | sqrt(x) sqrt(根指数, 被开方数)(如 sqrt(3, 27) = 27 的立方根) |
| 取整 | floor(x)(向下取整),ceil(x)(向上取整),round(x)(四舍五入),trunc(x)(截断小数) |
| 其他 | abs(x) exp(x) min(a, b) max(a, b) mod(a, b) |
| 随机数 | Ran#(0~1 随机小数)RanInt(min, max)(指定范围随机整数) |
| 常数 | e pi |
| 嵌套 | 3*x^2 + sin(2*x) |
自定义函数
使用 /customfunction 命令创建自己的可复用函数!非常适合经常使用的复杂表达式。
- 添加:
/customfunction add <名称> <表达式>– 例如/customfunction add square x^2 - 列表:
/customfunction list– 显示所有已保存的函数 - 查看:
/customfunction get <名称>– 查看函数定义 - 计算:
/customfunction eval <名称> <x值>– 快速计算函数值 - 修改:
/customfunction modify <名称> <新表达式>– 更新函数 - 删除:
/customfunction remove <名称>– 删除函数 - 全部删除:
/customfunction remove-all– 清空所有(需管理员权限)
自定义函数保存在 custom_functions.json 文件中,重启后依然保留。它们可以在任何接受表达式的地方使用:/fx 命令、铁砧命名和附魔轨迹。
注意:函数名称不能与内置函数(
sin、sqrt、log等)、常数(e、pi)或保留名称f(避免与f(x)=前缀冲突)重名。
🧪 方块图像命令
/fx "<表达式>" <最小值_x> <最大值_x> <方块> [缩放] [模式] [坐标系]
参数说明
| 参数 | 说明 |
|---|---|
表达式 |
以 x 为自变量的数学表达式,支持 + - * / ^ sin cos tan sqrt log ln |
最小值_x,最大值_x |
定义域(x 的取值范围) |
方块 |
构建图像所用的方块(如 minecraft:red_concrete) |
缩放(可选) |
1 个单位长度对应多少格,默认 1,范围 1~10 |
模式(可选) |
stand – 竖立图像(Y = f(x)),floor – 平铺图像(Z = f(x)) |
坐标系(可选) |
true / false,是否生成石英块坐标轴(原点位于 (0,0),向左/下偏移 1 格) |
示例
/fx "x^2" -5 5 minecraft:blue_wool 2 stand true
生成从 x=-5 到 x=5 的蓝色羊毛抛物线,每单位长度 = 2 格,并显示坐标系。
⚔️ 函数附魔
将任意兼容物品重命名为 f(x)=表达式 或 y=表达式(例如 f(x)=x^2),附魔会自动激活。无需命令,只需在铁砧中重命名即可!
兼容物品与效果
| 物品 | 效果 |
|---|---|
| 弓 / 弩 | 箭矢沿函数曲线 y = f(x) 飞行,其中 x 为水平距离,y 为相对发射点的高度。 |
| 打火石 | 点燃的 TNT 沿函数曲线飞行,碰撞后爆炸。 |
| 烟花火箭 | 烟花沿曲线滑翔,碰到方块或实体时爆炸。 |
| 三叉戟(激流附魔) | 玩家在水中/雨中冲刺时沿函数曲线飞行 – 按下跳跃键可随时停止! |
| 其他弹射物(如雪球、鸡蛋等) | 同样支持函数轨迹,重命名对应物品即可! |
使用示例
- 获取一把弓,并为其附魔函数或通过命令获取。
- 在铁砧中将弓重命名为
f(x)=sin(x)*2。 - 射出箭矢 – 它将沿美丽的正弦波飞行!
- TNT 用法:将打火石重命名为
y=cos(x),然后点燃 TNT。 - 三叉戟用法:将带有激流附魔的三叉戟重命名为
f(x)=x^2/10,在水中冲刺! - 雪球用法:将雪球重命名为
f(x)=sqrt(25-x^2),扔出后它会沿半圆形轨迹飞行!
技术细节
- 起始高度自动设为 f(0),确保常函数也能正常工作。
- 实时数值微分计算切线速度,实现平滑运动。
- 碰撞检测防止弹射物穿透方块。
- 超出范围、超时或撞击后自动恢复原版物理。
- 自 2.0 版本起支持,持续迭代优化。
✨ 特色功能
- 实时表达式解析 – 快速可靠,无需外部库。
- 连续曲线图像 – 使用 Bresenham 直线算法填充采样点间隙。
- 自动处理间断点 – 遇到无效点(如
1/x在 0 附近、tan(x)的渐近线)自动断开。 - 沿轴向放置 – 图像根据玩家面朝方向自动对齐东南西北。
- 弹射物轨迹 – 完整的函数飞行,带有粒子尾迹和碰撞处理。
- 多重射击兼容 – 使用多重射击附魔时箭矢会略微分散。
- 默认安全机制 – 限制超出世界高度或性能开销过大的情况。
- 玩家反馈 – 聊天栏显示表达式、方块名称、执行耗时和原点坐标。
- 自定义函数 – 使用
/customfunction命令定义和复用你自己的数学函数。
🧩 运行要求
- Minecraft 版本:1.21.1(NeoForge)
- NeoForge 版本:21.1.176 或更高
📦 安装方法
- 从 Modrinth 或 GitHub Releases 下载最新 JAR 文件。
- 放入你的 Minecraft
mods文件夹。 - 确保已安装 NeoForge 并启动游戏。
- 开始生成函数图像或发射函数弹射物!
⚖️ 法律信息
本模组采用 GNU 通用公共许可证 v3.0 发布。
你可以自由使用、修改和重新分发,但必须同样以 GPLv3 许可证公开你的修改。
详见 LICENSE 文件。
🔗 相关链接
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。