Historic/101 - Cookbook

back to foldit 101

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 minimise the foldit game window, Script recipes keep running in the background.

And you may like to read: What's the point? Can't this just be automated using recipes?

Download recipes

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.

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.

Running 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

Minimise 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.

Modify recipes

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.

Warning: The game will usually crash when you run the newly saved recipe, even if the changes are correct. This is a bug. A work-around seems to be - after renaming the recipe, close the edit window, then reopen the renamed recipe and save it again. It then appears to work normally without crashing. Refer to http://fold.it/portal/node/989688 for updates on bug resolution.

Create recipes

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:

http://foldit.wikia.com/wiki/Lua_Scripting_Tutorial_(Beginner_1)

Sharing recipes

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.