Home

Welcome to the seapulse-calculator wiki!

Hi! My name is Lelebees. I made this calculation app for Seapulse, which calculates Webkinz food recipes.

What does the app do?

Simply put, the app calculates every possible combination of ingredients for a given set of parameters, and then returns the combinations matching a specific criteria.

The parameters are:

• The amount of ingredients per recipe
• The minimal combined value of those ingredients
• The maximal combined value of those ingredients
• Which ingredients to exclude (blacklist)
• Which ingredients to include
• Which ingredients are always in the recipe (whitelist)

^{Please note that the amount of ingredients in the whitelist are subtracted from the amount of ingredients per recipe. If you have entered 5 ingredients and added 2 ingredients to the whitelist, the calculation will output recipes with 5 ingredients, 2 of which are always the ones from the whitelist.}

Where is the result?

Since there are a lot of combinations (Even with minimalization, the ram usage can go beyond 6GB) I've opted to not use RAM memory to store the result. This means you cannot access it through the application. Instead, it's written to a file, output.txt, that you will find in the data folder after running the calculation once. Running a new calculation will overwrite the old output.txt!

I cannot guarantee that you will be able to open the output.txt file, as many text editors will load the document in the RAM memory, which is quickly overloaded. So far, IntelliJ IDEA has been the only editing software I know of that can reliably (although not without complaining) open very big files. Notepad stops at 2GB, and Notepad++ loads the file into RAM.

The application is not starting!

well shit.

There are a lot of reasons why this could be. I'll handle the most common ones here.

1. Your Java version is out of date / there is no Java installed.

   Ensure you have at least Java version 17 or higher installed on your system.

2. Ingredients.json is missing or damaged

   Ensure that a copy of Ingredients.json is located in a data folder on the same level as the application, and is named Ingredients.json

3. There is no logs folder

   For some reason, It doesn't make itself. Ensure there is a logs folder and the application should start up gracefully.

4. I have a different issue.

   Now is the time to panick, at least, for me. There is a good chance i did something wrong, so please, open an issue (if it doesn't exist already) and provide the following information:

   • Operating System
   • Error message / log file
   • A description of what happened. You can get your hands on an error message by running the application through a console or uploading the log file.

Why is it taking so long?

Sometimes, the program refuses to start the calculation. I have no idea why. Generally, if you see the progress bar swishing back and forth like this:

Then you should close and reopen the application, or, if possible, run a new (and different) calculation. Don't forget to take the useful data out of output.txt!

How do I download the app?

I include a zipped folder with the app-jar in every release. Downloading and unzipping this folder will "install" the application on your computer.