This is the original version of the box with different graphics and the box itself moved closer to the dice.


The Box
A Fantasy Grounds II Ruleset Mod
================================

What the box does
-----------------

Back in the day when my group played D&D face-to-face, my players wanted to be in greater control of their fates.  Sure, them rolling a die is pretty much just as random as me rolling a die for them, but they liked being able to roll the dice themselves.  Since there were cases like hide checks, spot checks, etc., where the result of their roll should remain hidden from them, my players crafted "The Box", a small box made out of plexiglass with a paper flap covering the front opening.  They would roll the dice through the front, and since the rest of the box was behind a large aluminum DM screen, they wouldn't be able to see what they rolled.

The Box provides that functionality in Fantasy Grounds II.  It works exactly the same as any die roll you would normally do in FG2, except instead of rolling the dice in the chat window, you drag the dice to a box icon that appears on the desktop.  FG2 will then indicate that you have done a box roll, and on the host's side, the dice will automatically roll.  You'll see the shadowed version of the dice roll in the chat box, and your DM will see the results, with all the modifiers applied that you put in the modifier box when you rolled.


A note to ruleset modders
-------------------------

This file is primarily for reference by people who aren't familiar with making modifications to FG2 rulesets.  You should be able to read this file and figure out what steps you need to take to add this mod to your own custom ruleset.


Installation
------------

As with any FG2 ruleset modification, there are setup steps that you need to perform in order to begin using this mod.  

1.  Find the "Program Files/Fantasy Grounds II" directory.  In that directory should be a file called "d20unpak.exe".  Run that.  It will extract the default d20 ruleset into the "Application Data/Fantasy Grounds II/examples" directory.

2.  Go to that examples directory and copy the d20 subdirectory into "Application Data/Fantasy Grounds II/rulesets".  When you're done, rename the "d20" subdirectory in the rulesets directory to something else (anything else, just don't call it "d20").  This is the new name for your custom ruleset.

3.  Extract or copy the files in this mod so they end up in a subdirectory of the newly-renamed directory.  Name this new subdirectory "thebox".

4.  Open the file "modifications.txt" and apply the modifications specified in that file.


Migrating your current campaign to the new ruleset
--------------------------------------------------

In order to have a pre-existing campaign use the new modification, you need to tell it to do so.  Go to the directory called "Application Data/Fantasy Grounds II/campaigns/{name of your campaign}".  Open the "campaign.xml" file in that directory.  Inside the "ruleset" tag in that file, it should read, name="d20" currently.  Change the "d20" so it matches the name of your custom ruleset.


When the Default Ruleset Gets Updated
-------------------------------------

Anytime the default ruleset is patched by SmiteWorks, you will need to manually update the custom ruleset on your end if you are just using a modded version of the default ruleset.  The patcher only updates the default ruleset, not customized ones.  To update your custom ruleset, rerun the "d20unpak.exe" file to re-extract the ruleset into the examples directory.  Copy the files into your custom ruleset directory, and then re-apply the modifications listed in "modifications.txt".

If you have questions about using this mod, please send a PM to Dachannien on the official Fantasy Grounds II forums.

Enjoy!

