← Till AdventureDesigner

Så skriver du ett äventyr för AdventureDesigner

Ett äventyr är en vanlig textfil i Markdown (.md). Du skriver texten, AdventureDesigner sköter utseendet. Allt som har med typsnitt, färger, ramar och sidbrytningar att göra bestäms av designen du väljer, så i filen skriver du bara vad något är: en scen, en hemlighet, en högläsningstext, ett brev.

Filen har två delar:

  1. Informationsdelen överst, mellan två rader med ---.
  2. Själva äventyret, i Markdown med några rollspelsblock.

Alla exempel här är hämtade från exempeläventyret Jätten Finns skuld, som finns i sin helhet i exempel/jatten-finns-skuld.md. Öppna det gärna bredvid den här texten.

1. Informationsdelen

Överst i filen, före all annan text:

---
titel: Jätten Finns skuld
överrad: EXEMPELÄVENTYR
undertitel: Ett äventyr för Väsen i Lund, allhelgonatid 1868
författare: Claude LLM
design: vasen
språk: sv
handstilar:
  johanna: {typsnitt: Homemade Apple, bläck: "#2B1D10", storlek: 12.2}
  wolf: elegant
---
Fält Krävs Betydelse
titel ja Äventyrets titel. Visas överst på första sidan och i sidhuvudet.
överrad nej Liten rad ovanför titeln, till exempel EXEMPELÄVENTYR.
undertitel nej Rad under titeln.
författare nej Den som skrivit äventyret.
design ja Mappnamnet på designen, till exempel vasen.
språk nej sv eller en. Styr de texter programmet skriver själv (Scen, Plats, Dela ut handout …), avstavning och citattecken. Standard är sv.
sidbrytning nej design (standard) eller kompakt. Se avsnitt 9.
handstilar nej Handstilar för handouts, en per person som skriver brev. Se avsnitt 7.

Tänk på:

2. Vanlig text

Du skriver Det blir
En tom rad mellan två stycken Nytt stycke. Indrag sköts automatiskt.
**fet** fet
*kursiv* kursiv
- punkt Punktlista
1. steg Numrerad lista. I Väsen-designen används den för nedräkningar.
<!-- anteckning --> Syns inte i PDF:en. Bra för egna anteckningar.

Du behöver aldrig dra in stycken, lägga in extra tomma rader för luft eller tänka på sidbrytningar. Det gör designen.

3. Rubriker och scener

Du skriver Det blir
## Vad som faktiskt har hänt Kapitelrubrik, över båda spalterna
### Platser i staden Underrubrik
#### Stenhuggarboden Mellanrubrik
## Scen: Under Helgonabacken {typ=Möte} Scen, numreras automatiskt

Titeln skriver du i informationsdelen, inte som rubrik.

Scener

En scen börjar med ## Scen: följt av scenens namn. Programmet numrerar scenerna i ordning. I Väsen-designen börjar varje scen på en ny sida, med överraden SCEN 1 · MÖTE och titeln stort under.

{typ=…} är frivilligt och hamnar i överraden.

Direkt efter scenrubriken kan du skriva fält, ett per rad:

## Scen: Under Helgonabacken {typ=Möte}

Plats: Helgonabacken, öster om staden
Närvarande: Gerda under backen, eventuellt nattväktaren Bengt Lööf

Nattväktaren kan visa vägen. Sången leder till en spricka i backen …

Fälten känns igen bara när de står direkt efter scenrubriken. Vilka fältnamn som finns bestäms av designens etiketter (i Väsen: Plats: och Närvarande:, på engelska Location: och Present:).

Ny sida och katastrofer

4. Hemligt, publikt och fyll på

Börja ett stycke, en listpunkt eller en tabellcell med en markering:

[hemligt] Det legenden inte berättar är att skulden aldrig betalades.

- [publikt] Finns högra hand saknar ett finger. Brottytan är färsk och vit.
- [hemligt] Den som rör vid Finn får ett skräckslag mot Fear 2.

[fyll på] Vad händer om sällskapet tar med sig Lindell, och han försöker ta något från grottan?
Markering Betyder I Väsen-designen
[hemligt] Bara spelledaren vet Röd text med röd linje till vänster
[publikt] Rollpersonerna kan få veta Grön text med grön linje till vänster
[fyll på] Något som saknas och ska skrivas senare Orange kursiv text, inleds med Fyll på:

[fyll på] är bra medan man skriver: det syns tydligt i utskriften vad som återstår.

5. Block

Block börjar med ::: och ett namn, och slutar med ::: på en egen rad. Allt mellan raderna hör till blocket och kan innehålla vanlig Markdown.

::: läs
Det är allhelgonaafton och dimman ligger tät över Lund.
:::

Alla block

Block Används till
::: läs Text som läses upp för spelarna
::: magi Magi och ritualer
::: strid Strid
::: tillstånd Tillstånd
::: frågor Frågor att ställa till spelarna eller sig själv
::: ram Egen rubrik En ram med rubrik du väljer själv
::: secret Ruta med det som är hemligt i ett större sammanhang
::: epigraf Inledande citat
::: person Namn Personkort
::: väsen Namn Stat-block för ett väsen eller en motståndare
::: handout id Titel Handout (avsnitt 7)
::: helbredd Innehåll som ska gå över båda spalterna, till exempel en stor tabell

Rubrikerna på ramarna (Läs upp, Magi, Strid …) skrivs ut automatiskt på det språk du valt.

Läs upp

I ::: läs blir varje radbrytning kvar, så en vers kan skrivas rad för rad:

::: läs
*Sov nu, Gerda, i bergets famn,*
*far bygger högt där solen står.*
:::

Egen ram

::: ram Specialregel: Att ropa en jättes namn
När en rollperson ropar ut **Finn** mot jätten, med full övertygelse, slår hen **Empati + Inspiration**.
:::

Epigraf

Avsändaren skrivs på sista raden, efter ett tankstreck:

::: epigraf
Han skall hafva sol och måne för sitt arbete, eller ock byggherrens ögon.
— Anteckning i marginalen till Wolfs krönika, okänd hand
:::

Personkort

::: person Johanna Strandh
Replik: Jag har sopat kring hans fötter i trettio år.
Plats: Domkyrkan och vaktmästarbostaden

Kyrkvaktmästare, änka, runt femtio. Praktisk, troende och inte lättskrämd, men nu rädd.

[hemligt] Hon har själv hört vaggvisan.
:::

Replik: och Plats: är frivilliga. Personkort som står direkt efter varandra ställs automatiskt två i bredd.

Stat-block

Skriv ett värde per rad, med namnen som i designens etiketter (på svenska eller engelska):

::: väsen Jätten Finn
Might: 6
Body Control: 2
Magic: 3
Manipulation: 2
Fear: 4

En jätte av grå kalksten som sakta lösgör sig från sin pelare.
:::

Raderna med värden blir stat-raden, i den ordning designen bestämmer. Text efter en tom rad blir vanlig text under. Ramar för magi och strid, och en secret-ruta, skriver du som vanliga block efter stat-blocket.

Block i block

Behöver du ett block inuti ett annat, ge det yttre blocket fyra kolon:

:::: väsen Jätten Finn
Might: 6

::: strid
Finn anfaller bara den som står mellan honom och slutstenen.
:::
::::

6. Tabeller, bilder och kartor

Tabeller

| Tid | Händelse |
| --- | --- |
| 1100-talet | Finn bygger domkyrkan och blir sten i kryptan. |
| 1654 | Krönikören Wolf skriver ner sägnen. |

Bilder

![Domkyrkan i dimma](https://exempel.se/domkyrkan.jpg)

![Kryptans pelare](bilder/kryptan.png)

Kartor

Börja bildtexten med karta::

![karta: Domkyrkan och Helgonabacken](kartor/lund.png)

Kartan får en egen sida med en ram i designens stil och namnet som rubrik.

Använd bilder med hög upplösning. Programmet varnar om en bild blir suddig i utskrift.

7. Handouts

En handout skrivs en gång, där den hör hemma i texten. Den syns sedan på två ställen:

Skriva en handout

::: handout johannas-brev Johanna Strandhs brev {hand=johanna}
Lund d. 30 October 1868

Ärade herrar,

jag vet icke till hvem annars jag skall vända mig.

Kom före söndagens högmässa. Fråga efter mig vid södra porten.

— Johanna Strandh
Kyrkvaktmästare vid Lunds domkyrka
:::

Hänvisa till en handout

Skriv [handout: id] där spelarna ska få handouten:

Sällskapet har kallats hit genom ett brev från kyrkvaktmästaren.

[handout: johannas-brev]

Det blir raden Dela ut handout #1, som också är en klickbar länk till handoutsidan.

Numren sätts automatiskt i den ordning handouts först nämns i texten. Lägger du till ett brev tidigt i äventyret räknas alla nummer om. Skriver du fel id, eller skriver en handout som aldrig delas ut, får du en varning.

Inställningar

Inställningar står inom { } sist på handoutens första rad, med mellanslag mellan:

Inställning Exempel Betydelse
hand hand=johanna Handstil. Ett namn från informationsdelen eller designens egna (tung, elegant i Väsen).
papper papper=pergament Pergamentpapper i stället för vitt.
bredd bredd=150 Arkets bredd i mm.
lutning lutning=-0.6 Hur mycket arket lutar, i grader. Plus lutar medurs.
samma-sida samma-sida Lägg handouten på samma sida som den förra.

Exempel med flera inställningar:

::: handout wolfs-kronika Ur Wolfs krönika, avskrift {hand=wolf papper=pergament lutning=-0.6}

Handstilar

En handstil kan du hämta från designen eller göra själv i informationsdelen:

handstilar:
  johanna: {typsnitt: Homemade Apple, bläck: "#2B1D10", storlek: 12.2}
  wolf: elegant

wolf: elegant använder designens handstil elegant rakt av. johanna får eget typsnitt, egen bläckfärg och storlek. Varje person som skriver brev i äventyret kan ha sin egen handstil.

8. Allmänna regler

9. Sidbrytningar

Designen bestämmer var nya sidor börjar, men programmet undviker tomma halvsidor.

I Jätten Finns skuld blir det 9 sidor med designens sidbrytningar och 8 med sidbrytning: kompakt.

10. Komplett exempel

Hela exempeläventyret finns i exempel/jatten-finns-skuld.md. Här är en förkortad version som visar de flesta delarna:

---
titel: Jätten Finns skuld
överrad: EXEMPELÄVENTYR
undertitel: Ett äventyr för Väsen i Lund, allhelgonatid 1868
design: vasen
språk: sv
handstilar:
  johanna: {typsnitt: Homemade Apple, bläck: "#2B1D10", storlek: 12.2}
---

::: epigraf
Han skall hafva sol och måne för sitt arbete, eller ock byggherrens ögon.
— Anteckning i marginalen till Wolfs krönika, okänd hand
:::

## Vad som faktiskt har hänt

För sju hundra år sedan byggde jätten Finn domkyrkan i Lund åt den helige Lars …

[hemligt] Det legenden inte berättar är att skulden aldrig betalades.

## Personer i Lund {nysida}

::: person Johanna Strandh
Replik: Jag har sopat kring hans fötter i trettio år.
Plats: Domkyrkan och vaktmästarbostaden

Kyrkvaktmästare, änka, runt femtio.

[hemligt] Hon har själv hört vaggvisan.
:::

::: person Per Månsson
Replik: Det var bara puts. Bara gammal puts.
Plats: Stenhuggarboden vid Kyrkogatan

Stenhuggare från Dalby, stor och skamsen.
:::

## Väsendena {nysida}

::: väsen Jätten Finn
Might: 6
Body Control: 2
Magic: 3
Manipulation: 2
Fear: 4

En jätte av grå kalksten som sakta lösgör sig från sin pelare.
:::

::: secret
Finn kan stoppas på tre sätt: skulden betalas, hans namn ropas i solljus, eller någon offrar sina ögon.
:::

## Förberedelsefas {nysida}

::: läs
Det är allhelgonaafton och dimman ligger tät över Lund.
:::

Sällskapet har kallats hit genom ett brev från kyrkvaktmästaren.

[handout: johannas-brev]

::: handout johannas-brev Johanna Strandhs brev {hand=johanna}
Lund d. 30 October 1868

Ärade herrar, kom före söndagens högmässa.

— Johanna Strandh
Kyrkvaktmästare vid Lunds domkyrka
:::

### Nedräkning

1. Kl. 22: Sången från Helgonabacken börjar.
2. Kl. 02: Ett dån hörs från domkyrkan.
3. Kl. 06: Malmros går till kyrkan för att lägga slutstenen.

## Scen: Under Helgonabacken {typ=Möte}

Plats: Helgonabacken, öster om staden
Närvarande: Gerda under backen

::: läs
Två ögon, stora som brunnslock, öppnas och ser på er.
:::

#### Kyrkan rämnar {katastrof}

Varje runda faller sten från taket.

[fyll på] Karta över domkyrkan och Helgonabacken.

AdventureDesigner 0.2.2