The Cookbook is the store for Recipes; it is available everywhere except the Tutorial interface.
Recipes are a way of automatically interacting with your protein, you can consistently repeat simple shake and wiggle routines or perform a series of complex routines which never stop!
The term Recipes includes both GUI and Lua Scripts, the terms tend to be used interchangeably but they do represent different things.
GUI recipes perform predefined actions in a single sequence and can be compared to macros. Scripts use the more powerful Lua script and some libraries and can be compared to simple programming code.
Tip: GUI recipes stop running when you minimize the foldit game window, Script recipes keep running in the background.
In August 2011 another version of Lua Scripts was introduced, scripts are now called: GUI, V1 or V2.
V2 introduced many new functions and libraries and will continue to be enhanced. GUI and V1 script types are supported for backward compatibility only.
And you may like to read: What's the point? Can't this just be automated using recipes?
If you have ideas and suggestions for the Cookbook please add them to this post:
There are some excellent recipes of both types written by foldit players on the foldit recipe page. foldit 101 recommends Blue Fuse v1.1 http://fold.it/portal/recipe/2052 as a very useful addition to your Cookbook.
Tip: You must be logged into the foldit web portal and have the game running. The game must be running using the Basic or Advanced interface for recipes to load properly into the Cookbook. Downloading recipes to your game client requires chat to be operating. If you can't see Global Chat, you won't be able to download.
Groups usually have recipes which can only be used by members of the group; these recipes are available from the relevant group recipe pages.
Self shared recipes - are your own recipes which you share with yourself.
All recipes of any type are loaded up to the server the first time they are run as the foldit team is also interested in how folders create and use recipes.
Some recipes are very computer resource intensive, and may appear to run slowly, this may be a result of your particular computer configuration and available graphics processing.
If you notice foldit running slowly there are some things you can do while running intensive, resource hungry recipes, particularly if you are not watching the recipe run.
Use the view menu to reduce the amount of drawing to the screen your computer has to do:
- Uncheck all of the clashes and bond view options
- Trace line is the fastest View protein option
- hydro is the fastest color option
- Don't use the show exposed, issue analysis etc views
- Reduce the size of the foldit window
Minimize the foldit window so that it is not drawing at all. (GUI recipes will stop running!)
The exploration Map is very slow to load and will significantly slow you down.
You may want to modify (mod) a recipe, for example, to change a parameter in the options provided. Modifying is easy to do but take care as the in game editor will not check for errors. Good code writers explain the recipe options on the recipe page and in the code itself.
To modify a recipe click the Edit recipe button next to the recipe name in the Cookbook, the edit window will open showing the code. Read any instructions that the code writer has provided and make your changes. You will need to use Save As to save the changes by changing the title of the recipe.
You can create new recipes from scratch or by modifying existing recipes.
To create GUI Recipes, click the Open Recipe Editor button on the Cookbook, an edit window will open
Click New (GUI) and two blue bars appear at the top of the window, click the bars and a menu of actions will appear, the Help menu in the edit window has more detailed information about how to use the predefined actions.
To create the more powerful Lua scripts read the tutorials:
Also read Tlaloc_Script_Standards
The list of available functions for V2 is automatically created and available here:
More standard Lua functions and libraries have been added, see the Lua manual http://www.lua.org/manual/5.1/.
V2 scripts can now use the functions in the: http://foldit.wikia.com/wiki/Lua_Standard_Libraries
To create a V2 recipe, open the recipe editor and click the "New (Script V2)" button at the bottom.
Access to Cookbook while recipe is runningEdit
In the Selection interface only whilst a script is running, you can:
- edit, add, save, upload recipes the same way as you do without scripts running.
- change the script you are running, the change will be available the next time you load the script.
- change a script you have started from the editor, that makes no difference.
Once you are satisfied with your recipes, consider sharing them with the rest of the players. Simply click the Share button in the Edit window and choose how you want to share.
Warning: Use the Basic or Advanced interface to do this, not the Selection interface.
Sharing recipes across machines
To share your personal selection of recipes across machines just take the all.macro file with you on a thumbdrive. You can use your operating system search functionality to find the all.macro file.
Or you can "share to myself" using the Coobook, any recipes you want to use on multiple machines.