Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/kyomega85/EnglishMatrix/llms.txt

Use this file to discover all available pages before exploring further.

EnglishMatrix ships with a rich built-in vocabulary embedded as static C# lists. All data is compiled directly into the single .cs source file and loaded into memory at startup — no database or external files are involved. This page documents what is included and how each category is used at runtime.

Summary

CategoryCountUsed in
verbList (total)191Verb reference table, verb quiz, tense table
— Regular verbs (IsRegular=true)107Verb list mode, verb quiz
— Irregular verbs (IsRegular=false)84Verb list mode, verb quiz
conjugaciones (Spanish dictionary)190Tense table, Spanish sentence output
verbsForSentences79Sentence generation only
subjects22Sentence generation
complements96Sentence generation
places31Sentence generation (optional)
times36Sentence generation (optional)
Short stories (stories)44Short stories mode (A1/A2/C1 levels)

Subjects

The subjects list contains 22 entries. All are used by GenerateSentence as sentence subjects. Third-person singular subjects (used for -s/-es conjugation and is/was/has) are: she, he, my mom, snake, mario, link, my friend, the soldier, the player, and any "the X" form not in the plural/first/second group.
EnglishSpanish
IYo
You
SheElla
HeÉl
WeNosotros
TheyEllos/Ellas
My momMi mamá
My dadMi papá
My friendMi amigo
My sisterMi hermana
My brotherMi hermano
The teacherEl maestro/La maestra
The studentEl estudiante
The catEl gato
The dogEl perro
The birdEl pájaro
The fishEl pez
SnakeLa serpiente
MarioMario
LinkLink
The soldierEl soldado
The playerEl jugador

Complement types

The complements list contains 96 entries across five semantic types. The Type field of each complement is matched against Word.Accepts on the verb before any complement is selected. See Complement compatibility for the full matching matrix.

food — 21 complements

Paired with verbs like eat, cook, order. Examples: tacos, pizza, soup, a sandwich, rice, chicken, fish, eggs, bread, cheese, an apple, a banana, milk, pasta, a hamburger, ice cream, salad, fruit, vegetables, cake, food

drink — 7 complements

Paired with verbs like drink. Examples: water, coffee, juice, tea, cola, beer, wine

thing — 35 complements

Paired with verbs like buy, find, open, use, save, read, write, watch, carry, play, build, break, fix, send, sell, choose, show, clean, drive, listen, upgrade, unlock, hack, install, brush, comb, like, paint, shop, wash. Examples: the weapon, the key, the bag, the sword, the shield, the map, the car, the phone, the book, the game, the mission, the door, the computer, the music, the house, the letter, the pen, the pencil, the paper, the notebook, the desk, the chair, the table, the bed, the bicycle, the camera, the watch, the shoes, the shirt, the pants, clothes, a shirt, a gift, a ticket, a movie

person — 15 complements

Paired with verbs like help, love, fear, miss, fight, attack, defend, call, tell, ask, meet, protect, teach, invite, talk. Examples: my friend, the enemy, my mom, my dad, my sister, my brother, my cousin, the boss, the soldier, the student, the doctor, the teacher, the nurse, the driver, the child

abstract — 18 complements

Paired with verbs like need, want, study, feel, plan. Note: the abstract type also accepts thing and person complements via the broadened matching rule. Examples: money, time, help, energy, English, math, courage, patience, happiness, love, freedom, knowledge, homework, a test, music, a story, the weather, a song

Place expressions

The places list contains 31 entries. When includePlace = true, GenerateSentence includes a place expression with 50% probability (a rnd.Next(2) == 0 coin flip). Place expressions are appended after the verb and complement.
EnglishSpanish
at homeen casa
at the storeen la tienda
in the officeen la oficina
in the baseen la base
at schoolen la escuela
in the foresten el bosque
in the cityen la ciudad
by the riverjunto al río
on the mountainen la montaña
at the gymen el gimnasio
in the castleen el castillo
in the deserten el desierto
at the parken el parque
in the laben el laboratorio
at the hospitalen el hospital
in the caveen la cueva
on the rooftopen la azotea
undergroundbajo tierra
at the restauranten el restaurante
in the kitchenen la cocina
in the bedroomen la recámara
in the bathroomen el baño
in the living roomen la sala
at the beachen la playa
at the libraryen la biblioteca
in the marketen el mercado
in the churchen la iglesia
at the bus stopen la parada de autobús
at the train stationen la estación de tren
in the caren el carro
on the busen el autobús

Time expressions

The times list contains 36 entries. When includeTime = true, GenerateSentence includes a time expression with 50% probability. Time expressions are appended after any place expression.
EnglishSpanish
every daytodos los días
at nightpor las noches
on Sundayslos domingos
on Mondayel lunes
on Tuesdayel martes
on Wednesdayel miércoles
on Thursdayel jueves
on Fridayel viernes
on Saturdayel sábado
every morningcada mañana
right nowahorita
every weekcada semana
in the afternoonpor la tarde
in the eveningpor la noche
before workantes del trabajo
after schooldespués de la escuela
on weekendslos fines de semana
last nightanoche
yesterdayayer
last weekla semana pasada
last monthel mes pasado
last yearel año pasado
tomorrowmañana
next weekla próxima semana
next monthel próximo mes
in the morningpor la mañana
in the pasten el pasado
in the futureen el futuro
for hourspor horas
at 8 o’clocka las 8 en punto
at noonal mediodía
at midnighta la medianoche
in the summeren el verano
in the winteren el invierno
in the springen la primavera
in the fallen el otoño

Verb coverage gap

The conjugaciones dictionary (190 entries) and verbList (191 entries) are nearly in full alignment. As of the current source, 4 verbs present in verbList do not have a corresponding entry in conjugaciones: hang, hit, sit, and tear. These verbs will fall back to algorithmically generated (approximate) Spanish forms in sentence generation. Additionally, 3 verbs (destroy, fear, trust) have entries in conjugaciones but are not in verbList. These verbs do appear in verbsForSentences and are used in sentence generation. When BuildSpanishVerb cannot find a verb in conjugaciones, it falls back to a generic programmatic conjugation derived from the Spanish infinitive’s ending. See How the Sentence Engine Handles Missing Conjugations for details on the fallback logic.
The VERB_ANALYSIS_REPORT.md included with the project was generated against an earlier version of the source and reports different counts (153 verbs, 134 conjugations, 64 sentence verbs, 35 missing conjugations). The figures above reflect the current state of EnglishMatrix.cs.

Build docs developers (and LLMs) love