KubeVS: Bridge KubeJS and Valkyrien Skies 2 in Minecraft

KubeVS connects KubeJS scripting with Valkyrien Skies 2 for Minecraft, exposing ship physics data and new events to your custom scripts.

KubeVS: Unlock Valkyrien Skies 2 Scripting Power

If you have ever tried to build custom contraptions with Valkyrien Skies 2 and wished your KubeJS scripts could talk directly to the physics engine, KubeVS is the add-on you have been waiting for. This integration mod acts as a bridge between two of the most powerful systems in modern modded Minecraft, letting pack developers and tinkerers pull real ship data straight into their scripts.

What KubeVS Actually Does

At its core, KubeVS exposes extra Valkyrien Skies 2 information on Player, Level, and Server objects. That means when you write a KubeJS script, you no longer have to guess what a player's ship is doing or where a level's physics state stands. The data is right there, ready to be read and manipulated.

The add-on also hands your scripts access to three key Kotlin utility classes: VSGameUtilsKt, VectorConversionKt, and VectorConversionMCKt. These open up vector math and game utility functions that were previously locked away behind the mod's internal code. For anyone building complex flight systems, docking mechanics, or physics-driven minigames, this is a genuine game changer.

New Events for Deeper Control

Beyond raw data access, KubeVS introduces several new events that fire during gameplay. These let your scripts react to ship-related moments in real time instead of polling for changes every tick. Whether you want to trigger a sound when a vessel lifts off or adjust gravity the moment a player boards a ship, the event hooks give you the precision you need.

  • Read ship and physics data directly from Player, Level, and Server objects
  • Call VSGameUtilsKt for game-level utility functions
  • Convert and manipulate vectors with VectorConversionKt and VectorConversionMCKt
  • Listen for new events to drive dynamic, reactive gameplay

Version and Loader Support

KubeVS is built for the Forge loader and targets Minecraft 1.18.2 and 1.20.1, the two versions where Valkyrien Skies 2 and KubeJS see the most active modpack use. Because it depends on both parent mods, make sure your Valkyrien Skies 2 and KubeJS builds match the versions your pack expects before adding it to the mix.

When you download KubeVS, double-check that the file lines up with your Minecraft version and loader. Mixing a 1.20.1 build into a 1.18.2 instance is the fastest way to a crash on startup, so a quick glance at the filename saves a lot of headaches.

How to Install KubeVS

Getting started is straightforward for anyone familiar with modded Minecraft. Here is the short version of how to install KubeVS:

  • Install Forge for your chosen Minecraft version
  • Drop KubeJS and Valkyrien Skies 2 into your mods folder first
  • Add the KubeVS jar alongside them
  • Launch the game once to generate configs and confirm everything loads

If you prefer a smoother path, the foxygame.net launcher bundles KubeVS with its dependencies and handles the version matching automatically, so you can skip the manual jar hunting entirely. Once installed, open your KubeJS scripts folder and start experimenting with the exposed classes and events. The author notes that more features are still on the roadmap, so expect the toolkit to grow over time.

Who Should Use This Add-On

KubeVS is aimed squarely at pack developers, server owners, and script-savvy players. If you are simply playing a prebuilt modpack, you probably will not notice it directly. But if you are the person writing the recipes, quests, and custom mechanics behind the scenes, this add-on removes a major barrier between your ideas and the physics engine.

The combination of direct data access, utility classes, and event hooks means you can build interactions that feel native rather than bolted on. Ships that respond to scripted triggers, levels that shift physics based on player actions, and servers that track vessel activity are all within reach.

Final Thoughts

KubeVS fills a real gap in the Valkyrien Skies 2 ecosystem by making its internals scriptable through KubeJS. For Minecraft creators who want fine-grained control over ship behavior without writing a full Java mod, it is an essential tool. Grab the right build for your version, install it alongside its dependencies, and start pushing your contraptions further than ever.