-
August 14th, 2010, 17:19 #1
- Join Date
- Jan 2010
- Posts
- 27
Creating an adventure (4e Parser + 4e Module Workshop)
Hi guys!
I'm trying to create an adventure module using the 4e Parser and the FGII 4e Module Workshop.
The adventure I'm trying to get into FGII is Khyber's Harvest, which is a free adventure from WotC and I do have an actibe DNDI account.
Great deal actually, as I can scrape NPCs, items and some more stuff from the DNDI Compendium. What what I don't get from the compendium are the story and maps.
At this point the 4e Module Workshop comes in. So I copy some text from the pdf into the workshoptool and saved it as "story.txt".
I put the compendium scrapes, story.txt and map image dir into the parser config and start parsing and the module get's created successfully.
Even though all that sounds quite easy, I have a few problems/questions:
- I don't see any story elements in FGII
- The story container in FGII is empty
- Is there a way to automatically create an input file for the encounters?
- How can I link tokens to my NPCs in the input files? Do I have to add them manually to the module?
- How does this NPC database work?
- And most important question:
Is there a documantation for those 2 tools anywhere out there?
Attached to the message you can find the story.txt created with the module workshop and the parser instructions.
Thanks a lot in advance and regards
Neph
-
August 14th, 2010, 19:19 #2
Wow. I didn't think anyone aside from Tenian and I were using both of the tools to create adventure modules. Nice to know others are using them.
Originally Posted by Nephilim667
- Your missing the required ZCATEGORY tag for each entry
- Encounter 2 has a few tag errors, mainly erroneous <frame> tags following <p> tags
- I couldn't get your Index page to parse until I inserted a blank line before the entry. In other words force the first line of story.txt to be blank -- I think this is a Parser problem.
Originally Posted by Nephilim667
Originally Posted by Nephilim667
Originally Posted by Nephilim667
Now if you parse all your modules containing NPCs and pass the same file path to the database you will end up with a database that contains all WotC NPCs. Very handy as you will see in a moment.
Now in the Workshop in Configuration options you will note two fields under the NPC Database Group:
- a path to the NPC Database itself
- a path to a global folder which contains all your NPC tokens and image files (they can be in subfolders).
Once configured you can access the NPC Database through the Workshop by either holding down Cntrl + 3 or clicking the button on the 2nd toolbar. Once opened the NPC Database form appears. From here you can either import your encounters.txt file or search on NPCs using the Search + Filtering facility to add NPCs to the 'Queue'. Once you have added all the NPCs you require hit the Output Queue button. The workshop will now sift through the database extracting entries in line with whats in the queue. For each NPC the workshop will also hunt down the token and image files (prompting if not found, duplicates are found etc). Once complete, you will find the npcs.txt, npcfluff.txt and tokens and images (in subfolders) in the current save path.
Originally Posted by Nephilim667
For the Parser there are a few guides found here at the FGII forums, a couple of smaller guides are also on the FGWiki and finally the holy grail, Parser Document.txt (found in the Parser's program folder) contains a complete reference for all content types and the required syntax.
Last edited by Zeus; August 14th, 2010 at 19:26.
FG Project Development
Next Project(s)*: Starfinder v1.2 Starship Combat
Current Project: Starfinder v1.1 - Character Starships
Completed Projects: Starfinder Ruleset v1.0, Starfinder Core Rulebook, Alien Archive, Paizo Pathfinder Official Theme, D&D 5E data updates
* All fluid by nature and therefore subject to change.
-
August 15th, 2010, 01:08 #3
- Join Date
- Jul 2010
- Location
- Sunny Florida
- Posts
- 16
Bookmarking this for extreme goodness.
-
August 15th, 2010, 15:45 #4
- Join Date
- Jan 2010
- Posts
- 27
Hey DrZeuss,
thanks a lot for long post. I really appreciate the time to spend in helping me (and also other ppl) and also developing your great little tool.
Most of your hints got me to right path and almoste everything seems to work as it supposed.
There're 3 points atm:
- What is the deeper sense of the ZCATEGORY-tag?
- I tried to link items, but the link isn't working. (See mi.txt and story_new.txt)
- The DB-feature allways gives me an error message when parsing. It looks like the a record couldn't be inserted into the npc-table of the db.
That's why I didn't go deeper into this feature for now.
Beside my personal problems of understanding how the parser and workshop tool work, I guess I found some bugs in the workshop tool:
- When the Workshop Tool is running it's not possible to use F-keys in other programms, even though the Workshop Tool's windows doesn't have focus.
- When inserting a link to an encounter (via F4), it would be nice to have the encounters from the workshop tools cache file availible as presets.
- When parsing the copied text from the PDF file while inserting into the Workshop Tool (via F6 - insert paragraph) some formats are not recognized sometimes.
(e.g. there is a passage about 5 skills-checks and each check is represented as the skills itself + DCxx in bold followed by a description. Checks 1,2 and 5 recognized correctly, 3 and 4 are treated as "normal text" in check 2s description)
If you're interessted I can give you more detailed information.
I also would like to make a proposal/feature request:
Having all the encounters in the cache is actually great. But pittily there is no option atm to manage those encounters, whichs leads to some problems.
Example:
I put in an encounter using the F3-key. Afterwards I noticed I made a spelling mistake/forgott to insert a category/whatever, so I actually need to make a change to the existing encounter entry or at least delete the entry, which is not possible.
I'll end up with a messed up story cache and generating the encounters.txt will spit out inconsistent/double entries.
So what is need if actually some kind of list inside the Workshop Tool which shows all the inserted encounters and those need to be linked at the corresponding ZNAME-entries.
(I think in .net you can use the XML of story_cache as a dataprovider for a list-element or something. Then highlight 'linked' ZNAME-entries with a color and give the user the possibility to add/change/remove the encounter-data which is linked.)
Even though there's a lot of finetuning to be done in the adventure, I would love to share my work, potentially here in the FGII forum.
All data and picutres inside the adventure module can be downloaded freely at WotC website. Is this possible/allowed to post the entire module here?
Which would be really great! In this case I will think about writing a tutorial/howto how I did create the adventure and hopefully more ppl will join in converting those free adventures from WotC and other 3rd party developers.
FGII will end up which a wide basis of free adventure which are ready to play and much less work for new FGII-GMs.
(Yes ... the work behind getting an adventure started in FGII is still a big obstacle you need to get over. )
Regards
Neph
PS: Did you and Tenian every think of putting your tools together in some kind a "module creation toolkit"?
I think a userfriendly and easy to use tool like that would be a great enrichment to the FGII-4e-community and lead to the distribution of a lot of free content ... very attrective for potential customers.
-
August 15th, 2010, 19:36 #5Originally Posted by Nephilim667
Originally Posted by Nephilim667
Try this notation instead:
ZLINK milist;weapon;New Magic Items: Weapons
ZLINK milist;armor;New Magic Items: Armor
ZLINK milist;itemslot;New Magic Items: Symbionts
ZLINK item;The Coat of Eyes; New Artifact: The Coat of Eyes
Originally Posted by Nephilim667
Originally Posted by Nephilim667
Originally Posted by Nephilim667
Originally Posted by Nephilim667
Originally Posted by Nephilim667
Originally Posted by Nephilim667
Originally Posted by Nephilim667
Originally Posted by Nephilim667
In fairness I never intended for the Workshop tool to be a long standing application, merely a stop gap until official tools become available. If anyone wants the source code to adapt the workshop for other rulesets, drop me a PM and I'll happily share. The code is written in VB.NET and requires Microsoft's full 4.0 .NET Framework.Last edited by Zeus; August 15th, 2010 at 19:42.
FG Project Development
Next Project(s)*: Starfinder v1.2 Starship Combat
Current Project: Starfinder v1.1 - Character Starships
Completed Projects: Starfinder Ruleset v1.0, Starfinder Core Rulebook, Alien Archive, Paizo Pathfinder Official Theme, D&D 5E data updates
* All fluid by nature and therefore subject to change.
-
August 15th, 2010, 22:18 #6
- Join Date
- Jan 2010
- Posts
- 27
Hey Zeuss,
Thanks again for long and detailed post.
I have limited time atm, so I cannot answer anything right away. But one thing just came into my mind when redaing your post.
We have discussed it but as the code base for each tool is extensive it would take significant effort to merge the two tools.
In fairness I never intended for the Workshop tool to be a long standing application, merely a stop gap until official tools become available.
Regards
Neph
-
August 15th, 2010, 22:43 #7
Your welcome.
Tenian has already begun a process to expose some of the functionality into DLLs, thats how I integrate with the NPC Database feature of the Parser into the Workshop tool. However, whether Tenian has any intention to release ALL functionality via DLL(s) is another matter altogether I haven't spoken with him for a week or so due to the holidays so not sure what his current plans are, hopefully he'll see this thread and provide a comment or two.
And just to be clear I am not confirming anything official is in development
You'll have to ask Doug and moon_wizard for that. I'm just stating that I wrote the app and am happy to share it with the community as an interim solution.
If and when an official tool is made available, I would discontinue development and support of the Workshop in favour of supporting the official toolset.
FG Project Development
Next Project(s)*: Starfinder v1.2 Starship Combat
Current Project: Starfinder v1.1 - Character Starships
Completed Projects: Starfinder Ruleset v1.0, Starfinder Core Rulebook, Alien Archive, Paizo Pathfinder Official Theme, D&D 5E data updates
* All fluid by nature and therefore subject to change.
-
August 16th, 2010, 11:33 #8
- Join Date
- Jan 2010
- Posts
- 27
Hey,
Tenian has already begun a process to expose some of the functionality into DLLs, thats how I integrate with the NPC Database feature of the Parser into the Workshop tool. However, whether Tenian has any intention to release ALL functionality via DLL(s) is another matter altogether I haven't spoken with him for a week or so due to the holidays so not sure what his current plans are, hopefully he'll see this thread and provide a comment or two.
Your telling the Parser the link reference is a story entry when in fact what your attempting to link is either a specific Magic Item or a Group of Magic Items.
Try this notation instead:
ZLINK milist;weapon;New Magic Items: Weapons
ZLINK milist;armor;New Magic Items: Armor
ZLINK milist;itemslot;New Magic Items: Symbionts
ZLINK item;The Coat of Eyes; New Artifact: The Coat of Eyes
I have story-element contain a detailed description for the magic items and a link to the items itself inside the descriptions. Those links aren't working.
In Tenian's parser doc the follwing can be found:
Code:ZLINK {link class};{id};{optional display text};{[Module Name]};{[Modestring]}* Supported values for {link class} item = magic item armor = for individual armor weapon = for individual weapon equipment = for individual equipment [...]
Code:ZLINK item;Tongueworm [...] ZLINK armor;The Coat of Eyes [...]
Code:The Coat of Eyes Level 1 Crafted by the daelkyr Belashyrra, [...] Armor: Leather Armor Enhancement: +1 AC [...] Tongueworm Level 1+ This thin strand of quivering muscle [...]
There are simply so many formats that I can cater and so some specific formats may not auto-format correctly. I can look at adding further format support but will need a reference to work from. PM me either the name of the source material your using, including page and paragraph references and I'll see what I can do.
Out of curiosity: How do oyu do the parsing? Are you using regular expressions?
Regards
Neph
-
August 16th, 2010, 12:51 #9
OK. Check to make sure your magic items are parsing correctly and that you have an entry for each new one you have listed in mi.txt
You can do this by right-clicking the Magic Items node in the Parser config sheet and clicking Parse.
The Parser will now step through the mi.txt file and compile the XML. If successful it will open an XML Browser window. Open the root node and then open the magicitemsdesc[modestring] tree.
Now step through all the items and make sure that all the fields in each entry have been populated correctly. You want to make sure at least Name, Class and mitype are all populated correctly.
As for how the Workshop parses and recognises the different text block formats, yes I am using LUA's in built pattern matching feature built into the string library. Its a cut down version of REGEX.FG Project Development
Next Project(s)*: Starfinder v1.2 Starship Combat
Current Project: Starfinder v1.1 - Character Starships
Completed Projects: Starfinder Ruleset v1.0, Starfinder Core Rulebook, Alien Archive, Paizo Pathfinder Official Theme, D&D 5E data updates
* All fluid by nature and therefore subject to change.
-
August 16th, 2010, 14:12 #10
- Join Date
- Jan 2010
- Posts
- 27
The parsed items look fine for me. (see attachment)
I tried to link the first entry (The Coat of Eyes) using the following lines in the workshop tool with no luck:
- ZLINK armor;The Coat of Eyes
- ZLINK armor;The Coat of Eyes +1
- ZLINK armor;thecoatofeyes_001
Thread Information
Users Browsing this Thread
There are currently 1 users browsing this thread. (0 members and 1 guests)
Bookmarks