Differences

This shows you the differences between two versions of the page.

--- iapi:mixmaster [2019/05/28 13:14] – kyrahabattoir
+++ iapi:mixmaster [2020/12/05 17:36] (current) – [Making a custom recipe] formatting kyrahabattoir
@@ Line 2: / Line 2: @@
 It features 25 fictional drink recipes inspired by games like [[https://waifubartending.com|VA-11 Hall-A]] and [[https://ss13.co Space Station 13]].
+[[https://gitlab.com/KyrahAbattoir/mixmaster/issues|Click here to report a bug or request a feature]]
 ====== Product content ======
-===== The MixMaster =====
+  * **KDC MixMaster:** The machine itself, used to mix the drinks and respawn them.
-The machine itself, used to mix the drinks and respawn them.
+  * **Cocktail Coaster:** The coasters can be used to set down drinks rather than dropping them.
-===== Cocktail Coaster =====
+  * **Bartending Handbook:** The handbook contains a quick reference to all the recipes that the machine can produce. Place it in-world if you want to provide an easily accessible reference for the would be mixologist.
-The coasters can be used to place the drinks rather than dropping them on the floor when drink dropping is enabled.
-===== Bartending Handbook =====
-The handbook is essentially a glorified notecard giver and contains a quick reference to all the recipes that the machine can produce. Place it in-world if you want to provide an easily accessible reference for the would be mixologist.
 //NOTE: Some of the recipes are secret and aren't part of the handbook.//
-====== Making your first drink ======
+====== Making your first cocktail ======
   * Add the required ingredients by tapping the corresponding displays (one click = one unit).
   * Add Ice if needed (can be done at any point).
   * Age the mixture if needed (must be done right before mixing).
-  * Click and **DRAG** the lever until it fully engages to begin mixing.
+  * Click and **DRAG the lever** until it fully engages to begin mixing.
   * Release the lever after the required time.
+  * If you made a mistake, you can press the **flush** button (bottom right) to clean the shaker and start over.
+===== Ingredients =====
+All cocktails produced by the KDC MixMaster are a combination of the 5 base ingredients:
+  * **Adelhyde:** A very sweet, fruit based  syrup.
+  * **Bronson Extract:** A very bitter extract of Bronson roots.
+  * **Powdered Delta:** A very sour dry chemical compound.
+  * **Flanergide:** A concentrated spice mixture.
+  * **Karmotrine:** A highly purified, odorless alcohol.
+Up to 20 units can be used to compose a cocktail.
 ===== Mixing vs Blending =====
 Cocktails have to be mixed a minimum amount of time to be considered complete, when the mixing handle is fully engaged, the mixing indicator will begin blinking. After about two full revolutions of the shaker (~2 seconds), the blinking will accelerate. Indicating that the drink has been fully mixed at this point.
-If the recipe you are following requires blending, continue mixing until the shaker brutally accelerates. At this point your cocktail is now blended.
+If the recipe you are following requires blending, continue mixing until the shaker begins to spin faster. At this point your cocktail is now blended.
-//NOTE: Some recipes do not require any specific preparation (Ice/Age/Mixing).
+//NOTE: Most recipes require a specific preparation (Ice/Age/Mixing).
 If you get the ingredients right, but the preparation wrong, a cocktail will still be produced, but it won't be the right one.//
 ===== Custom Drinks =====
 If you fail the preparation on a specific recipe, or simply mix something that is not actually a known recipe, you will end up with a "Custom Drink".
 Custom drinks have generic flavors and color based on the ingredients used.
+====== Advanced bartending ======
+===== Double cocktails =====
+Cocktails that use 10 ingredients or less can be made into "doubles cocktails" by simply doubling all the ingredients. The result will be identical, but it will have twice as many sips as the original.
+===== Optional ingredients =====
+Some recipes, such as many of the alcohol-free cocktails, have optional ingredients. Feel free to add as little or as much of the optional ingredient as you want (this will affect flavor and the total number of sips).
 ====== Drinks ======
   * Click and accept the attach permission request to pick a drink up.
@@ Line 40: / Line 59: @@
 //NOTE: If you are holding a cocktail, clicking a coaster will place your glass on top of it.//
+Every now and then, drinking will have your character detect a flavor in your cocktail. Flavors depend on ingredients and the beverage type.
 ====== Configuration ======
 The KDC Mixmaster comes configured out of the box and you don't have to change anything to make it work. Simply rez the "KDC MixMaster" on a counter top and you are good to go.
@@ Line 45: / Line 66: @@
 //Optionally, add a few coasters facing where you intent to serve patrons and the handbook somewhere convenient.//
+There are 4 configuration notecards that can be *renamed* to adjust the machine's behavior.
+===== _config.allow.drop =====
+Possible values:
+  * **_config.allow.drop=Yes** : Cocktails can be dropped on the ground or placed on coasters.
+  * **_config.allow.drop=No** : Detached drinks will simply disappear.
+===== _config.allow =====
+  * **_config.allow=All** : Everyone is allowed to operate the machine.
+  * **_config.allow=Group** : Only members of the group the machine is set to are allowed to use it.
+  * **_config.allow=Owner** : Only the owner of the machine can use it.
+===== _config.rez.count =====
+  * **_config.rez.count=X** : Where X is the maximum amount of drinks the machine is allowed to rez at any given time.
+===== _config.rez.temporary =====
+  * **_config.rez.temporary=Yes** : Drinks are set as temporary after rezzing, doesn't use LI, but drinks disappear after ~60 seconds.
+  * **_config.rez.temporary=No** : Drinks are permanent but will still auto-clean after 5 minutes. This option uses LI.
+====== Making a custom recipe ======
+Recipes are represented by notecards:
+<code>
+Name,Taste,Type,Type2,Recipe,Preparation
+</code>
+  * Name: The name of the drink, it is also the name of the drink object that will be used.
+  * Taste: Used by the handbook for the "taste" sorting mode.
+  * Type: Used by the handbook for the "type" sorting mode.
+  * Type2: Used by the handbook, but only shown on the drink page itself.
+  * Recipe: A special string that describe the recipe of a cocktail.
+  * Preparation: How the drink has to be prepared.
+===== Recipe encoding =====
+<code>
+A_B_D_F_K_
+</code>
+Where each "_" is a number from 0 to 9 indicating each ingredient requirement:
+(A)delhyde (B)ronson Extract, Powdered (D)elta, (F)lanergide and (K)armotrine.
+//'N' can also be used instead of a number, it means that any amount of that ingredient is valid.//
+===== Preparation encoding =====
+The preparation string indicates how the drink has to be mixed:
+<code>
+M: Mixed
+B: Blended
+I: Add Ice
+A: Age
+N: Any preparation will be valid.
+</code>
+//Note: The preparation has to be at least one letter, either M,B or N, letter order is not important.//