Math Function

模组

· 作者 aiLinMc

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

0 本站下载 0 关注 更新于 3 个月前

最新 2.10 · 1.21.1 · NeoForge

一键开服(送7天)

数学函数

中文介绍请跳往下面

用基于函数的投射物和图形,让 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 会在爆炸前沿函数曲线飞行。
烟花火箭 烟花沿曲线滑行,并在击中方块或实体时爆炸。
三叉戟(带有激流) 玩家在水/雨中冲刺时沿函数曲线飞行——随时按下跳跃键即可停止!

使用示例

  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) 的渐近线)。
  • 轴向对齐放置 – 图像根据你面朝的方向沿最近的 cardinal direction(基本方位)延伸。
  • 弹射物轨迹 – 基于完整函数的飞行,带有粒子尾迹和碰撞检测。
  • 多重射击兼容 – 使用多重射击附魔时,箭矢会略微分散。
  • 默认安全机制 – 防止渲染超出世界高度或超过性能限制。
  • 玩家反馈 – 聊天栏显示表达式、方块名称、执行时间和原点坐标。
  • 自定义函数 – 通过 /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 文件。


? 相关链接

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源