Mysword Bible Engine

MySword Bible Engine — Referência Definitiva

Fonte: https://mysword.info/modules-format © Riversoft Systems 2011–2026
App atual: MySword 16.9 (fev/2026) — Versão Web: 2.2
Confirmado por: BibleSupport forum (query real interna), AndBible wiki, migration tools docs

📁 Estrutura de Diretórios Completa

mysword/                   ← base configurável (padrão: /storage/emulated/0/mysword/)
├── bibles/                → *.bbl.mybible
├── commentaries/          → *.cmt.mybible
├── dictionaries/          → *.dct.mybible
├── books/                 → *.bok.mybible
├── journals/              → *.jor.mybible
├── journalsbig/           → *.jor.mybible  (>10MB — sync semanal)
├── mydata/                → DADOS DO USUÁRIO (ver skill mysword-user-data)
│   ├── bookmarks.mybible
│   ├── highlight.mybible
│   ├── format.mybible
│   ├── settings.mybible
│   ├── tags.mybible
│   ├── verselist.mybible
│   ├── default.xrefs.twm
│   ├── mapgeodata.mybible
│   └── peopledata.mybible
└── notes/
    └── versenotes.mybible

📦 Tipos de Módulo e Extensões

Módulos Nativos MySword

Módulos de Terceiros Suportados

🗄️ Schema Completo — Tabela Details (1 registro em TODOS os módulos)

CREATE TABLE Details (
    Title           TEXT,
    Abbreviation    TEXT NOT NULL,  -- SEM ESPAÇOS (espaço = delimitador em links)
                                    -- Usar _ ou - (ex: "KJV-Strong", não "KJV Strong")
    Description     TEXT,
    publisher       TEXT,
    author          TEXT,
    creator         TEXT,
    source          TEXT,
    Language        TEXT,           -- ISO 3-letter: "por", "eng", "heb", "grk"
    RightToLeft     INTEGER DEFAULT 0,  -- 0=LTR, 1=RTL
    VersionDate     TEXT,           -- YYYY-MM-DD
    OT              INTEGER DEFAULT 0,
    NT              INTEGER DEFAULT 0,
    Apocrypha       INTEGER DEFAULT 0,
    Strong          INTEGER DEFAULT 0,   -- Bible: tem Strong's | Dict: é dicionário Strong's
    Interlinear     INTEGER DEFAULT 0,   -- 1 = é Bíblia interlinear
    paragraphindent INTEGER DEFAULT 1,   -- 1=com indent em modo parágrafo
    VerseRules      TEXT,    -- Regex de transformação, campos separados por TAB (\t)
    wordnanc        TEXT,    -- campo sem acentos para busca (dict)
    relativeorder   TEXT,    -- ordem alternativa de entradas (dict)
    CustomCSS       TEXT,    -- CSS injetado em todo o conteúdo
    readOnly        INTEGER DEFAULT 0    -- 1=somente leitura
);

🗄️ Schema — Tabela Bible com Índice Real

CREATE TABLE Bible (
    Book      INTEGER NOT NULL,  -- 1=Gênesis … 66=Apocalipse (67+ apócrifos)
    Chapter   INTEGER NOT NULL,  -- 1-based
    Verse     INTEGER NOT NULL,  -- 1-based; Verse=0 = título de capítulo
    Scripture TEXT    NOT NULL   -- texto com GBF tags
);

-- ÍNDICE OBRIGATÓRIO — usado internamente pelo MySword
CREATE INDEX "bible_key" ON "Bible" ("Book" ASC, "Chapter" ASC, "Verse" ASC);

-- FTS (módulos Premium)
CREATE VIRTUAL TABLE Bible_FTS USING fts4(Scripture, content=Bible, tokenize=porter);

⚡ A Query Exata que MySword Usa Internamente

-- Confirmado no BibleSupport forum (query real do app)
SELECT verse, scripture, rowid FROM bible WHERE book=? AND chapter=? ORDER BY verse

Inclui rowid para JOIN com FTS. Sua engine deve fazer o mesmo para compatibilidade.

🗄️ Schema — Tabela Commentary

CREATE TABLE Commentary (
    Book        INTEGER NOT NULL,
    Chapter     INTEGER NOT NULL,
    FromVerse   INTEGER NOT NULL,
    ToVerse     INTEGER NOT NULL,
    Data        TEXT NOT NULL      -- HTML puro
);

Query correta:

-- ⚠️ Usar range, não igualdade!
SELECT Data FROM Commentary
WHERE Book=? AND Chapter=? AND FromVerse<=? AND ToVerse>=?
ORDER BY FromVerse ASC

🗄️ Schema — Tabela Dictionary

CREATE TABLE Dictionary (
    Word TEXT NOT NULL PRIMARY KEY,  -- ex: "H2617", "G5485"
    Data TEXT NOT NULL               -- HTML puro
);

🗄️ Schema — Tabela Books e Tabela Journal

CREATE TABLE Books (
    BookName    TEXT NOT NULL,
    ChapterName TEXT,
    Data        TEXT NOT NULL
);

CREATE TABLE Journal (
    Topic TEXT NOT NULL PRIMARY KEY,
    Note  TEXT NOT NULL
);

🏷️ GBF Bible Tags — Todos os 30+ Tags Oficiais

Usado exclusivamente na coluna Scripture da tabela Bible.
Convenção: abertura = MAIÚSCULAS; fechamento = Primeira+minúsculas.

Formatação de Texto

Estrutura e Títulos

Formatação Poética

<PI#>   = indent do parágrafo (0–7)
<PF#>   = indent da primeira linha (0–7)

<PI1><PF1>  → indentação completa
<PI1><PF0>  → hanging indent
<PI0><PF1>  → parágrafo normal

Strong's e Morfologia (auto-fechados)

Notas e Cross-References

Tags Interlineares (módulos com Details.Interlinear=1)

Exemplo real HiSB Gênesis 1:1:

<Q><H><wh>בְּ<D>רֵאשִׁ֖ית<WH7225><h><X>be·re·Shit<x><T>In the beginning<t><q>
<Q><H><wh>בָּרָ֣א<WH1254><h><X>ba·Ra<x><T>created<t><q>

⚙️ VerseRules (campo Details.VerseRules)

Aplicado antes de qualquer parse GBF. Separador = TAB \t (não espaço!).

<RegEx>\t<Replacement>[\t<AlternativeReplacement>\t<ToggleName>]

Exemplos reais (do módulo Byzantine 2005++):

<font color=(blue|red)>(.*?)</font>\t<span class='$1'>$2</span>
<O>(.*?)<o>\t<span class='orange'>$1</span>
<K>(.*?)( )?<k>\t<span class='red' dir='rtl'>[</span>$1<span class='red' dir='rtl'>]</span>$2

⚠️ ARMADILHA: Separador = TAB. rule.split("\t") não rule.split(" ").
⚠️ ORDEM: VerseRules → Tokenizer → Parser. Inverter quebra tudo.

🔗 Sistema de Hyperlinks (módulos non-Bible)

🎨 Sistema de Cores CSS

Classes: red  orange  brown  yellowgreen  green  bluegreen  blue  violet  purple  pink  gray

/* CustomCSS com funções dinâmicas */
.color1 { color: @orange; }
.color2 { color: @darken(@red, 20%); }
.ot     { color: @lighten(@blue, 10%); font-style: italic; }
.color3 { color: @adjust(@red, 15, 20%, -20%); }
/* @body = cor atual do corpo */

🔍 FTS — Tipos de Busca

🔧 Engine de Leitura — Implementação Kotlin

// ✅ Abrir read-only + NO_LOCALIZED_COLLATORS
val db = SQLiteDatabase.openDatabase(
    filePath, null,
    SQLiteDatabase.OPEN_READONLY or SQLiteDatabase.NO_LOCALIZED_COLLATORS
)

// ✅ Índice obrigatório (criar se ausente — compatibilidade com módulos externos)
fun ensureBibleIndex(db: SQLiteDatabase) {
    try {
        db.execSQL("""CREATE INDEX IF NOT EXISTS "bible_key" ON "Bible" ("Book" ASC, "Chapter" ASC, "Verse" ASC)""")
    } catch (e: SQLiteException) { /* Já existe ou read-only — ignorar */ }
}

// ✅ A query exata do MySword (inclui rowid para FTS JOIN)
fun loadChapter(db: SQLiteDatabase, book: Int, chapter: Int): List<Triple<Int, String, Long>> =
    db.rawQuery(
        "SELECT verse, scripture, rowid FROM bible WHERE book=? AND chapter=? ORDER BY verse",
        arrayOf(book.toString(), chapter.toString())
    ).use { c ->
        buildList {
            while (c.moveToNext()) add(Triple(c.getInt(0), c.getString(1), c.getLong(2)))
        }
    }

// ✅ Verificar e detectar tipo
fun detectModuleType(db: SQLiteDatabase): ModuleType {
    val tables = db.rawQuery(
        "SELECT name FROM sqlite_master WHERE type='table'", null
    ).use { c -> buildSet { while (c.moveToNext()) add(c.getString(0).uppercase()) } }
    return when {
        "BIBLE"      in tables -> ModuleType.BIBLE
        "VERSES"     in tables -> ModuleType.BIBLE      // MyBible!
        "COMMENTARY" in tables -> ModuleType.COMMENTARY
        "DICTIONARY" in tables -> ModuleType.DICTIONARY
        "BOOKS"      in tables -> ModuleType.BOOK
        "JOURNAL"    in tables -> ModuleType.JOURNAL
        else -> ModuleType.UNKNOWN
    }
}

🐛 Bugs e Armadilhas Documentados