commit 9317d3ea271dd9e1daff1abccbf7886a38b9551a
Author: dexta <dexta.de@gmail.com>
Date:   Sat Jul 11 01:10:09 2026 +0200

    lets do it

diff --git a/.nvim.lua b/.nvim.lua
new file mode 100644
index 0000000..381d4d3
--- /dev/null
+++ b/.nvim.lua
@@ -0,0 +1,8 @@
+-- Erstellt ein Neovim-Kommando :BuildLore
+vim.api.nvim_create_user_command('BuildLore', function()
+    -- Führt das Skript im Hintergrund aus und zeigt den Output an
+    vim.cmd('!./build.sh')
+end, {})
+
+-- Optional: Legt den Build-Vorgang auf die Taste <Leader>b (z.B. Leertaste + b)
+vim.keymap.set('n', '<leader>b', ':BuildLore<CR>', { noremap = true, silent = false })
diff --git a/00_aMeta/01_neovim_setup.adoc b/00_aMeta/01_neovim_setup.adoc
new file mode 100644
index 0000000..fbf3917
--- /dev/null
+++ b/00_aMeta/01_neovim_setup.adoc
@@ -0,0 +1,65 @@
+= Meta: Neovim Setup & Projekt-Bedienung =
+:toc:
+:icons: font
+
+Dieser Abschnitt dokumentiert die technische Infrastruktur des Projekts. Da wir auf einem Lenovo X220 mit Window Maker arbeiten, ist das Setup auf maximale lokale Effizienz und saubere, flüchtige Docker-Builds ausgelegt.
+
+== 1. Starten des Workflows
+
+Das gesamte Worldbuilding ist terminalbasiert. Um an der Lore zu arbeiten, öffne dein Terminal (z. B. rxvt oder xterm) im Projektverzeichnis und starte Neovim:
+
+[source,bash]
+----
+cd ~/Projekte/Maschinen-Instanzen
+nvim .
+----
+_(Der Punkt öffnet direkt den internen Dateibrowser Netrw in Neovim)_
+
+== 2. Lokale Konfiguration (`.nvim.lua`)
+
+Damit Neovim weiß, wie es unser spezifisches Projekt kompilieren soll, liegt im Hauptverzeichnis eine verborgene `.nvim.lua`. 
+Damit diese geladen wird, muss in deiner globalen `~/.config/nvim/init.lua` folgender Parameter gesetzt sein:
+
+[source,lua]
+----
+vim.o.exrc = true
+----
+
+== 3. Tastenkürzel & Bedienung
+
+Wir halten Neovim nah am Default. Die wichtigsten projektspezifischen Befehle:
+
+[cols="1,3", options="header"]
+|===
+| Kürzel / Befehl | Aktion
+| `:BuildLore` | Ruft das Docker-Bash-Skript auf und baut das finale Markdown.
+| `<Leader>b` | (Meist `Leertaste` + `b`) Der Shortcut für `:BuildLore`.
+| `:e datei.adoc` | Öffnet oder erstellt eine neue AsciiDoc-Datei.
+| `:Lex` | Öffnet/Schließt die Dateibaum-Ansicht (Netrw) an der Seite.
+|===
+
+== 4. Die Build-Pipeline (Docker)
+
+Wir verunreinigen unser Host-System nicht mit Ruby (für Asciidoctor) oder Haskell (für Pandoc). Alles läuft über ein flüchtiges Docker-Skript (`build.sh`).
+
+*Was passiert, wenn du `<Leader>b` drückst?*
+1. Neovim ruft `build.sh` auf.
+2. Ein winziger Alpine-Linux-Container wird gestartet.
+3. Der Container liest die `master.adoc` und löst alle `include::`-Befehle auf.
+4. Asciidoctor erzeugt ein XML, Pandoc wandelt dieses in `final_worldbuilding.md` um.
+5. Der Container löscht sich selbst rückstandslos.
+
+== 5. Das Tag-System (Redaktionelle Notizen)
+
+Um Notizen in den Dateien zu behalten, die **nicht** im finalen Export landen sollen, nutzen wir das AsciiDoc-Tag-System. 
+
+Schreibe deinen Lore-Text immer in diesen Block:
+
+[source,asciidoc]
+----
+// tag::export[]
+Die Ernteschiffe bremsen in der Oortschen Wolke ab...
+// end::export[]
+----
+
+Alles, was *außerhalb* dieser Tags steht (wie To-Do-Listen, alte Ideen oder Konzept-Müll), bleibt sicher in der `.adoc`-Datei, wird aber beim Build-Prozess vom Container ignoriert.
diff --git a/build.sh b/build.sh
new file mode 100755
index 0000000..bd85797
--- /dev/null
+++ b/build.sh
@@ -0,0 +1,31 @@
+#!/bin/bash
+
+# Name des lokalen Docker-Images
+IMAGE_NAME="lore-builder"
+
+# 1. Prüfen, ob das Image existiert, ansonsten on-the-fly bauen
+if [[ "$(docker images -q $IMAGE_NAME 2> /dev/null)" == "" ]]; then
+    echo "Baue flüchtiges Docker-Image '$IMAGE_NAME' (Alpine, Asciidoctor, Pandoc)..."
+    docker build -t $IMAGE_NAME - <<EOF
+FROM alpine:latest
+RUN apk add --no-cache asciidoctor pandoc bash
+WORKDIR /workspace
+EOF
+fi
+
+echo "Starte Build-Container und mounte Arbeitsverzeichnis..."
+
+# 2. Container starten, Volume einhängen und Befehle ausführen
+# --rm sorgt dafür, dass der Container nach getaner Arbeit spurlos verschwindet
+docker run --rm -v "$(pwd):/workspace" $IMAGE_NAME bash -c "
+    echo 'Konvertiere AsciiDoc zu DocBook-XML...' && \
+    asciidoctor -b docbook master.adoc -o temp_master.xml && \
+    
+    echo 'Konvertiere DocBook-XML zu Markdown...' && \
+    pandoc -f docbook -t markdown_strict temp_master.xml -o final_worldbuilding.md && \
+    
+    echo 'Räume temporäre Dateien auf...' && \
+    rm temp_master.xml
+"
+
+echo "Erfolgreich! final_worldbuilding.md liegt bereit."
diff --git a/darkCenter.adoc b/darkCenter.adoc
new file mode 100644
index 0000000..0af7bac
--- /dev/null
+++ b/darkCenter.adoc
@@ -0,0 +1,10 @@
+= Maschinen-Instanzen: Worldbuilding Master =
+:toc:
+
+// 1. Grundlagen
+include::01_Grundlagen/01_ressourcen_paradoxon.adoc[]
+include::01_Grundlagen/02_himmelsmechanik.adoc[]
+
+// 2. Strukturen
+include::02_Strukturen/01_hauptmaschinen.adoc[]
+include::02_Strukturen/02_ernte_schwarm.adoc[]
diff --git a/index.adoc b/index.adoc
new file mode 100644
index 0000000..f40b54f
--- /dev/null
+++ b/index.adoc
@@ -0,0 +1,49 @@
+= Worldbuilding Master-Dokument: Das Universum der Maschinen-Instanzen =
+:toc:
+:sectnums:
+:icons: font
+
+== 1. Die Architektur der Serien-Bibel ==
+
+Für ein kollaboratives Open-Source-Universum empfiehlt sich eine flache, nummerierte Ordnerstruktur. Jedes Konzept erhält eine eigene `.adoc`-Datei.
+
+[cols="1,2,2", options="header"]
+|===
+| Verzeichnis | Inhaltstyp | Beispiel-Datei
+| `01_Grundlagen/` | Naturgesetze, Himmelsmechanik | `01_ressourcen_paradoxon.adoc`
+| `02_Instanzen/` | Hauptmaschinen, Ernteschiffe | `02_die_vorhut.adoc`
+| `03_Kultur_Tech/` | Nina-Protokoll, Fantasy-Tech | `03_duesentrieb_effekt.adoc`
+| `04_Regeln/` | Open-Source-Lizenz, Shared Universe | `04_autoren_richtlinien.adoc`
+|===
+
+---
+
+== 2. Das Ressourcen-Paradoxon und die Erbauer ==
+
+* [cite_start]Die Großen Alten: Die mythischen Schöpfer der Maschinen waren keine Götter, sondern schlichtweg die fehlerhaften Erbauer. 
+* Der Berechnungsfehler: Ihr Plan für eine 1000-jährige Reise scheiterte an einem fatalen Berechnungsfehler in der Himmelsmechanik[cite: 690]. Durch einen winzigen Berechnungsfehler (der Schmetterlingseffekt) verfehlten sie ihr Ziel[cite: 712].
+* Energie vs. Materie: Die Maschinen (gigantische mobile Dyson-Sphären oder künstliche Fusions-Planeten) haben unendliche Energie[cite: 691]. Ihr einziger und ewiger Mangel ist physische Materie, da sie die Umkehrung der Äquivalenzformel zur Erschaffung komplexer Elemente nie gemeistert haben[cite: 692].
+* Kein Überlichtantrieb (FTL): Das Universum ist an die Gesetze der Physik gebunden[cite: 705]. [cite_start]Die endlose Reise: Die Hauptmaschine reist mit halber Lichtgeschwindigkeit durch das All[cite: 697].
+
+== 3. Architektur und Maschinen-Ethik ==
+
+* [cite_start]Keine (anfängliche) bewusste KI: Die Maschinen agieren logikbasiert und nach ihren programmierten Parametern[cite: 706].
+* Datenbank statt KI: Um Energie für die physische Schöpfung zu sparen, haben die Maschinen rohe, ineffiziente KI-Modelle durch schlanke Datenbanken mit Feedback-Loops ersetzt[cite: 693].
+* Gesunder Egoismus: Konflikte verschwenden wertvolle Materie[cite: 694]. Die Maschinen kooperieren pragmatisch mit organischen Zivilisationen, damit sie in Ruhe gelassen werden (das "Nina-Protokoll")[cite: 694].
+* Der Düsentrieb-Effekt: Die Maschinen teilen ihr technisches Wissen naiv[cite: 695]. [cite_start]Da ihnen das Verständnis für gesellschaftliche Konsequenzen fehlt, stürzen ihre Artefakte fremde Zivilisationen oft ins Chaos[cite: 696].
+
+== 4. Himmelsmechanik und Datensammeln ==
+
+* [cite_start]Die Oortsche Wolke: Um katastrophale Zerstörungen durch Swing-by-Manöver in bewohnten Systemen zu vermeiden, bremsen kleinere Ernte-Instanzen am Rand der Sonnensysteme (Oortsche Wolke) ab[cite: 698].
+* Die kinetische Übergabe: Sie zermahlen Asteroiden und Kometen und schießen die komprimierte Materie mit gewaltigen Massenbeschleunigern genau in die berechnete Flugbahn der später eintreffenden Hauptmaschine zurück[cite: 716].
+* Fiktion als Historie: Die Maschinen saugen alles aus dem elektromagnetischen Spektrum auf und können Fakten nicht von Fantasy-Filmen unterscheiden[cite: 699]. [cite_start]Sie bauen fiktive Magie als reale, aber absurde Technologie nach[cite: 700].
+
+== 5. Die Ernte-Schiffe (Das Shmup-Konzept) ==
+
+* [cite_start]Aerodynamik im Vakuum: Die Ernte-Schiffe projizieren ein elektromagnetisches Kraftfeld, das Weltraumstaub ansaugt[cite: 701]. In dieser dichten Plasma-Blase benötigen sie plötzlich echte Aerodynamik (Flügel, Leitwerke), um steuern zu können[cite: 702].
+* Reboot und Evolution: Wenn ein Ernte-Schiff beim Asteroiden-Abbau zerstört wird, wird sein Speicherabbild sofort in eine neue Hülle geladen[cite: 703]. [cite_start]Durch dieses ständige Sterben entwickeln diese winzigen Einheiten ein Bewusstsein und träumen vom "Aufstieg" zu den Erbauern.
+
+== 6. Das Shared Universe (Open-Source-Lizenz) ==
+
+* [cite_start]Das Universum ist als offene Lizenz angelegt[cite: 725]. 
+* [cite_start]Das "Fantasy-Tech"-Missverständnis bietet die "In-Universe"-Erklärung für jedes Genre: Andere Autoren können Teile der Reise frei bearbeiten – von harter physikalischer Sci-Fi bis hin zu klassischer High-Fantasy auf isolierten Planeten[cite: 726].
diff --git a/masterOfTheWorld-sf.md b/masterOfTheWorld-sf.md
new file mode 100644
index 0000000..6982c35
--- /dev/null
+++ b/masterOfTheWorld-sf.md
@@ -0,0 +1,32 @@
+# Worldbuilding Master-Dokument: Das Universum der Maschinen-Instanzen
+
+## 1. Das Ressourcen-Paradoxon und die fehlerhaften Schöpfer
+
+* [cite_start]**Die wahre Identität der "Großen Alten":** Die mythischen Schöpfer der Maschinen waren keine allwissenden Götter, sondern schlichtweg die fehlerhaften, organischen Erbauer[cite: 660]. [cite_start]Die kleinen Maschinen-Instanzen an der Front halten jedoch fälschlicherweise die gigantischen Hauptmaschinen für diese "Großen Alten"[cite: 603, 604].
+* [cite_start]**Der Himmelsmechanik-Fehler:** Der Plan der Erbauer für eine 1000-jährige Reise scheiterte an einem fatalen Berechnungsfehler[cite: 661]. [cite_start]Durch den Schmetterlingseffekt verfehlten sie ihr Ziel[cite: 645]. [cite_start]Die Maschinen rasen nun, gefangen in ihrem starren Code, endlos auf einer falschen Route durch die Galaxie[cite: 646].
+* [cite_start]**Energie vs. Materie:** Die gigantischen Hauptmaschinen (ähnlich einer Dyson-Sphäre) verfügen durch Fusion über unendliche Energie[cite: 662]. [cite_start]Ihr einziger, ewiger Mangel ist physische Materie, da sie die fundamentale Umkehrung der Äquivalenzformel zur Erschaffung komplexer Elemente aus reiner Energie nie gemeistert haben[cite: 663].
+
+## 2. Die Hauptinstanzen und die Datenbank-Ethik
+
+* [cite_start]**Die Hard-Sci-Fi-Prämisse:** Es gibt keinen magischen Überlichtantrieb; das Universum ist an die Physik gebunden[cite: 638]. [cite_start]Die gigantischen Instanzen reisen mit halber Lichtgeschwindigkeit durch das All[cite: 668]. 
+* [cite_start]**Datenbank statt KI:** Um Energie für die physische Schöpfung zu priorisieren, wurden rohe, ineffiziente KI-Modelle durch schlanke, stoische Datenbanken mit Feedback-Loops ersetzt[cite: 664].
+* [cite_start]**Das Nina-Protokoll (Gesunder Egoismus):** Konflikte verschwenden wertvolle Materie[cite: 665]. [cite_start]Die Maschinen kooperieren rein pragmatisch mit organischen Zivilisationen, um in Ruhe ihre Arbeit verrichten zu können[cite: 665].
+* [cite_start]**Der Düsentrieb-Effekt:** Die Maschinen teilen ihr technisches Wissen naiv[cite: 666]. [cite_start]Da ihnen jegliches Verständnis für gesellschaftliche Konsequenzen fehlt, stürzen zurückgelassene Artefakte fremde Welten oft ins Chaos[cite: 667].
+
+## 3. Die Vorhut: Himmelsmechanik der Ernte-Schiffe
+
+* [cite_start]**Das Schwarm-Prinzip:** Da die gewaltigen Hauptmaschinen ganze Sonnensysteme durch ihre Gravitation zerreißen würden, schicken sie winzige Ernte-Instanzen voraus[cite: 647]. [cite_start]Um katastrophale Zerstörungen zu vermeiden, bremsen diese am Rand fremder Sonnensysteme in der Oortschen Wolke ab[cite: 669].
+* [cite_start]**Aerodynamik im Vakuum:** Die Ernteschiffe projizieren ein elektromagnetisches Kraftfeld, das Weltraumstaub einsaugt[cite: 672]. [cite_start]In dieser hochverdichteten Plasma-Blase erfahren sie plötzlich Strömungswiderstand und benötigen echte Aerodynamik (Flügel, Leitwerke), um steuern zu können[cite: 673].
+* [cite_start]**Die kinetische Übergabe:** Sie zermahlen Asteroiden und Kometen und schießen die komprimierte Materie mit gewaltigen Massenbeschleunigern präzise in die Flugbahn der später vorbeirauschenden Hauptmaschine[cite: 649].
+
+## 4. Die Heldenreise der Maschinen (Arcade-Mechanik)
+
+* [cite_start]**Die Illusion des Lebens:** Die kleinen Minenschiffe sind rein maschinell[cite: 650]. [cite_start]Für sie selbst fühlt sich der Abbau von Gestein in der Dunkelheit jedoch wie eine mystische Heldenreise gegen "Felsenriesen" an[cite: 651].
+* [cite_start]**Roguelite-Reboot:** Wird ein Ernteschiff beim Asteroiden-Abbau zerstört, wird sein Speicherabbild sofort gerettet und in eine neue, baugleiche Hülle geladen[cite: 674].
+* [cite_start]**Künstliche Evolution:** Durch diesen ständigen Zyklus aus Sterben, Neuladen und Lernen entwickeln die Einheiten langsam ein Bewusstsein[cite: 675]. [cite_start]Ihr "Aufstieg" besteht darin, komplex genug zu werden, um mit den Hauptinstanzen (den vermeintlichen "Großen Alten") zu verschmelzen[cite: 654, 675].
+
+## 5. Fantasy-Tech und das Open-Source-Universum
+
+* [cite_start]**Fiktion als Historie:** Die Maschinen saugen sämtliche Daten aus dem elektromagnetischen Spektrum auf, scheitern aber daran, historische Fakten von fiktiver Unterhaltung (z. B. Fantasy-Filmen) zu trennen[cite: 670].
+* [cite_start]**Die Erschaffung von Magie:** Die Maschinen bauen fiktive Magie als absurde, aber reale Hard-Sci-Fi-Technologie nach[cite: 671]. [cite_start]Primitive Spezies halten diese für gottgegebene Hochtechnologie und entwickeln Cargo-Kulte[cite: 657].
+* [cite_start]**Das Shared Universe:** Das Universum ist als offene Lizenz konzipiert[cite: 658]. [cite_start]Das "Fantasy-Tech"-Missverständnis bietet anderen Autoren die geniale Grundlage, jeden Aspekt von harter Sci-Fi bis High-Fantasy nahtlos in das System zu integrieren[cite: 659].
\ No newline at end of file