Back to mods
VynAPI project artwork

CurseForge · Minecraft mod

VynAPI

The Vyn scripting language, embedded in Minecraft.

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which VynAPI release matches 26.1.2 Fabric?

Updated 3 months ago
Best match for your filters vynapi-fabric-26.1-26.1-1.0.0.jar
Game version 26.1, 26.1.1, 26.1.2
Loader Fabric

vynapi-fabric-26.1-26.1-1.0.0.jar targets 26.1, 26.1.1, 26.1.2 with Fabric. The project page does not say whether this file belongs on the client, dedicated server, or both. All 1 required mods have matching files.

Where it goes

Is VynAPI required on the client, server, or both?

The project page does not say whether this file belongs on the client, dedicated server, or both.

Client Source doesn’t say
Dedicated server Source doesn’t say
Loader for this release Fabric
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

The source does not explicitly classify this release as client-only or server-only.

What else does vynapi-fabric-26.1-26.1-1.0.0.jar need?

vynapi-fabric-26.1-26.1-1.0.0.jar on 26.1.2 Fabric. Every mod below is checked against that same setup.

All 1 required mods have matching files

Install Fabric API first. We found matching files for this game-version and loader setup.

Fabric API Needed by vynapi-fabric-26.1-26.1-1.0.0.jar
required
Matching file found Matched file: [26.1.2] Fabric API 0.155.3+26.1.2

We only count dependency files that match this setup. A file for another loader does not fill the gap.

Before you install it

Add VynAPI without breaking your instance.

Built for vynapi-fabric-26.1-26.1-1.0.0.jar on 26.1.2 Fabric. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use vynapi-fabric-26.1-26.1-1.0.0.jar. It targets 26.1, 26.1.1, 26.1.2 with Fabric; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    Install Fabric API first. We found matching files for this game-version and loader setup.

  3. 03

    Put it on the correct side

    The project page does not say whether this file belongs on the client, dedicated server, or both.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside vynapi-fabric-26.1-26.1-1.0.0.jar. It opens that exact file at the source.

About this project

What does VynAPI add?

Description

The Vyn scripting language, embedded in Minecraft.

Write .vyn scripts inside resource packs and have them run in-game, reacting to what happens around the player — no Java required.

✅ Minecraft 1.21.5 · 1.21.11 · 26.1 · 26.2 — Fabric · NeoForge · Forge (Forge on 1.21.x only)


📜 What is Vyn?

Vyn is a statement-driven scripting language built for readability, with blueprints (OOP) and concurrency as first-class features. It reads like English:

~ variables
make name "Steve"

~ conditionals
check name == "Steve" do
    say "Hi, Steve!"
otherwise
    say "Who are you?"
end

~ loops
cycle i from 1 to 5 do
    say "Iteration: " + i
end

~ functions
task double takes x do
    reply x * 2
end

~ blueprints (OOP)
blueprint Pet do
    build takes name do
        make me.name name
    end
end

VynAPI embeds this language inside Minecraft and connects it to the game — every resource pack becomes a potential script pack:

my_pack/
└── assets/
    └── example/
        └── scripts/
            └── hello.vyn     ← plain-text script, loaded by VynAPI

✨ What can you do with it?

  • 🎮 React to events — every tick (onTick), arm swings (onSwingHand), any sound that plays (onPlaySound)
  • 📊 Read game state — player health, hunger, position, velocity, the block you're looking at, nearby blocks, biome, time of day, colors and more
  • 🔊 Do things — draw text on the HUD (debugText), send chat messages, play sounds at positions
  • ⏱ Delayed logic — non-blocking wait statement, in ticks
  • 📦 Ship libraries — importScript / excludeScript between scripts and packs
  • ♻️ Hot reload — press F3 + T while developing; scripts reload instantly
  • 🧩 Extensible — mod developers can register custom events & functions via VynAddon

📥 Installation

  1. Download the jar matching your Minecraft version and loader (Fabric / Forge / NeoForge)
  2. Put it in your client's mods folder
  3. Launch the game and enable a resource pack that contains .vyn scripts

Quick start

task onTick do
    debugText("Health: " + player.getHealth())
    debugText("Looking at: " + player.getTargetBlock().getName())
end

Load the pack, press F3 + T — two lines appear in the top-left corner of your HUD, updating every tick.

📡 Events

Event Fires when Arguments
onTick Every client tick (20×/second) —
onSwingHand The local player swings their arm —
onPlaySound A sound plays in the world (ambient excluded) sound
task onPlaySound takes sound do
    player.sendMessage(sound.getName() + " @ " + sound.getPosition())
end

🧰 Script API (the essentials)

Constants: player · world · key · modLoader

Player: getName() · getHealth() · getFoodLevel() · getPosition() · getX/Y/Z() · getVelocityX/Y/Z() · getYaw() · getPitch() · getTargetBlock() · getSteppingBlock() · getNearbyBlocks(radius) · sendMessage(text) · playSound(id, volume, pitch) · playSoundWorld(pos, id, volume, pitch) ...

World: getBlock(x, y, z) · getDimension() · getDayTime() · getGameTime() · getBiomeAt(pos) · getGrassColor(pos) · getFoliageColor(pos) · getWaterColor(pos) · calculateDistanceBetweenPositions(a, b)

Block: getName() · getPosition() · isAir() · hasBlockTag(id) · getLightBlock() · getLightEmission() · canBeReplaced() · instrument() ...

Types: new Position(x, y, z) · new Sound(id, volume, pitch, position)

Functions: debugText(text) · importScript(packId, name) · excludeScript(packId, name)

Statement: wait <ticks> do ... end — runs a block once after N ticks, without blocking the game.

📖 Full API reference: VynAPI README

🧩 For mod developers

Subclass VynAddon to register custom events and bind native functions, types, and constants into every script environment:

public final class MyAddon extends VynAddon {

    public MyAddon() {
        super("onMyEvent"); // custom event scripts can listen to
    }

    @Override
    public Consumer<Environment> onEnable() {
        return env -> {
            NativeBinder.bind(env, MyType.class);                 // new MyType(...) in scripts
            NativeBinder.defineConstant(env, "myVersion", "1.0.0");
            env.defineFunction("myFunction", new NativeFunction((e, args) -> null));
        };
    }
}

Fire events from anywhere in your mod:

ScriptHandler.fireEvent("onMyEvent", someValue);

Any loaded script defining task onMyEvent takes value do ... end will receive it.

🔨 Building from source

# 1) Publish the Vyn engine to your local Maven repo
git clone https://github.com/Abdelaziz1586/Vyn.git
cd Vyn && mvn clean install

# 2) Build VynAPI for the version you want
git clone https://github.com/omardotcontent/VynAPI.git
cd VynAPI && git checkout 1.21.11      # or: 1.21.5, 26.1, 26.2
./gradlew :fabric:build                # or :neoforge:build / :forge:build (1.21.x only)

Important

❗ Important

  • Client-side only — install it in your client's mods folder; scripts never run on the server. Works in singleplayer and multiplayer.
  • Pick the right build — each Minecraft version has its own jar:
Minecraft Java Fabric Forge NeoForge
1.21.5 21 ✅ + Fabric API ✅ ✅
1.21.11 21 ✅ + Fabric API ✅ ✅
26.1 25 ✅ + Fabric API ❌ ✅
26.2 25 ✅ + Fabric API ❌ ✅
  • Never block the client thread — use wait instead of hold for delays, and keep onTick work light (it runs 20×/second).
  • Scripts run on the client only — everything they do is local to the player. That's by design: resource packs are client-side.

❓ Support & links

Credits: OmarDotContent & Abdelaziz_Mohamed — Vyn port by Abdelaziz_Mohamed, mod port by OmarDotContent.

Project description from CurseForge.

Pick your setup

VynAPI by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

14 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

VynAPI versions and loaders

1 of 10 releases match
Clear filters

Looking for an older file? The official CurseForge project page is in Resources.