Math Function

# Math Function 中文介绍请跳往下面 **Bring mathematics to life in Minecraft with function-powered projectiles and graphs!** (https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0.html) (https://img.shields.io/github/v/release/aiLinMc/Math-Function)](https://github.com/aiLinMc/Math-Function/releases) (https://img.shields.io/github/languages/code-size/aiLinMc/Math-Function)](https://github.com/aiLinMc/Math-Function) --- ## 📖 Introduction Math Function is a **Minecraft NeoForge mod** that transforms mathematical expressions into interactive in-game experiences. Whether you want to visualize functions as block graphs or launch projectiles along custom curves, this mod brings the beauty of math directly into your world. ### Two Core Features in One Mod: **1. Block Graph Generation** – Visualize any function as a 3D block structure using a simple command. **2. Function Enchantment** – Apply custom mathematical trajectories to weapons and tools, turning arrows, TNT, fireworks, and even your own flight into controllable function curves! ### Supported Functions | Category | Functions | |----------|-----------| | Basic Arithmetic | `+` `-` `*` `/` | | Power | `^` (e.g. `x^2`) | | Unary Operator | `-x` (negative numbers) | | Trigonometry | `sin(x)` `cos(x)` `tan(x)` | | Logarithms | `log(x)` `ln(x)` `log(base, value)` `log2` `log10` | | Roots | `sqrt(x)` `sqrt(root, value)` (e.g. `sqrt(3, 27)` = cube root) | | Rounding | `floor(x)` (round down), `ceil(x)` (round up), `round(x)` (round to nearest), `trunc(x)` (remove decimal) | | Other | `abs(x)` `exp(x)` `min(a, b)` `max(a, b)` `mod(a, b)` | | Random | `Ran#` (0~1) `RanInt(min, max)` | | Constants | `e` `pi` | | Nesting | `3*x^2 + sin(2*x)` | ### Custom Functions Define your own reusable functions using the `/customfunction` command! This is perfect for complex expressions you use frequently. - **Add**: `/customfunction add <name> <expression>` – e.g. `/customfunction add square x^2` - **List**: `/customfunction list` – show all saved functions - **Get**: `/customfunction get <name>` – view a function's definition - **Eval**: `/customfunction eval <name> <x>` – quickly compute a value - **Modify**: `/customfunction modify <name> <new_expression>` – update a function - **Remove**: `/customfunction remove <name>` – delete a function - **Remove all**: `/customfunction remove-all` – clear all (operator only) Custom functions are saved to `custom_functions.json` and persist across restarts. They can be used anywhere expressions are accepted: `/fx` commands, anvil renames, and enchantment trajectories. > **Note**: Function names cannot conflict with built-in functions (`sin`, `sqrt`, `log`, etc.), constants (`e`, `pi`), or the reserved name `f` (to avoid conflicts with the `f(x)=` prefix). --- ## 🧪 Block Graph Command ``` /fx "<expression>" <min_x> <max_x> <block> ``` **Parameters** | Parameter | Description | |---------------------|-----------------------------------------------------------------------------| | `expression` | Math expression in terms of `x` (e.g. `"x^2 + 3*x - 5"`). Supports `+ - * / ^ sin cos tan sqrt log ln`. | | `min_x`, `max_x` | Domain of the function (x values). | | `block` | Block to build the graph (e.g. `minecraft:red_concrete`). | | `scale` (optional) | How many blocks represent one unit (default = 1, range 1–10). | | `mode` (optional) | `stand` – vertical graph (Y = f(x)), `floor` – horizontal graph (Z = f(x)).| | `coordinateSystem` (optional) | `true` / `false` – whether to generate a quartz coordinate system (origin at (0,0), shifted 1 block left/down). | **Example** ``` /fx "x^2" -5 5 minecraft:blue_wool 2 stand true ``` > Creates a blue wool parabola from x=-5 to x=5, each unit = 2 blocks, with a coordinate system. --- ## ⚔️ Function Enchantment Rename any compatible item to `f(x)=expression` or `y=expression` (e.g. `f(x)=x^2`) and the enchantment will activate automatically. No command required – just rename the item in an anvil! ### Compatible Items & Behaviors | Item | Effect | |------|--------| | **Bow / Crossbow** | Arrows follow the function curve y = f(x), where x is horizontal distance and y is height relative to launch point. | | **Flint and Steel** | Lit TNT flies along the function curve before exploding. | | **Firework Rocket** | Fireworks glide along the curve and explode upon hitting blocks or entities. | | **Trident (with Riptide)** | Player flies along the function curve during water/rain dash – press jump key to stop anytime! | ### Example Usage 1. Get a bow and enchant it with the **Math Function** enchantment or obtain it via commands. 2. Rename the bow in an anvil to `f(x)=sin(x)*2`. 3. Shoot an arrow – it wil