Nutlet

Nutlet is a lightweight, utility‑focused data pack designed to easyly creating Multi-block machines.

# Key Features ## 📖 Spell Book A book with a custom Enchantment. Players write a specific Word or Phrase on its first page, then left-click a block or attack an entity to trigger a corresponding Function.

This lets creators capture Block/Entity Interactions without relying on advancements or raycasting. Just like the function of Soft Mallet in GregTech mod.

Easy registration via the `#nutlet:spells` function tag.

## ⏰ Enhanced /schedule Extends the vanilla /schedule command by allowing you to pass NBT data to the delayed function via Command Storage.

## 🖼️ Schematic Displays Summon Block, Item, or Text Display entities that vanish after a set time—even if the chunk is unloaded. Perfect for previewing multiblock structures or giving visual feedback. The vanish function depends on the enhanced /schedule mentioned earlier.

Can specify transformation, block properties, item components, or text JSON.

Optional validity check: if the projected block doesn't match the intended state, a warning text display appears instead.

## 🔄 Orientation Helpers Functions that adjust Command Execution Context based on a block's facing direction or Command Execution Rotation.

- `nutlet:-m/facing/block`

Get Facing and Orientation of a block (furnace, piston, dispenser, crafter, etc.).

- `nutlet:-m/facing/entity`

Get the Facing Direction from Command Execution Rotation.

- `nutlet:-m/facing/block_axis_align` & `nutlet:-m/facing/entity_axis_align`

run a function after aligning Execution Angle to the faced direction, making Multi-Block Machines orientation‑agnostic.

## 🔁 UUID Conversion Converts a UUID Array (e.g., from an entity's UUID tag) into a hyphenated hexadecimal string that can be used directly in Target Selectors (e.g., /execute as 2ed128ed-5e7b-4a13-b3e0-a49b2749dbd7 run ...).

## ☀️ Brightness Calculates the light level at the Executing Position, taking into account adjacent blocks if the block itself is light‑blocking.

## ⚙️ In‑Game Configuration Register configuration options that players can Modify at In-Game using the Spell Book.

Two storage backings: scoreboard (for integers) or command storage (for any NBT).

Can define a description, valid range, or a whitelist of acceptable values.

Default values are automatically injected on first load world.

Only the First Player to obtain a Spell Book can Change settings (prevents abuse).

## 🧰 Additional Utilities - `nutlet:-m/schematic/tick`

Summon an Armor Stand that runs a Function every tick (with mutable cooldown and changable functions) for simple periodic tasks.

# For Datapack Creators Register spells via the `#nutlet:spells` function tag.

Register configuration options via the `#nutlet:configs` function tag.

Call utility functions under the `nutlet:-m/...` namespace.

Look at these two sample Datapacks to get a more detailed understanding of how to use Nutlet:

(https://github.com/PickLeaf/Nutlet-MCDatapack), (https://github.com/PickLeaf/RockGenerator-MCDatapack)

# How to install ## Datapack part 1. Open Minecraft. 2. Select the world you want to install the Datapack for, click on "Edit", then "Open world folder". 3. Open the folder named "datapacks", and put the Datapack(It should like "Nutlet_V1. 2.zip") into it. 4. Relogin the world, you will see the version of Datapack on chats.

You can use Spell Book disable print version of Datapack when relogin. ## Resourcepack part, for Localization translation 1. Open Minecraft, select "Options", then "Resource Packs", then "Open Pack Folder". 2. Put the Datapack(The Datapack file is both datapack and resourcepack) into it. 3. Back the Minecraft, select new one and Click "Done".