数学函数

数学函数

让你使用命令或附魔来构建函数图

装饰

Math Function

中文介绍请跳往下面

用函数驱动的弹射物与图像,让数学在 Minecraft 中活起来!

License GitHub Release GitHub code size in bytes


📖 介绍

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 沿函数曲线飞行后爆炸。
烟花火箭 烟花沿曲线滑翔,并在撞到方块或实体时爆炸。
三叉戟(带激流) 玩家在水/雨中冲刺时沿函数曲线飞行 – 随时按跳跃键停止!

示例用法

  1. 获取一把弓,并为其附上 Math Function 附魔,或通过命令获得。
  2. 在铁砧中将弓重命名为 f(x)=sin(x)*2。
  3. 射出箭矢 – 它会沿美丽的正弦波飞行!
  4. 对于 TNT:将打火石重命名为 y=cos(x) 并点燃 TNT。
  5. 对于三叉戟:将带激流的三叉戟重命名为 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 或更高

📦 安装

  1. 从 Modrinth 或 GitHub Releases 下载最新的 JAR。
  2. 将其放入你的 mods 文件夹。
  3. 使用已安装 NeoForge 的 Minecraft 启动游戏。
  4. 开始构建图像或发射由函数驱动的弹射物!

⚖️ 许可证

本模组基于 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 沿函数曲线飞行,碰撞后爆炸。
烟花火箭 烟花沿曲线滑翔,碰到方块或实体时爆炸。
三叉戟(激流附魔) 玩家在水中/雨中冲刺时沿函数曲线飞行 – 按下跳跃键可随时停止!
其他弹射物(如雪球、鸡蛋等) 同样支持函数轨迹,重命名对应物品即可!

使用示例

  1. 获取一把弓,并为其附魔函数或通过命令获取。
  2. 在铁砧中将弓重命名为 f(x)=sin(x)*2。
  3. 射出箭矢 – 它将沿美丽的正弦波飞行!
  4. TNT 用法:将打火石重命名为 y=cos(x),然后点燃 TNT。
  5. 三叉戟用法:将带有激流附魔的三叉戟重命名为 f(x)=x^2/10,在水中冲刺!
  6. 雪球用法:将雪球重命名为 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 或更高

📦 安装方法

  1. 从 Modrinth 或 GitHub Releases 下载最新 JAR 文件。
  2. 放入你的 Minecraft mods 文件夹。
  3. 确保已安装 NeoForge 并启动游戏。
  4. 开始生成函数图像或发射函数弹射物!

⚖️ 法律信息

本模组采用 GNU 通用公共许可证 v3.0 发布。
你可以自由使用、修改和重新分发,但必须同样以 GPLv3 许可证公开你的修改。
详见 LICENSE 文件。


🔗 相关链接