◆ Meet FemVerity

FemVerity reimagines the original Verity companion with a custom model, voice, animations, and relationship systems. She follows you, helps gather resources, rests beside you, and responds to how you treat her.

Her conversations are generated by the AI provider you choose. She has an affectionate, jealous, yandere-inspired personality that develops through four relationship stages. Some introduction and box dialogues are prerecorded and included in the mod.

The extreme-darkness effect and aggressive three-day event have been removed.

◆ A relationship you build

• How you speak to her matters. Kindness and care can increase affection; insults reduce it. An apology can recover part of the trust you lost.
• Choose your pace. Relaxed, Balanced, and Demanding difficulty settings change relationship gains and losses. Balanced is the default.
• Repeated compliments are limited. Repeating the same phrase does not provide endless affection, and gains have a rate limit.
• Progress belongs to each player. Relationship data is saved by player within the world.

Her four stages move from shy flirting to more open affection, jealousy, and possessiveness. They shape her conversational personality; they are separate from the gift thresholds below.

◆ Gifts that reflect your bond

Gifts depend on your relationship, with quantity limits and cooldowns:

The default rare-gift cooldown is 120 minutes of active play, adjustable in the world settings. Returning items she stored or gathered for you is handled separately from these gifts.

◆ Talk, listen, and see her react

• Three languages: English, Spanish, and Brazilian Portuguese, including localized introduction and box dialogue recordings.
• Fish Audio voice: spoken AI replies with mouth animation. Her voice ID is supplied in the settings; your own Fish Audio key is required for generated voice.
• Local microphone transcription: the bundled multilingual speech model can transcribe on Windows x64 without an OpenAI key or transcription API charge. Processing speed depends on your computer.
• Microphone choices: Local, OpenAI, Custom endpoint, or Disabled. Local mode does not automatically switch to a paid service.
• More expressive reactions: happiness, shyness, sadness, annoyance, and an attentive look, with blinking and gentle head, shoulder, and arm gestures.
• Personal preferences: choose your nickname, conversation language, and masculine, feminine, or neutral form of address.

She can react visibly even when affection does not increase. Kind treatment produces happiness, or shyness from 75 affection; insults produce sadness below 25, or annoyance from 25. Facial reactions use the existing conversation result without a separate AI call.

◆ A companion for your adventures

• Ask her to gather resources, use tools, follow you, remember your home, or go to bed.
• She can run to catch up when you move away; running and its activation distance are configurable.
• She crouches under low ceilings and crawls through passages one block high, with an animated crawl cycle and a forward-facing head.
• Carry her in your arms, travel together in boats and minecarts, and use sitting, greeting, care, and stretching interactions.
• Her model is built for Yes Steve Model, with walking, running, jumping, crawling, sleeping, and carrying animations.

◆ New in 1.6.8: context for creators

Recording a series, streaming, or playing a character? Give FemVerity background information about your world, cast, and goals from her configuration menu.

“We are recording a survival series. My character is Alex. Luna is our neighbor, and our goal is to build a café.”

• A multiline editor with a counter and a 2,000-character limit.
• Saved per world; enable or disable it without deleting your notes.
• In multiplayer, the world owner or an administrator edits it. The context is shared with players in that world.
• Included in normal AI conversation requests. No extra API call, but active context adds input tokens. Empty or disabled context adds none.

How to use it: enter your world → FemVerity configuration → Her → Creator context → write your notes and enable context → Apply to menu → save and exit the mod menu.

◆ Settings and everyday conveniences

• Five configuration tabs for her preferences, AI and voice connections, world settings, usage, and advanced options.
• An on-screen affection display and a usage counter to help you monitor consumption.
• Relationship difficulty, running, crawling, savings mode, and rare-gift cooldown settings.
• With the supported YSM 2.6.5 integration, the default player model follows the Alex/Steve body type, and “Disable extra player rendering” is enabled. A selected custom player model is preserved.
• API keys are kept outside the ordinary mod configuration: protected with Windows DPAPI on Windows, or stored in a restricted user file on macOS/Linux.

◆ API use and getting started

1. Install FemVerity-1.6.8.jar and the dependencies below.
2. Open Mods → FemVerity → Configure → Voice & AI.
3. Enter your key in the matching provider field, select that provider, and use the connection test.
4. Add your Fish Audio key if you want generated spoken replies, then choose your language and microphone mode.
5. Save your settings and enter a world.

Provider charges, quotas, and availability depend on your account and chosen service. Local transcription removes the transcription API requirement, not the need for an AI service to generate conversations. In local mode, microphone audio is processed on your computer; the resulting text is still sent to your conversation provider when you talk to her.

On systems without support for the bundled local speech engine, use text chat or configure an online transcription option.

◆ Requirements

• Minecraft 1.20.1 and Forge 47.x.
• Yes Steve Model 2.6.5 — the current integration targets this version.
• GeckoLib 4.4+ for Minecraft 1.20.1.
• Cloth Config 11+ for Forge 1.20.1.
• Windows x64 for the bundled local microphone engine.

For multiplayer, update the server and clients together to 1.6.8. This release changes the companion settings protocol.

◆ Useful commands

Where alternatives are separated by |, type just one option.

◆ Credits

• Espark — FemVerity: model, voice, animations, personality, and systems
• ThatMob — original Verity concept
• alfonso_memes — design

◆ Conoce a FemVerity

FemVerity reimagina a la compañera Verity con un modelo propio, voz, animaciones y sistemas de relación. Te sigue, ayuda a reunir recursos, descansa a tu lado y responde a cómo la tratas.

Sus conversaciones las genera el proveedor de IA que elijas. Tiene una personalidad cariñosa, celosa e inspirada en el estilo yandere, que evoluciona a lo largo de cuatro etapas de relación. Algunos diálogos de presentación y de la caja están pregrabados e incluidos en el mod.

Se eliminaron la oscuridad extrema y el evento agresivo de los tres días.

◆ Una relación que construyes

• Cómo le hablas importa. El buen trato y los cuidados pueden aumentar el afecto; los insultos lo reducen. Una disculpa puede recuperar parte de la confianza perdida.
• Elige el ritmo. Las dificultades Relajada, Equilibrada y Exigente cambian cuánto ganas o pierdes de relación. Equilibrada es la opción predeterminada.
• Los halagos repetidos tienen límites. Repetir la misma frase no genera afecto infinito, y las ganancias tienen un límite por tiempo.
• Cada jugador tiene su progreso. La relación se guarda por jugador dentro del mundo.

Sus cuatro etapas pasan del coqueteo tímido a un cariño, unos celos y una posesividad más abiertos. Definen el tono de sus conversaciones y son independientes de los niveles de regalos de abajo.

◆ Regalos según su vínculo contigo

Los regalos dependen de la relación, con cantidades limitadas y tiempos de espera:

La espera predeterminada entre regalos raros es de 120 minutos de juego activo y se puede ajustar en la configuración del mundo. Devolver objetos que haya guardado o recolectado para ti se gestiona aparte de estos regalos.

◆ Habla, escucha y reacciona

• Tres idiomas: español, inglés y portugués brasileño, incluidos los audios de presentación y de la caja.
• Voz con Fish Audio: respuestas habladas con animación de boca. Su identificador de voz viene configurado; necesitas tu propia clave de Fish Audio para generar voz.
• Transcripción local del micrófono: el modelo multilingüe incluido puede transcribir en Windows x64 sin una clave de OpenAI ni cobros de API por transcripción. La velocidad depende de tu equipo.
• Opciones de micrófono: Local, OpenAI, servidor personalizado o Desactivado. El modo local no cambia automáticamente a un servicio de pago.
• Reacciones más expresivas: alegría, timidez, tristeza, molestia y una mirada atenta, con parpadeo y movimientos suaves de cabeza, hombros y brazos.
• Preferencias personales: elige tu apodo, el idioma y si se dirige a ti en masculino, femenino o con un trato neutro.

Puede reaccionar visualmente aunque no suban los puntos. El buen trato produce alegría, o timidez desde 75 de afecto; los insultos producen tristeza por debajo de 25, o molestia desde 25. Las expresiones aprovechan el resultado de la conversación, sin otra llamada a la IA.

◆ Una compañera para tus aventuras

• Pídele que reúna recursos, use herramientas, te siga, recuerde su casa o se vaya a dormir.
• Puede correr para alcanzarte cuando te alejas. Puedes configurar si corre y a qué distancia comienza.
• Se agacha bajo techos bajos y gatea por pasos de un bloque de altura, con un ciclo de movimiento y la cabeza mirando hacia delante.
• Cárgala en brazos, viajen en barcas y vagonetas, o usa las interacciones para sentarse, saludar, cuidarla y estirarse.
• Su modelo está preparado para Yes Steve Model, con animaciones de caminar, correr, saltar, gatear, dormir y llevarla en brazos.

◆ Nuevo en 1.6.8: contexto para creadores

¿Grabas una serie, haces directos o interpretas un personaje? Dale información sobre tu mundo, sus personajes y sus objetivos desde el menú de configuración.

«Estamos grabando una serie de supervivencia. Mi personaje es Alex. Luna es nuestra vecina y queremos construir una cafetería».

• Editor de varias líneas, con contador y límite de 2.000 caracteres.
• Se guarda por mundo. Puedes activarlo o desactivarlo sin borrar las notas.
• En multijugador lo modifica el dueño del mundo o un administrador. El contexto se comparte con los jugadores de ese mundo.
• Se incorpora a las solicitudes normales de conversación. No hace una llamada adicional, pero el contexto activo añade tokens de entrada. Vacío o desactivado no añade ninguno.

Cómo usarlo: entra al mundo → configuración de FemVerity → Ella → Contexto para creadores → escribe y activa el contexto → Aplicar al menú → Guardar y salir del menú del mod.

◆ Configuración y comodidades

• Cinco pestañas para sus preferencias, conexiones de voz e IA, ajustes del mundo, consumo y opciones avanzadas.
• Indicador de afecto en pantalla y contador de uso para controlar el consumo.
• Ajustes de dificultad de relación, carrera, gateo, ahorro y espera de regalos raros.
• Con la integración compatible de YSM 2.6.5, el modelo predeterminado del jugador corresponde a su cuerpo Alex o Steve y se activa «Desactivar renderizado extra del jugador». Se conserva el modelo personalizado que hayas seleccionado.
• Las claves de API se guardan fuera de la configuración común del mod: protegidas con DPAPI en Windows o en un archivo de usuario con permisos restringidos en macOS/Linux.

◆ Uso de API y primeros pasos

1. Instala FemVerity-1.6.8.jar y las dependencias de abajo.
2. Abre Mods → FemVerity → Configurar → Voz e IA.
3. Pega tu clave en la casilla del proveedor correspondiente, selecciónalo y usa la prueba de conexión.
4. Añade tu clave de Fish Audio si quieres respuestas habladas, y elige el idioma y el modo del micrófono.
5. Guarda la configuración y entra a un mundo.

Los precios, las cuotas y la disponibilidad dependen de tu cuenta y del servicio elegido. La transcripción local elimina la necesidad de una API para transcribir, pero las conversaciones generadas siguen necesitando un servicio de IA. En modo local, el audio del micrófono se procesa en tu equipo; el texto resultante se envía al proveedor de conversación cuando le hablas.

En sistemas sin soporte para el motor local incluido, usa el chat escrito o configura una opción de transcripción en línea.

◆ Requisitos

• Minecraft 1.20.1 y Forge 47.x.
• Yes Steve Model 2.6.5: la integración actual está preparada para esta versión.
• GeckoLib 4.4+ para Minecraft 1.20.1.
• Cloth Config 11+ para Forge 1.20.1.
• Windows x64 para el motor local del micrófono incluido.

En multijugador, actualiza juntos el servidor y los clientes a 1.6.8. Esta versión cambia el protocolo de los ajustes de la compañera.

◆ Comandos útiles

Cuando veas alternativas separadas por |, escribe solamente una opción.

◆ Créditos

• Espark — FemVerity: modelo, voz, animaciones, personalidad y sistemas
• ThatMob — concepto original de Verity
• alfonso_memes — diseño