一个专注于创建多方块机器的数据包API。提供了原理图投影显示、简单的增强型/schedule功能、根据方块朝向重定向命令执行角度、UUID转换以及游戏内可调节配置。

核心功能

📖 咒法书

一本带有自定义附魔效果的书。玩家在第一页书写特定词语或短语，随后左键点击方块或攻击实体即可触发相对应功能。

此功能使创作者无需依赖进度或射线追踪即可捕捉方块/实体交互，其功能类似于GregTech模组中的软锤。

通过#nutlet:spells函数标签注册。

⏰ 增强版 /schedule

简单的增强型/schedule命令，支持通过命令存储向延迟执行函数传递NBT数据。

🖼️ 投影显示

能够召唤方块、物品或文本显示实体，在设定时间后自动消失——即使区块被卸载。完美适用于多方块结构预览或提供视觉反馈。消失功能依赖于前述的增强版/schedule命令。

可指定变换、方块属性、物品组件或文本JSON。

可选有效性检查：若投影方块与预期状态不符，将显示警告文本替代。

🔄 朝向辅助工具

根据方块朝向或命令执行角度调整命令执行上下文的函数。

• nutlet:-m/facing/block
  获取方块（熔炉、活塞、发射器、合成器等）的朝向与方位。

• nutlet:-m/facing/entity
  获取基于命令执行角度的朝向方向。

• nutlet:-m/facing/block_axis_align & nutlet:-m/facing/entity_axis_align
  将执行角度对齐至朝向方向后触发函数，使多方块机器实现方向无关性。

🔁 UUID 转换

将UUID数组（例如实体的UUID标签）转换为带连字符的十六进制字符串，可直接用于目标选择器（例如, /execute as 2ed128ed-5e7b-4a13-b3e0-a49b2749dbd7 run ...）。

☀️ 亮度

计算执行位置的光照强度，若方块本身阻挡光线，则会取相邻方块的中最亮的亮度。

⚙️ 游戏内配置

注册玩家可通过咒法书在游戏中修改的配置选项。

支持两种存储方式：记分板（整数型）或命令存储（任意NBT数据）。

可定义描述、有效范围或允许的值。

默认值将在首次加载世界时自动注入。

仅首位获得咒法书的玩家可修改设置（防止滥用）。

🧰 附加实用工具

• nutlet:-m/schematic/tick
  召唤一个护甲架，每tick执行一次函数（可调整冷却时间和改变函数），用于简单周期性任务。

面向数据包创作者

参考以下两个示例数据包，深入了解小坚果如何使用：
鸡窝，刷石机

为什么语言不是中文？

将数据包文件(Nutlet_V1.2.1.zip)当作资源包放入resourcepacks并加载即可。