Smiley's Better Voice

🗣️ Give Verity a voice worth listening to.

A lightweight add-on for Verity JE that swaps the built-in TTS for Fish Audio or Cartesia AI — natural, expressive, and fully customizable. Verity still thinks the same way. This mod just changes how he sounds.

✨ What You Get

• 🐟 Fish Audio (default) — best quality and emotion, with in-line emotion tags
• ⚡ Cartesia AI — fastest responses and tight pronunciation accuracy
• 🧬 Support for custom & cloned voices on both providers
• 🎛️ Separate API key, voice, speed, and volume for each TTS — flip anytime without retyping
• 🎭 Automatic emotion — Cartesia detects mood from speech; Fish uses rich [emotion] tags
• 🎒 Talk while holding Verity in your inventory (toggleable)
• 🤕 Local fall sounds — no API call when Verity takes fall damage
• 💬 Friendlier on-screen error messages when a key or voice ID is missing / rejected

Pick your provider:

Cartesia emotions supported:

😐 neutral 😌 calm ☺️ content 😊 excited 😢 sad 😡 angry 😬 scared

✅ Before You Start

Make sure you already have:

⚠️ Heads up — this mod doesn't replace Verity JE, it works alongside it. You need both installed.

🚀 Quick Start (Fish Audio — recommended)

1. Drop both mod JARs into your mods folder and launch Minecraft
2. Create a free account at fish.audio
3. Grab your API key from fish.audio/app/api-keys
4. Pick a voice at fish.audio/app/discovery and copy its Voice / Reference ID
5. In-game: Mods → Smiley's Better Voice → Config
6. Toggle Enable Smiley's Better Voice on (TTS Provider defaults to Fish Audio)
7. Open the Fish Audio tab, paste your key + voice ID, hit Done
8. Say hello 👋

Prefer Cartesia instead?

1. Sign up at play.cartesia.ai
2. Get a key from play.cartesia.ai/keys and a Voice ID from play.cartesia.ai/voices
3. In config: set TTS Provider to Cartesia, then fill the Cartesia tab

🎨 Picking a Voice

Fish Audio

🔹 Browse Voice Discovery → pick a voice → copy its reference ID → paste into the Fish Audio tab.

Cartesia

🔹 Ready-made: Browse the Voice Library → three dots → copy Voice ID → paste into the Cartesia tab.

🔸 Clone your own: Instant Clone → upload a clear ~10s sample → copy the Voice ID → paste into the Cartesia tab.

⚙️ Config Options

Found under Mods → Smiley's Better Voice → Config:

General

Fish Audio tab

Cartesia tab

Saved to config/verity_cartesia-common.toml.

🎭 How Emotion Works

Fish Audio — Verity's replies can include [emotion] tags (e.g. [happy], [sad]) that Fish uses for delivery. Tags are stripped from chat text and memory so they never clutter the HUD.

Cartesia — No manual tuning needed. The mod reads:

• 💬 What Verity says (word choice, punctuation, tone)
• 😈 Verity's expression (evil, happy, serious, crazy, etc.)

🛠️ Troubleshooting

🔴 "Invalid API Key" when talking to Verity — Often a Groq/Ollama key problem in Verity JE's own config, not the TTS key. Double-check both keys are in the right place.

🟠 Silent Verity — Confirm Better Voice is enabled, Use text to speech is on in Verity JE, your provider tab has a valid key + voice ID, and you're online.

🟡 Provider error toast — Follow the on-screen hint (missing key, bad voice ID, rate limit, billing). Fish keys: api-keys. Cartesia keys: play.cartesia.ai/keys.

📌 Notes

• 🌐 Requires an internet connection while cloud TTS is active (fall sounds are local)
• 📊 Usage limits depend on your Fish / Cartesia account plan
• 🛠️ Unofficial add-on — not made by the Verity JE team

🔗 Links

Legal: Smiley's Better Voice is an unofficial, independently-coded add-on and is not affiliated with Verity JE or its creators. It requires the parent mod to be installed separately and does not copy or redistribute any of its content. The creators of Smiley's Better Voice are not responsible for the use of copyrighted material in the training of publicly accessible AI voice models. All rights to Verity JE belong to its respective owners. This isn't legal advice.