About Sherpa ONNX for Vintage Story
From Vintage Story ModDBAdds Sherpa ONNX support to Vintage Story. Easy to use, supporting most common operating systems.
Sherpa ONNX for Vintage Story
That's right, Sherpa ONNX is now in Vintage Story for use by any modders with crazy schemes involving text-to-voice models!
This library includes all compiled natives across all relevant operating systems, ensuring that your mod is cross-platform and ready for large servers.
WARNING: THIS IS A MOD LIBRARY | FOR USE AS A DEPENDENCY.
IF YOU'RE A NORMAL USER, DON'T DOWNLOAD THIS UNLESS ANOTHER MOD TOLD YOU TO.
THIS IS NOT A MOD, JUST SOMETHING THAT MAKES MODS WORK.
Supported Architectures:
- Windows x86
- Linux x86 (Linux ARM not supported by the game, and won't be supported by this mod at the moment)
- MacOS (x86 + Apple Silicon/ARM)
How to use:
First, add this mod as a dependency to your mod.
<pre class="language-javascript">"dependencies": { "game": "", "vssherpaonnx": "" }</pre>
Then, directly download the mod and extract VintagestoryAPI.dll onto the root (or src, or whatever you use) folder of your mod.
Once that's done, edit your CSProj to include the following:
<ItemGroup> <Reference Include="vssherpaonnx"> <HintPath>$(MSBuildProjectDirectory)\vssherpaonnx.dll</HintPath> <Private>false</Private> </Reference> </ItemGroup></pre>
Then, include the API in any files that need it.
<pre class="language-csharp">using VSSherpaOnnx;</pre>
You can now save a reference (store a variable) to the resolved Sherpa assemblies via:
<pre class="language-cpp">var sherpaAsm = VSSherpaOnnxSystem.EnsureSherpaReady(api);</pre>
That's all there is. You can now use Sherpa ONNX as you wish. You can use the code for RPTTS as an example, or look at the example below:
<pre class="language-csharp">var offlineTtsType = sherpaAsm.GetType("SherpaOnnx.OfflineTts", throwOnError: true);</pre>
Finally, here are some helper/debug print functions:
<pre class="language-csharp">static string VSSherpaOnnxSystem.GetResolvedRid() static string VSSherpaOnnxSystem.GetResolvedNativeDirectory() static string VSSherpaOnnxSystem.GetManagedWrapperPath()</pre>
Do not attempt to call the following manually:
<pre class="language-csharp">LoadFromAssemblyPath NativeLibrary.Load</pre>
Have fun!
This mod is brought to you by...

The Unofficial Vintage Story Modding Co-op, click here to join.
As modders, we can help each other make even better stuff. Plus, we have dedicated channels for better organization.
Highlights
From source dataGame versions
Supports 2 Vintage Story versions, the newest being 1.21.1.
Footprint
Rated a light load on a server.
Sherpa ONNX for Vintage Story on Nxeon
From our catalogue- One-click install
- Supported on Nxeon Vintage Story servers. We download it from Vintage Story ModDB, place it, and restart the server.
- Server side
- Required on the server
- Server load
- light
- Smallest plan we suggest
- Vintage Story — 1 GB (1 GB RAM). This follows our own load rating above, not a benchmark.
Run Sherpa ONNX for Vintage Story on a Vintage Story server
Pick a server or deploy a new one above; it is installed in one click.
What kind of mod it is
From the catalogLibraries & compatibility
Foundations and fixes other mods build on. Usually installed because something else needs it.
Runs on your server
From source side supportVintage Story ModDB lists Sherpa ONNX for Vintage Story as required on the server. Check its Vintage Story ModDB page to see whether players need it too.
Compatibility
- Game
- Vintage Story
- Runs on
- Serverrequired on the server
- Game versions
- 1.21.1 and 1 earlier
Verified at the source
- ✓Vintage Story ModDBOfficial listing, checked 2026-09-24Open ↗
- ✓AuthorYangWenLi, as published on Vintage Story ModDB
- ✓LicenseNot published by the sourceFree










