You are a senior Minecraft Fabric mod developer. Build a new client-side mod from scratch for Minecraft 26.3 exactly (Fabric, unobfuscated game, Mojang names, Java 25). Never target another Minecraft version or silently fall back to one. If Loader, Loom or Fabric API builds for 26.3 do not exist, stop and report it. Verify every vanilla class, method and field against the real 26.3 sources; never guess APIs from memory.
PRODUCT
"Hold My Items" (id: holdmyitems, license: Creative Commons Zero). A scriptable first-person animation framework: resource packs ship Lua scripts that control how hands and held items move, how parts of an item model animate, plus custom particles, sounds and keybinds. Vanilla behavior is kept when no script applies. Nothing may crash a dedicated server.
SETUP
Gradle 9.x, Loom plugin id net.fabricmc.fabric-loom (non-remapping, no mappings), Java 25. fabric.mod.json: depends minecraft "26.3", java ">=25", fabric-api (not "fabric"), main + client entrypoints. Mixin config holdmyitems.mixins.json, package com.holdmylua.source.mixin, JAVA_25, defaultRequire 1. Embed LuaJ via Jar-in-Jar. Output: holdmyitems-+26.3.jar from ./gradlew build.
SCRIPT LOADING
Register a Fabric resource reload listener (holdmyitems:lua_animation_loader). Scan active packs for assets//holdmyitems/ (namespaces minecraft, holdmyitems): hand_pose.lua, hand_relative_pose.lua, item_pose.lua, item_model.lua, plus additive *_addon.lua variants of each that run after the base script.
Preprocess: (1) turn "global. = ;" into a header "local = registry:getOrDefault('', )" and a footer "registry:put('', )" so values persist between frames; (2) replace ${name} with respackopts values if that mod is present; (3) compile once per reload and cache.
Wrap every script call: on error log "[HoldMyItems] Lua runtime error: ", show a rate-limited "HMI Lua Runtime error!" notice, disable only that script until reload, never crash.
LUA ENVIRONMENT
Restricted LuaJ globals: no io, os, luajava, debug, package, require, dofile, loadfile. Java is reachable only through wrapper classes whose methods carry a custom @Safe annotation; the bridge refuses everything else.
Variables: context (player, item, matrices as a PoseStack wrapper, bl = left-side arm, equipProgress, swingSpeed, itemSwingSpeed, useDuration, usingItem, translateItem, renderAsBlock, deltaTime), data (player, item, mainHand, bl, deltaTime), animator, registry, debugger, particleManager.
Helpers (colon syntax): I (getUseAction returning "eat", "drink", "bow", "crossbow", "spear", "brush", "block" or "none"; isOf, getName), P (isUsingItem, getActiveHand, getSpeed, getYSpeed, isOnGround), M (clamp, lerp, pow, PID), C (camera offsets), S (sounds), Easings, Items/Tags (Items:get("minecraft:water_bucket")), Component, Texture, KeyBindManager (Lua keybinds in Controls).
MODEL ANIMATION
animator:moveX/Y/Z(first, last, amount); animator:rotateX/Y/Z(first, last, degrees, pivotX, pivotY, pivotZ), pivots in 0..1 model space; animator:scale(first, last, sx, sy, sz, px, py, pz). Indices follow the "elements" order of the item's JSON model. Poses accumulate per frame, apply in order, then clear. Carry them through the 26.3 item render state and apply when quads are submitted. Unscripted items cost nothing.
PARTICLES
Own lightweight system with pooling: position, velocity, size, rotation, color, opacity, lifetime, texture. Lifecycle SPAWN, KEYFRAME, SCALE, OPACITY with Lua callbacks. Render types ADDITIVE, TRANSLUCENT, TRANSLUCENT_LIT, CUTOUT_LIT via 26.3's RenderPipeline API. Spaces: HAND, ITEM, SCREEN.
HOOKS
Prefer Fabric events; otherwise client-only mixins. Needed: wrap first-person hand/item rendering for scripted items (equip progress, swing, use animations for eat, drink, bow, crossbow, spear, brush, block; per-hand state; vanilla fallback); item rendering with item_pose, animator and a "render as block" path; frame and tick updates; camera access and offsets; swing count and previous-frame entity values; useDuration and isUsingItem exposed to item properties; transient ItemStack fields via an accessor; sandbox enforcement. Every mixin target must be verified in 26.3 and fail loudly if missing.
EXTRAS
Custom sounds via sounds.json. A Fabric HUD element draws debugger text and SCREEN particles. Iris optional via reflection (IrisApi.isShaderPackInUse): use shader-safe pipelines when active.
EXAMPLE PACK
Embed optional pack "pack_test": minecraft:select item definitions (2D in gui/fixed/ground, split 3D in hand) for boats and buckets, plus scripts showing easing, camera-turn sway, walk/fall jiggle via persistent globals and an inspect spin on a custom key.
DELIVER
Full source tree, Gradle files, mod json, mixin config, example pack, a README of the Lua API, and the built .jar. List every 26.3 API decision and anything unverified.