The Campaign Builder's Guild

I have created a Java program for managing an "Almanac" (basically, a compendium of information about a setting, along with notes and other general information that can be generated in play as well as at design time. Currently I've posted an installer at my home server. This application requires Java 1.6 and the existing installer is a jar file that will run on Windows or Unix systems. (If you have Mac OSX, you'll need Java 1.6 from Apple, which only appears to be available for OSX 10.5. I don't have that, so I can't support Mac OSX right now, but if you want to be the guinea pig, go ahead and ask.)

I've posted about this in the Tavern and the IRC channel, and gotten a few nibbles, so I decided to put up a thread so people can provide feedback or ask questions.

What does it do?

Well, you'll probably start by importing a map and creating almanac entries for some of the larger entities in your setting (whether they be planes, worlds, continents, or kingdoms). Each entry has a configurable set of properties that you can assign - whatever you need like population, government style, wealth, or anything else you need to keep track of. You can add an HTML description block for the entry, then go ahead and create entries for the smaller entities. All the entries are hyperlinked so you can easily navigate from one to the next.

Drag icons on to your map to create hot spots that are linked to the appropriate almanac pages.

Quickly create notes about a setting - maybe rough ideas or ticklers for further work, or notes about events in play. Also create records for significant NPC's or people your players have encountered in that location.

Ultimately I'd like to be able to export selected almanac entries (or maybe parts of them marked public) to static HTML. Probably also to enhance the software with the ability to export/import fragments to facilitate sharing and collaboration.

What can you do?

If you want to try it now, it seems fairly functional. But there's only me doing this, and I don't have a real test team, so report any questions, issues, concerns, or ideas for new features here.

Tooltips missing or not helpful or badly formatted.
* Issues with layout or presentation.
* Things that are confusing to you.
* Things that don't work, or don't work the way you expect them to.
* Features you'd like, or anything that seems missing.
* Features you find annoying or that work poorly.
* Especially anything that prevents you from doing what you'd like to do.

Edited to add: If anyone wants more interactive talk, I'm also snakefing on AIM, or hndykstra AT gmail DOT com.

Very, very cool snakefing.

I might have to beta test it for ya. I don't think it's something I would use, but I don't mind helping out a fellow programmer.

That's cool with me. You can do the destructive testing. Beat on it until it begs for mercy.

SF,
I'll try to download from home.

The Alpha-2.0 release is now ready and can be downloaded from the usual place.

With this release, you can now create pages for almanac items. This is useful for smaller towns, villages, cities, or any other site that doesn't rate a full almanac page. Items are quick and dirty - notes, people, and a quick run down of significant features. They can be useful to keep track of towns and villages that your players have encountered, or to create locations that will be needed in upcoming adventures.

Almanac entries now also have sections. So you can create a section for religion, history, culture, or any other purpose. Like the main entry on the page, sections use HTML syntax.

Also, any display that accepts HTML now also supports hyperlinks. To link to an external web page, use the usual HTML link syntax. (E.g., <A href="http://www.thecbg.org">the CBG</A> would link to the CBG main page.) The page opens in your default browser.

To link to an internal entry or item, use the special pseudo-URL syntax:

href="entry:(relative_path)" to link to an entry page, where the path is relative to the current entry.
*href="entry:/(absolute_path)" to link to an entry page, where the path is absolute from the main almanac page to the desired entry
*href="entry:(path)#(section)" to link to a particular section of an entry
*href="item:(path_to_entry)/(item_name)" to link to an item that is defined in a particular entry. This supports either relative paths (relative to the current entry) or absolute paths.

Links are supported in the main page or any section of any entry, or on any note, or the description of any person.

Various and sundry improvements in tool tips and the installer are also included. The release notes link on the download page has more details. This version will install right on top of the previous version with no problem, and it will open existing files.

[Edited: I should add, if for any reason you have problems downloading large files, drop me a note via PM or otherwise and I'll see if I can burn you a DVD with everything you need.]

Well I haven't gotten much of a chance to test it but it seems to run smooth so far. I think the only question I have is if it can export to plain text (strip code tags and format appropriately). If not that would be quite useful. Another possible option is to covert to commonly used bbcode (<b> to for example).

Exporting to various forms is certainly on the list. Although I think it might be more effective to give people the option to enter BB Code and export either straight or HTML - there is plenty of code out there for converting BB Code to HTML, but hardly anything for the reverse.

That said, I confess to being a little mystified at the continued prominence of BB Code. Basic BB Code isn't much simpler than basic HTML, in my opinion. If you start with HTML there's a whole lot you can grow into, if you are interested, whereas BB Code remains fairly limited.

Anyway, export is probably for a 1.1 release. For RC1 I'm looking at refining the existing stuff and adding in tagging, and searching on tags and titles.

Right now the things I'm worried about most are flaky edge cases and abusive user tricks, like trying to add things that have the same name and not being able to tell them apart. Also, missing tooltips, areas that need help files, missing resources, and the like.

i downloaded it and did some stuff, but i'll long-time test is as a documentation tool for my two gaming groups.
at first glance i can only say: i'm impressed. the interface is intuitive and it has all the features i would look for into an almanac app. :)

Quote from: Scholari downloaded it and did some stuff, but i'll long-time test is as a documentation tool for my two gaming groups.
at first glance i can only say: i'm impressed. the interface is intuitive and it has all the features i would look for into an almanac app. :)

I agree. While I was confused at first, the mouse-over explanations and the labels quickly helped me pick up what to do.

I have a bug to report: The installer doesn't work correctly on Vista Business x64 SP1 (latest patch level). It doesn't ask for elevated privileges during installation and therefore the installation is silently redirected by Vista to the current account's virtual store where the installer then fails to create the application .BAT file. A screenshot with the resulting error message is attached to this post.

But nonetheless the program looks really promising. :)

Attachments:
* Screenshot

Well, that .bat file is extraneous now anyway, so I don't think that error will really cause
you any problem.

Working on BB converters for various variations of the code. What would be people's preference on this: export to file or to pop the converted code up in an editor for copy/paste to your favorite BB? Maybe both, give you a chance to review the code, or select a dialect before saving it?

Almost have the BB converters working, I guess I can post an update this weekend.

If any non-English speakers want to help with translating into their native language, let me know. I can send you the translation files.

It's a useful thing, although I'd rather prefer starting my own wiki than this. It gives me more possibilities and editing everything is much easier.

That's an awesome idea. After lunch I'll install it and give it a look over. This might be just what I was looking for.

Similarly ,have you seen the DM Setting Handbook from Goodman Games?