# \ud83c\udf99\ufe0f VoskLib<\/p>\n
**VoskLib** is a high-performance, offline voice recognition library for **Minecraft Forge 1.20.1**<\/p>\n
—<\/p>\n
## \u2728 Features<\/p>\n
* **100% Offline:** No API keys or internet connection required for recognition.
\n* **Dual Modes:** Switch between **Literal Mode** (wide vocabulary) and **Grammar Mode** (constrained lists).
\n* **In-Game Model Manager:** Download and manage Vosk models directly from the mod config menu with a built-in progress bar.
\n* **Thread Safe:** Background audio processing automatically synchronized with the Minecraft main thread.
\n* **Developer Friendly:** Easy-to-use events for partial and final speech results.<\/p>\n
***<\/p>\n
## \ud83d\udee0\ufe0f Installation for Users<\/p>\n
1. Install **Minecraft Forge 1.20.1**.
\n2. Drop the jar file into your `mods` folder.
\n3. **Download a Model:**<\/p>\n
* Open the game and go to **Mods** -> **VoskLib** -> **Config**.
\n* Select a model (Small, Medium, or Large) and click **Download**.
\n* VoskLib will handle the download and extraction automatically.<\/p>\n
***<\/p>\n
## \u2328\ufe0f Keybinds<\/p>\n
* **V (Default):** Toggles voice recognition on\/off.
\n* _Configurable in the standard Controls menu under the “Vosk Voice Library” category._<\/p>\n
***<\/p>\n
## \ud83d\udcbb Developer API<\/p>\n
To use VoskLib in your project, add it to your `build.gradle` and start listening for events.<\/p>\n
### 1. Handling Speech Results<\/p>\n
VoskLib fires events on the **Forge Event Bus**. These events are already executed on the **Main Thread**, so you can safely interact with the player or world.<\/p>\n
“`
\n@SubscribeEvent
\npublic void onVoiceResult(VoskVoiceEvent.Result event) {
\n String text = event.getResult().toLowerCase();<\/p>\n
if (text.contains(“fireball”)) {
\n \/\/ Your logic: Summon a fireball in front of the player
\n }
\n}<\/p>\n
@SubscribeEvent
\npublic void onPartialSpeech(VoskVoiceEvent.Partial event) {
\n \/\/ Useful for real-time UI subtitles
\n String partial = event.getResult();
\n}
\n“`<\/p>\n
### 2. Controlling the State<\/p>\n
You can request VoskLib to start or stop listening by using:<\/p>\n
“`
\nString[] spells = {“ignite”, “freeze”, “thunder”, “heal”};
\nVoskManager.createRecognition(spells); \/\/ Create Recognition for Grammar Mode (High Accuracy for specific words)
\nVoskManager.createRecognition(); \/\/ Create Recognition for Literal Mode (General Dictation)<\/p>\n
VoskManager.startListening(); \/\/ Start Listening
\nVoskManager.stopListening(); \/\/ Stop Listening
\n“`<\/p>\n
—<\/p>\n
## \ud83d\udcdc Credits<\/p>\n
* **Vosk API:** Developed by Alpha Cephei.
\n* **Mod Author:** Infinity Two.<\/p>\n","protected":false},"excerpt":{"rendered":"
A library mod that ports VOSK to Minecraft<\/p>\n","protected":false},"featured_media":167686,"template":"","meta":{"_minecraft_slug":"vosklib","_minecraft_project_id":"XnPcX7yP","_minecraft_author":"InfinityTwoGames","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":11,"_minecraft_follows":0,"_minecraft_client_side":"required","_minecraft_server_side":"unsupported","_minecraft_storage_type":"zip","_minecraft_archive_name":"vosklib.zip","_minecraft_size_bytes":25818345,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-16T12:20:38.141968Z","_minecraft_date_created":"2026-05-12T06:16:39.642811Z","_minecraft_date_modified":"2026-03-02T01:05:40.022804Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/vosklib","_minecraft_icon_attachment_id":167686,"_minecraft_imported_at":"2026-06-09T19:10:55+00:00","_minecraft_import_hash":"cd2554bec0a3e8db125115039c617f39","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[104,873],"mod_loader":[106],"minecraft_version":[36],"class_list":["post-167685","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-forge","mod_category-library","mod_loader-forge","minecraft_version-1-20-1"],"yoast_head":"\n