tmesser / DeckManager

BSD 3-Clause "New" or "Revised" License
5 stars 2 forks source link

Work with MaxPeck on integrating the GIMP plugin for graphical board readout #30

Open tmesser opened 9 years ago

tmesser commented 9 years ago

Apparently, the plugin reads a CSV of the game state to output a beautiful image of the board. This is awesome stuff and it definitely needs to be in DeckManager.

MaxPeck commented 9 years ago

For what it's worth, the spreadsheet and GIMP template and plugins we're talking about are at http://boardgamegeek.com/thread/1011735/openofficegimp-moderator-toolset-20/page/1 . I don't actually know much more about CSV than "it exists", but I'll do what I can to help out.

MaxPeck commented 9 years ago

Sticking this here since it's purely a display issue for this: the template thingie has a "Stranded on Caprica" thing it'll toss over Helo's sheet if we can report that properly.

MaxPeck commented 9 years ago

I'm dumping my documentation here because I'm not sure where else I want it.

Command line is path\to\gimp-2.8.exe -i -b "(script-fu-BSGP-Run-Batch \"path\to\file.csv\")" -b "(gimp-quit 1)"

BSGP Game Name - MASTER.xcf needs to be present in the same directory as the csv.

"Game","Mockup","1.1","NoPegasus","NoExodus","NoDaybreak","NoRevelations","Kobol","Standard","log"

Information on the game itself. "Mockup" is the game name. "1.1" is the current turn number. The opposite of "NoPegasus" is "Pegasus", and so forth. "Standard" is the pursuit version; "Cylon Fleet" is the other option. "log" creates a small logfile for troubleshooting.

"Characters","Apollo","Chief","Helo","Gaeta","Tigh"

The characters in the game, in order. The base game characters are known to it as Adama, Apollo, Baltar, Boomer, Chief, Helo, Roslin, Starbuck, Tigh, and Zarek.

"Option","OutlineCounters"

Present if the counters are to have a colored outline drawn around them. I recommend just leaving this on.

"Resources",8,8,10,12

Fuel, Food, Morale, Population.

"PlayerCards",5,3,3,3,3

The number of skill cards each player has.

"PlayerLocations","Sector 5","Hangar Deck","Stranded on Caprica","FTL Control","Command"

Where each player is. Note that DRADIS sectors are numbered, not phonetically lettered. Helo's Stranded icon also requires an assignment, below. According to the comments, players in viper mk7s append a * (so "Sector 5*"?), players in assault raptors append a !.

"SkillDecks",23,23,23,23,23,0,0

How many cards are left in each skill deck. The last two are Treachery and Faith.

"Reserves",0,3,4,4,0,""

The number of damaged vipers, available vipers, available raptors, damaged viper mk7s, available viper mk7s, and available assault raptors. Ships not present at all can be left blank or 0.

"Decks",10,100,30,19,0,7,"",""

The number of cards left in the destiny deck, crisis deck, destination deck?, quorum deck, ? (new caprica crisis deck?), super crisis deck, mutiny deck, ? (something to do with revelations?)

"CivShips",10,0,0

The number of civ ships available, then probably locked and prepared for new caprica.

"Roles",1,1,1,5,2,1,0

Player numbers are 1-indexed. The current player, the president, the number of cards in the quorum hand, the admiral, the number of nukes remaining, the CAG (0 if not present), the mutineer (0 if not present).

"JumpTrack",0,0

The 0-indexed position on the jump and pursuit tracks.

";GamePhase",1

Lines starting with ; are effectively commented out. This is probably a new caprica thing? Lines like this can also be dropped entirely.

"Assignments","STRA",3,"","","","","",""

Ordered pairs of first four letters of assignment and player number it belongs to. STRA is Stranded on Caprica for Helo's thing. MISS is Mission specialist. That sort of thing.

"BoardingParty",2,1,0,0,0

How many Centurions are on each space of the boarding track. If there aren't any, this line can be commented or missing.

";OccForce",0,0,0

I assume this is the same thing for the occupation force track thingie.

"Distance","2","LD","3"

The distance on each card under the objective card. Note that these must be strings, not numbers. LD is of course Legendary Discovery. The total distance is not listed separately anywhere.

"BoardSpecial","Colonial One","Thirty-Three","Jammed Assault"

Various special conditions on the board. "Colonial One" blows up said ship, as does "Pegasus". CAC names mention the card and their rule on the DRADIS; I think this only supports base game CACs at the moment.

"OPG",1,1,1,1,1

Do players have their OPGs available?

"Damage","FTL Control"

A list of damaged locations. Pegasus locations too.

"Graveyard","Ellen"

A list of Executed characters. Same names as for the Characters listing.

"Cylons",1,"C",1,0

Information on each revealed Cylon--this line repeats if there are multiple revealed. The player number, C for normal Cylon or L for leader, number of SCCs held, and are they infiltrating?

"Basestar",1,"Critic"

Information on each Basestar--this line repeats if both are on the board. The sector number the basestar is in, and the first six characters of any damage tokens on it. Ionian Nebula does weirder stuff with this and I haven't figured it out. Sector number is negative if it's on the CFB.

";Scar",""

The sector number the Scar raider is in, if present.

"Option", "ShowShips"

If present, it will try to draw each ship individually instead of putting "x10" or whatever next to a single raider. I strongly recommend omitting this line.

"Sector",5,0,0,1,0,0

The number of generic components in a given sector of the DRADIS: sector number, number of heavy raiders, number of raiders (excluding the Scar raider), number of vipers (excluding piloted vipers), number of viper mk7s (excluding etc.), number of assault raptors (excluding etc.).

"Civilians",4,"A"

Information on each civilian in space, repeating this line as necessary. Sector number, letter designation.

"Option","View"

If present, it will open the .xcf file in GIMP afterwards. (It removes the -i and -b "(gimp-quit 1)" parameters from the command line, in the spreadsheet; my guess is this does nothing in the actual script?)

"Option","JPG"

If present, it will automatically export the .xcf file to a .jpg.

"CylonFleet",2,0,1

The number of generic components in a given sector of the CFB: sector number, number of heavy raiders, number of raiders.

";Allies",0,0,"ALLIES",0,"Name","Location",,,,,, ";Trauma",0,0,0,0,0,0,0,,,,,

Hahahahahahahahaha.

"LoyaltyCards",1,1,1,1,1

The number of Loyalty cards held by each player. (Possibly also the number of motives held by a Daybreak CL?)

"BGColor",43,58,102

The RGB background color in non-board areas. This is a perfectly good default value.

"ResourceDamage",0,0

Has the Fuel damage token been resolved and removed? Has the Food etc.?

"DamagedCivilians",1,2,2,1,1

The number of damaged decoys, 1 pop civs, 2 pop civs, pop/fuel civs, pop/morale civs. Note that you'll get an error if either of the last two are higher than 1.

";Mutiny",0,0,0,0,0

The number of mutiny cards each player is holding.