Home

VynAPI – InteractiveStuff Wiki

InteractiveStuff is a client-side Fabric mod for Minecraft 1.21.1+ that adds immersive, interactive behaviors to items and blocks in first-person view — think animated held items, reactive note blocks, sculk sensors, lanterns, and much more. First-person mode is strongly recommended for the best experience.

Starting in 0.7, InteractiveStuff introduces Vyn — a built-in scripting engine that lets resource pack creators script item rendering and behavior in any way they want, with no Java required. This wiki documents the VynAPI: all the types, functions, and statements available to you in a Vyn script.

Requires: Fabric API · Optional: Mod Menu, YACL (for config UI) Download: Modrinth · Discord: Join here

---

Getting Started

Scripts interact with the game through VynTypes — objects that represent in-game data like the player, blocks, sounds, and more. Each type exposes a set of VynFunctions you can call in your scripts. Vyn uses make to declare variables, check for conditionals, cycle for loops, and task for functions.

~ Basic example: tint the held item based on the block you're standing on
make block player.getSteppingBlock()
make item player.getMainHandItem()
check block.hasBlockTag("minecraft:logs") do
    item.setColor(139, 90, 43)
end

---

Type Reference

Type	Description
Block	A block in the world — state, position, light, and properties
InteractiveStuffConfig	Read current mod configuration values at runtime
ItemModel	A renderable item model with full transform, color, and component control
Key	Utility for resolving Minecraft translation keys
ModLoader	Query loaded mods, resource packs, and game version
Player	The local player — position, health, held items, movement state, and sounds
Position	An integer X/Y/Z coordinate in the world
Sound	A sound with ID, volume, pitch, and optional position
World	The current world — blocks, biomes, time, dimension, and colors

---

Global Functions & Statements

Name	Description
importScript	Import a reusable Vyn script library
excludeScript	Disable an active script
debugText	Display debug text on screen
getDelta	Get normalized frame delta time
wait	Execute code after a tick delay