AlchTool - PHP-based alchemist potion research tool

© 2006-2014 Jarkko Vääräniemi (Jeskko Pupunen) and Matti Hämäläinen (Ggr Pupunen)

This software is a simple PHP-based script for making BatMUD alchemist potion research easier and a more bearable process. It will help you keep book of the combinations you have researched and will automatically eliminate combinations that are not possible.

Requirements

Requirements are simple, but may not be available to everyone. You will need an environment capable of hosting PHP scripts, and a web-server. Most UNIX/Linux shell accounts offer this possibility. PHP version 5 is recommended, but the script may work with PHP version old as 4.3. We make no guarantees, however. GD extension for PHP is also currently required.

Other thing you will need, of course, is a web-browser, for viewing the data.

"Installation"

Place the files (index.php and results.txt at the very least) in a directory that is accessible to whatever web-server and PHP solution you are using. You probably want the img/ directory as well.

For local execution with plain PHP built-in web-server (PHP 5.4 or later required), without external web-server such as Apache, you can use the included "router.php" to run the system as follows:

$ php -S localhost:8888 router.php

Then point your web-browser to http://localhost:8888/. You may need to adjust the port (8888) or your firewall settings.

How to use

Input data for the script can be written in file results.txt either by hand, or any other way desired, such as MUD client triggers. Latest version of GgrTF scriptset for TinyFugue offers a nifty alchemist guild module, that can automate the data file generation completely.

The format of the data file is as follows, example of a datafile can be found here.

• Any non-empty line that does NOT start with hash '#' character, is considered data.
• Each data line is of format: mineral organ herb result
• Each entry (mineral, organ, herb, result) is separated by whitespace of any amount you want to use.
• Result field is as follows:
  
  • - : No match.
  • ?potion_name : Close, but no cigar.
  • !potion_name : Found potion.
• Allowed names for minerals, herbs and organs are listed by the script. Potion names are not limited, but you should be consistent, mismatches cannot be detected!

Contact, bugreports, etc

Tells to Ggr or Jeskko @ BatMUD, or e-mail ccr@tnsp.org (Ggr).