Difference between revisions of "v0.13:Writing"

From Mystcraft
Jump to: navigation, search
(Grammar and Stable Writing)
(Age Templates)
 
(18 intermediate revisions by 3 users not shown)
Line 3: Line 3:
 
== Grammar and Stable Writing ==
 
== Grammar and Stable Writing ==
  
In order to write a stable age you will need to satisfy the Grammar when writing an Age. It’s best to plan out what kind of world you want in advance and make sure you satisfy as much of the grammar as possible.
+
In order to better control the results of your writing, you will need to understand the Grammar. It’s best to plan out what kind of world you want in advance and make sure you satisfy as much of the grammar as possible.
 +
 
 +
Incomplete age descriptions will be parsed by the universe (following the grammar) and then further expanded. This is similar to if you provided the words "red" "dog" "ball" and a sentence generator expanded it to "The red dog plays with the ball". The grammar expansion is random, and may form different expansions: "The red car narrowly missed the dog chasing the green ball" is an equally valid expansion.  These expansions are done similar to [https://en.wikipedia.org/wiki/Parse_tree sentence tree structures].
 +
 
 +
The more detail provided initially, the less the universe will inject new variations to what has been written. Writing "The red dog plays with the ball" leaves far fewer options for expansion; usually the remaining expansions take the form of modifiers. "The big, red dog plays with the ball" or "The red dog plays with the ball in the yard" would be valid expansions of the English sentence.
  
 
Making mistakes, including conflicting or paradoxical passages, or attempting to write an Age with overabundant resources or advantages will result in an Age with [[Instability]]. Additionally, if the grammar is unsatisfied, symbols may be added to the age which may add instability.
 
Making mistakes, including conflicting or paradoxical passages, or attempting to write an Age with overabundant resources or advantages will result in an Age with [[Instability]]. Additionally, if the grammar is unsatisfied, symbols may be added to the age which may add instability.
  
''Modifier Pages'' come before the '''Modified Page''' in the page order; similar to ''Adjectives'' and '''Nouns''' in English.
+
''Modifier Pages'' come before the '''Modified Page''' in the symbol order; similar to ''Adjectives'' and '''Nouns''' in English.
*"''Red'' '''Ball'''" is correct, whereas "'''Ball''' ''Red''" would be grammatically incorrect.
+
*"This is a ''Red'' '''Ball'''." is correct, whereas "This is a '''Ball''' ''Red''." would be grammatically incorrect.
  
 
== Standard Age ==
 
== Standard Age ==
  
A "Standard Age" layout and recommend page order example is given below. For ease of identifying which pages modify others, ''Modifier Pages will be in Italics'', '''Modified Pages shown in Bold''' and finally pages that both ''Modify'' and can be '''Modified''' will be in both '''''Bold and Italics''''':
+
A "Standard Age" layout and recommend page order example is given below. For ease of identifying which pages modify others, ''Modifier Pages will be in Italics'', '''Modified Pages shown in Bold''' and finally pages that both ''Modify'' and can be '''Modified''' will be in both '''''Bold and Italics'''''. They will also be placed in the order that they should appear with proper grammar usage (Left to Right, pages on the previous line should come before the next line):
  
 
=== Link Panel ===
 
=== Link Panel ===
Line 22: Line 26:
  
  
''Biome Pages'', '''Biome Distribution Page'''
+
<code>''Biome Pages'' '''Biome Distribution Page'''</code>
  
  
''Block Page''  
+
<code>''Block Page''(Solid) ➡ ''Block Page''(Fluid) or ''No Seas Page'' ➡ '''World Landscape Page'''</code>
*(Generates Terrain, replaces Stone/Dirt),
 
  
 +
=== Weather ===
  
''Block Page or No Seas Page''
+
<code>Weather Page or No Weather Page</code>
*(Generates Seas, replaces Water),
 
  
 +
=== Lighting ===
  
'''World Type Page'''
+
<code>Lighting Page</code>
  
=== Weather Type and Light Level ===
+
=== Celestials ===
  
Weather Page,
 
*(or replace with "No Weather" Page)
 
  
Lighting Page
+
(Optional: '''''Color Pages''''' ➡ '''''Sunset Color Page''''')
  
=== Celestials ===
+
<code>'''''Length Pages, Direction Pages, Phase Pages,''''' ➡ '''Normal Sun''', </code>
 +
*(If no Sun, replace entire with Dark Sun)
  
  
(Optional: Color Pages, Sunset Color Page)
+
(Optional: '''''Color Pages''''' '''''Sunset Color Page''''')
'''''Length Pages, Direction Pages, Phase Pages,''''' '''Normal Sun''',
 
*(If no Sun, replace entire with Dark Sun)
 
 
 
  
(Optional: '''''Color Pages''''', '''''Sunset Color Page''''')
+
<code>'''''Length Pages, Direction Pages, Phase Pages,''''' '''Normal Moon''', </code>
Length Pages, Direction Pages, Phase Pages, Normal Moon,  
 
 
*(If no Moon, replace line with Dark Moon)
 
*(If no Moon, replace line with Dark Moon)
  
  
 
(Optional: '''''Length''''' and '''''Direction Pages''''')
 
(Optional: '''''Length''''' and '''''Direction Pages''''')
'''''Color Pages''''', '''Star Page'''  
+
 
 +
<code>'''''Color Pages''''' '''Star Page''' </code>
 
*(If no stars, replace line with Dark Stars)
 
*(If no stars, replace line with Dark Stars)
  
Line 62: Line 62:
  
  
'''''Color Pages''''', '''Sky Color'''  
+
<code>'''''Color Pages''''' '''Sky Color''' </code>
 
*(Or replace line with Natural Sky Color)
 
*(Or replace line with Natural Sky Color)
  
  
'''''Color Pages''''', '''Night Sky Color'''  
+
<code>'''''Color Pages''''' '''Night Sky Color''' </code>
 
*(For Default Night Sky, use Black Color)
 
*(For Default Night Sky, use Black Color)
  
  
'''''Color Pages''''', '''Fog Color'''  
+
<code>'''''Color Pages''''' '''Fog Color''' </code>
 
*(Or replace line with Natural Fog Color)
 
*(Or replace line with Natural Fog Color)
  
  
'''''Color Pages''''', '''Cloud Color'''  
+
<code>'''''Color Pages''''' '''Cloud Color''' </code>
 
*(Or replace line with Natural Cloud Color)
 
*(Or replace line with Natural Cloud Color)
  
  
'''''Color Pages''''', '''Water Color'''  
+
<code>'''''Color Pages''''' '''Water Color''' </code>
 
*(Or replace line with Natural Water Color)
 
*(Or replace line with Natural Water Color)
  
  
'''''Color Pages''''', '''Foliage Color'''  
+
<code>'''''Color Pages''''' '''Foliage Color''' </code>
 
*(Or replace line with Natural Foliage Color)
 
*(Or replace line with Natural Foliage Color)
  
  
'''''Color Pages''''', '''Grass Color'''  
+
<code>'''''Color Pages''''' '''Grass Color''' </code>
 
*(Or replace line with Natural Grass Color)
 
*(Or replace line with Natural Grass Color)
  
Line 95: Line 95:
  
  
'''Large Feature, Medium Feature, Small Feature,'''  
+
<code>'''Large Feature, Medium Feature, Small Feature,''' </code>
 
*(Or replace with Lacking X Feature, however Lacking Small/Meduim Features will result in some instability)
 
*(Or replace with Lacking X Feature, however Lacking Small/Meduim Features will result in some instability)
**(Features will sometimes accept ''Block Pages'' to generate the material, '''Floating Islands''' also accepts a ''Biome Page'')
+
**Features will sometimes accept ''Block Pages'' to generate the material, '''Floating Islands''' also accepts a ''Biome Page''. For these cases, use the format below:
 +
 
 +
<code>''Block Page'' ➡ '''Feature Page'''</code>
 +
 
 +
<code>Block Page, Biome Page  ➡ '''Floating Islands Page'''</code>
  
 
=== Effects ===
 
=== Effects ===
  
  
(Optional: Effects Pages)
+
All effects are optional. Lightning accepts Color Modifiers.
  
  
Line 112: Line 116:
 
=== Gradients ===
 
=== Gradients ===
  
Gradients can be used to change Sunset, Stars, Sky, Night Sky, Fog, and Cloud color, and have them shift between colors over a certain length of time.
+
"Gradient" is an optional page that can be used to change Sunset, Stars, Sky, Night Sky, Fog, and Cloud color, and have them shift between colors over a certain length of time.
  
 
Example format with three alternating colors in the sky:
 
Example format with three alternating colors in the sky:
  
'''''Color Pages''''', '''''Length Pages''''', '''Gradient Page''' (Color 1)
+
<code>'''''Color Pages''''', '''''Length Pages''''' '''Gradient Page''' (Color 1)
 
 
'''''Color Pages''''', '''''Length Pages''''', '''Gradient Page''' (Color 2)
 
  
'''''Color Pages''''', '''''Length Pages''''', '''Gradient Page''' (Color 3)
+
'''''Color Pages''''', '''''Length Pages''''' '''Gradient Page''' (Color 2)
  
'''Sky Color Page'''
+
'''''Color Pages''''', '''''Length Pages''''' ➡ '''Gradient Page''' (Color 3) ➡ '''Sky Color Page'''</code>
  
 
Length determines how long a color will last before it's completely faded to the next color, and color page mixing are standard Mystcraft rules. You must have at least two colors to alternate between but you may add as many as needed.
 
Length determines how long a color will last before it's completely faded to the next color, and color page mixing are standard Mystcraft rules. You must have at least two colors to alternate between but you may add as many as needed.
 
*Length seems to be half as long as Celestial lengths for gradients, if you wanted to sync a color shift to a celestial, you can include the same Length pages for both.
 
*Length seems to be half as long as Celestial lengths for gradients, if you wanted to sync a color shift to a celestial, you can include the same Length pages for both.
**(Example: ''''Red Color''''', '''''Full Length''''', '''Gradient Page''' would sync to a Celestial also using only "Full Length" for it's movement.)
+
**(Example: ''''Red Color''''', '''''Full Length''''' '''Gradient Page''' would sync to a Celestial also using only "Full Length" for it's movement.)
  
 
=== Additional Notes ===
 
=== Additional Notes ===
Line 134: Line 136:
 
* Additional Celestials, Features and Effects can be added, as long as they remain in the correct format.
 
* Additional Celestials, Features and Effects can be added, as long as they remain in the correct format.
  
* Native Biome Distribution, Natural X Color pages, and Dark Celestials accept no modifiers.
+
* Native Biome Distribution, Natural X Color pages, and Dark Celestials accept 0 modifiers.
  
 
* Any optional sections you decide to leave out may be randomized for you, the Grammar will not be satisfied for those sections, the more specific you are the less is left to chance.
 
* Any optional sections you decide to leave out may be randomized for you, the Grammar will not be satisfied for those sections, the more specific you are the less is left to chance.
** For an age to be “stable” it must have all grammar elements satisfied, and use no pages that generate base instability.  
+
** For an age to be “stable” it must use no pages that generate base instability, and must not have excessive ores in the ground (compared to the overworld).
*** It is possible to have “pseudo-stable” ages with some instability, but not enough for decay, usually by balancing the “unstable” pages with ones that reduce instability.
+
*** It is common to have “pseudo-stable” ages with some instability, but not enough for world-destroying effects. This can happen just by adding glowstone (for example) to an overworld-like age, as glowstone is not a normal resource in the overworld.
 +
*** An age an be made "more stable" by adding pages that reduce instability. For example, an age with "Charged" will have lighting strikes, but will have less instability.
 +
 
 +
* Effects will not be added randomly unless the age is unstable due to either greedy pages like "Accelerated", or grammar errors, or excessive ores/fluids in the ground.
 +
** There are pages that will add instability, anything that adds ores or other rare resources, or give some form of advantage to the player will generally cause instability.
 +
*** Pages like Dense Ores, Diamond Ore Block, etc. *may* create a lot of instability.
 +
: As a quick counter example, "void world, dense ores, diamond ore block, obelisks" will not. Since it is void, there is no stone to be turned into ores by dense ores; since there is no land, there are no obelisks. It is not that these pages generate instability, it is the effect in the world.
 +
*** Ages with Acceleration will cause instability, because it makes farms more efficient.
 +
*** Ages with Bright Lighting will cause instability, because they are easier to mine in.  
  
*Effects will not be added randomly unless the age is unstable due to either greedy pages like Dense Ores or grammar errors.
+
All of these things will cause [[Instability]] (via Greed), and possibly lead to Decay.
**There are pages that will add instability, anything that adds ores or other rare resources, or give some form of advantage to the player will generally cause instability.
 
***Pages like Dense Ores, Diamond Ore Block, Accelerated, etc. will create a lot of instability.
 
****Ages with Acceleration will cause instability, because it makes farms more efficient.
 
****Ages with Bright Lighting will cause instability, because they are easier to mine in.
 
****Ages with Dense Ores will cause instability, because they have more abundant ore generation.
 
  
*All of these things will cause [[Instability]] (via Greed), and possibly lead to Decay.
 
 
*However, pages that intentionally make the age more dangerous actually add some base stability to the Age. Examples of these pages are “Lightning” “Scorched Surface” or “Random Explosions”, some mods will even add materials that are dangerous enough to qualify for this effect.
 
*However, pages that intentionally make the age more dangerous actually add some base stability to the Age. Examples of these pages are “Lightning” “Scorched Surface” or “Random Explosions”, some mods will even add materials that are dangerous enough to qualify for this effect.
 +
 +
Remember, instability is not automatically decay. Early instability effects are almost always surface status effects. A cave world, with glowstone, and bright lighting, might not have any noticeable effect inside the cave itself.
 +
 +
== Age Templates ==
 +
 +
 +
'''Overworld Clone:'''
 +
 +
Stone Block ➡ Water Block ➡ Standard World, <br />
 +
Native Biome Controller,  <br />
 +
Normal Lighting, Normal Weather,  <br />
 +
Yellow Color ➡ Red Color ➡ Sunset Color ➡ , <br />
 +
Full Length, Rising Phase, East Direction ➡ Normal Sun,  <br />
 +
White Color ➡ Blue Color ➡ Sunset Color, <br />
 +
Full Length, Setting Phase, East Direction ➡ Normal Moon,  <br />
 +
White Color, Full Length, East Direction ➡ Normal Stars,  <br />
 +
Natural Cloud Color,  <br />
 +
Natural Fog Color,  <br />
 +
Natural Sky Color,  <br />
 +
Natural Foliage Color,  <br />
 +
Natural Grass Color,  <br />
 +
Natural Water Color,  <br />
 +
Blue Color ➡ Black Color ➡ Black Color ➡ Night Sky Color,  <br />
 +
Caves, Ravines, Mineshafts, Strongholds, Villages, Dungeons,  <br />
 +
Water Block ➡ Surface Lakes, Lava Block ➡ Deep Lakes
  
 
== XComp's Notes ==
 
== XComp's Notes ==
Line 158: Line 187:
  
 
== Version Compatibility ==
 
== Version Compatibility ==
*The grammar system above is current for Mystcraft Versions 0.12 through 0.13.4.04 [https://minecraft.curseforge.com/projects/mystcraft/files/2581192 (Latest Build)]
+
*The grammar system above is current for Mystcraft Versions 0.12 through Current [https://minecraft.curseforge.com/projects/mystcraft/files (Latest Builds)]

Latest revision as of 04:48, 22 July 2019

This article is about the current version of Mystcraft.

Grammar and Stable Writing

In order to better control the results of your writing, you will need to understand the Grammar. It’s best to plan out what kind of world you want in advance and make sure you satisfy as much of the grammar as possible.

Incomplete age descriptions will be parsed by the universe (following the grammar) and then further expanded. This is similar to if you provided the words "red" "dog" "ball" and a sentence generator expanded it to "The red dog plays with the ball". The grammar expansion is random, and may form different expansions: "The red car narrowly missed the dog chasing the green ball" is an equally valid expansion. These expansions are done similar to sentence tree structures.

The more detail provided initially, the less the universe will inject new variations to what has been written. Writing "The red dog plays with the ball" leaves far fewer options for expansion; usually the remaining expansions take the form of modifiers. "The big, red dog plays with the ball" or "The red dog plays with the ball in the yard" would be valid expansions of the English sentence.

Making mistakes, including conflicting or paradoxical passages, or attempting to write an Age with overabundant resources or advantages will result in an Age with Instability. Additionally, if the grammar is unsatisfied, symbols may be added to the age which may add instability.

Modifier Pages come before the Modified Page in the symbol order; similar to Adjectives and Nouns in English.

  • "This is a Red Ball." is correct, whereas "This is a Ball Red." would be grammatically incorrect.

Standard Age

A "Standard Age" layout and recommend page order example is given below. For ease of identifying which pages modify others, Modifier Pages will be in Italics, Modified Pages shown in Bold and finally pages that both Modify and can be Modified will be in both Bold and Italics. They will also be placed in the order that they should appear with proper grammar usage (Left to Right, pages on the previous line should come before the next line):

Link Panel

Link Panel Page,

  • (May have additional properties added via the Ink Mixer)

Terrain and World Type

Biome PagesBiome Distribution Page


Block Page(Solid) ➡ Block Page(Fluid) or No Seas PageWorld Landscape Page

Weather

Weather Page or No Weather Page

Lighting

Lighting Page

Celestials

(Optional: Color PagesSunset Color Page)

Length Pages, Direction Pages, Phase Pages,Normal Sun,

  • (If no Sun, replace entire with Dark Sun)


(Optional: Color PagesSunset Color Page)

Length Pages, Direction Pages, Phase Pages,Normal Moon,

  • (If no Moon, replace line with Dark Moon)


(Optional: Length and Direction Pages)

Color PagesStar Page

  • (If no stars, replace line with Dark Stars)

Visuals

Color PagesSky Color

  • (Or replace line with Natural Sky Color)


Color PagesNight Sky Color

  • (For Default Night Sky, use Black Color)


Color PagesFog Color

  • (Or replace line with Natural Fog Color)


Color PagesCloud Color

  • (Or replace line with Natural Cloud Color)


Color PagesWater Color

  • (Or replace line with Natural Water Color)


Color PagesFoliage Color

  • (Or replace line with Natural Foliage Color)


Color PagesGrass Color

  • (Or replace line with Natural Grass Color)


(Optional: Boundless Sky and/or Rainbow Pages)

World Features and Structures

Large Feature, Medium Feature, Small Feature,

  • (Or replace with Lacking X Feature, however Lacking Small/Meduim Features will result in some instability)
    • Features will sometimes accept Block Pages to generate the material, Floating Islands also accepts a Biome Page. For these cases, use the format below:

Block PageFeature Page

Block Page, Biome Page ➡ Floating Islands Page

Effects

All effects are optional. Lightning accepts Color Modifiers.


Clear Modifiers Page
Clear Modifiers is optional but reduces the chances of the age being violently unstable due to unused modifiers. It generates a small amount of instability for every “dangling” or “unused” Modifier page it accepts. This can be used as a “safety net” at the end of complex passages to clear all modifiers if you are unsure of your grammar.

In practice, unused modifiers are assigned usages by the grammar, so there are rarely unused modifiers by the time this symbol is applied.

Gradients

"Gradient" is an optional page that can be used to change Sunset, Stars, Sky, Night Sky, Fog, and Cloud color, and have them shift between colors over a certain length of time.

Example format with three alternating colors in the sky:

Color Pages, Length PagesGradient Page (Color 1) ➡

Color Pages, Length PagesGradient Page (Color 2) ➡

Color Pages, Length PagesGradient Page (Color 3) ➡ Sky Color Page

Length determines how long a color will last before it's completely faded to the next color, and color page mixing are standard Mystcraft rules. You must have at least two colors to alternate between but you may add as many as needed.

  • Length seems to be half as long as Celestial lengths for gradients, if you wanted to sync a color shift to a celestial, you can include the same Length pages for both.
    • (Example: 'Red Color, Full LengthGradient Page would sync to a Celestial also using only "Full Length" for it's movement.)

Additional Notes

  • "Replace line" in the above example means "Remove that page and all its modifier pages, the replacement page accepts 0 modifiers"
  • Additional Celestials, Features and Effects can be added, as long as they remain in the correct format.
  • Native Biome Distribution, Natural X Color pages, and Dark Celestials accept 0 modifiers.
  • Any optional sections you decide to leave out may be randomized for you, the Grammar will not be satisfied for those sections, the more specific you are the less is left to chance.
    • For an age to be “stable” it must use no pages that generate base instability, and must not have excessive ores in the ground (compared to the overworld).
      • It is common to have “pseudo-stable” ages with some instability, but not enough for world-destroying effects. This can happen just by adding glowstone (for example) to an overworld-like age, as glowstone is not a normal resource in the overworld.
      • An age an be made "more stable" by adding pages that reduce instability. For example, an age with "Charged" will have lighting strikes, but will have less instability.
  • Effects will not be added randomly unless the age is unstable due to either greedy pages like "Accelerated", or grammar errors, or excessive ores/fluids in the ground.
    • There are pages that will add instability, anything that adds ores or other rare resources, or give some form of advantage to the player will generally cause instability.
      • Pages like Dense Ores, Diamond Ore Block, etc. *may* create a lot of instability.
As a quick counter example, "void world, dense ores, diamond ore block, obelisks" will not. Since it is void, there is no stone to be turned into ores by dense ores; since there is no land, there are no obelisks. It is not that these pages generate instability, it is the effect in the world.
      • Ages with Acceleration will cause instability, because it makes farms more efficient.
      • Ages with Bright Lighting will cause instability, because they are easier to mine in.

All of these things will cause Instability (via Greed), and possibly lead to Decay.

  • However, pages that intentionally make the age more dangerous actually add some base stability to the Age. Examples of these pages are “Lightning” “Scorched Surface” or “Random Explosions”, some mods will even add materials that are dangerous enough to qualify for this effect.

Remember, instability is not automatically decay. Early instability effects are almost always surface status effects. A cave world, with glowstone, and bright lighting, might not have any noticeable effect inside the cave itself.

Age Templates

Overworld Clone:

Stone Block ➡ Water Block ➡ Standard World,
Native Biome Controller,
Normal Lighting, Normal Weather,
Yellow Color ➡ Red Color ➡ Sunset Color ➡ ,
Full Length, Rising Phase, East Direction ➡ Normal Sun,
White Color ➡ Blue Color ➡ Sunset Color,
Full Length, Setting Phase, East Direction ➡ Normal Moon,
White Color, Full Length, East Direction ➡ Normal Stars,
Natural Cloud Color,
Natural Fog Color,
Natural Sky Color,
Natural Foliage Color,
Natural Grass Color,
Natural Water Color,
Blue Color ➡ Black Color ➡ Black Color ➡ Night Sky Color,
Caves, Ravines, Mineshafts, Strongholds, Villages, Dungeons,
Water Block ➡ Surface Lakes, Lava Block ➡ Deep Lakes

XComp's Notes

  • "Some symbols function as modifiers for other modifiers" (ex. Red Color can mix with other colors, Half Length with other lengths, North Direction with other directions, etc).
  • "Modifiers come before the symbol they modify"
  • "Incomplete age descriptions will be parsed by the universe (following the grammar) and then further expanded"
    • "This is similar to if you provided the words "red" "dog" "ball" and the universe expanded it to "The red dog plays with the ball". The grammar expansion is random, and may take different expansions: "The red car narrowly missed the dog chasing the green ball" is an equally valid expansion."
  • "Not fully satisfying the grammar won't produce instability directly. The symbols added by the grammar might, however."

Version Compatibility

  • The grammar system above is current for Mystcraft Versions 0.12 through Current (Latest Builds)