Guide: Converting CSC story to readable JSON and making it compotible with 0.8.8+

In this forum, you can ask questions and get help with the House Party Custom Story Creator. Not for Bug Reports. See the forum below for that.
Forum rules
Forum rules
No racism, sexism, anti-semitism, brigading, doxxing, or ANY form of abusive behavior. No discussion of hacking or piracy or the buying, trading, or selling of ANY type of product or service (digital or otherwise). No advertising of any product or service (digital or otherwise, and this includes streams or any service involving 'subscribers'). No discussion of religion or politics. Do not link to other adult sites, with the exception being discussion of other adult games in Offtopic/allowed subforums; i.e. no pornography.

Do not spam, do not try to circumvent any automated tools that are part of these forums or any linking to these forums. Do not judge others based on their preferences for custom stories, their opinions, sexuality, etc., and most certainly do not bring it to the moderators.

Respect the moderators and each other and all will be well. Report any violations of the above rules. Do not violate local or international laws (including, but not limited to the laws of your country and/or the laws of the United States) while making use of these forums. The IP address of all posts are recorded to aid in enforcing these conditions.

We will use username, e-mail, AND IP bans without reservation, and mods hold the final word in such decisions.
Post Reply
peter980
Posts: 774
Joined: Thu Feb 15, 2018 1:50 am

Guide: Converting CSC story to readable JSON and making it compotible with 0.8.8+

Post by peter980 » Sun Feb 25, 2018 12:34 am

Here is process I used to convert one of the 0.8.3 CSC stories to 0.8.8, including changing it to readable JSON, so it can be edited by hand, without Custom Story Creator.

1) Open each of the story and character files in Nodepad++ :
https://notepad-plus-plus.org/

2) Remove binary bits from start and end of the file

3) Go to here and paste the file content:
https://jsonformatter.org/

4) Convert with 4 space tab option, then paste to original file

5) Change encoding to USC-2 LE BOM (very important)

6) If file is not in "Windows (CR LF)", to EOL conversion to "Windows (CR LF)"

After these steps you will get story and character files that are readable by the game, as well as editable by the hand.

Next, steps to convert from 0.8.3 to 0.8.8:

1) Replace all references to:
"Type": "Roaming"

with:
"Type": "Roaming_Depreciated_Use_State_AbleToRoam",

2) Find any character file that has:
"Type": "EnableNPC",

And replace with:
"Type": null


After this, you will get story and should mostly work correctly in 0.8.8, while being editable by hand.

peter980
Posts: 774
Joined: Thu Feb 15, 2018 1:50 am

Re: Guide: Converting CSC story to readable JSON and making it compotible with 0.8.8+

Post by peter980 » Sun Feb 25, 2018 12:41 am

Couple of more things that need to be taken into consideration:

1) 0.8.7+ introduces 3 more personalty trains to characters: Shy, Perverse and Exhibitionism

I assume that if missing that game will assume that they start with value of 0.

I do not think there is any gameplay effect of Shy and Perverse, but Exhibitionism has huuuge effect.

It affects behavior of characters when naked (full or breast naked), and how will they cloth in hot tub. Values can go from -100 to 100.

Since this feature did not exist in 0.8.3, some behavior changes will happen, after converting older stories to 0.8.8. Based on what is needed, it should be good idea to add this trait to all characters, based on story needs.

What I was able to figure out:

1) Exhibitionism between -100 and -1
Character is shy if having breast exposed

2) Exhibitionism between 0 and 49
Character is not shy if having breast exposed
Character is shy if having no panties

3) Exhibitionism between 50 and 100
Character is not shy if naked

That is just what was gotten with testing. Only developers know exact behavior.

Anyway, any stories that should be converted to 0.8.8 should take this into account and set this trait based on their need.

peter980
Posts: 774
Joined: Thu Feb 15, 2018 1:50 am

Re: Guide: Converting CSC story to readable JSON and making it compotible with 0.8.8+

Post by peter980 » Sun Feb 25, 2018 1:24 am

More updates on Exhibitionism stat:

1) Exhibitionism between -100 and -1
Character is shy if having breast exposed, or no panties
Character in full swimwear when in hot tub

2) Exhibitionism at 0
Character is not shy if having breast exposed
Character is shy if having no panties
Character in full swimwear when in hot tub

3) Exhibitionism between 1 and 49
Character is not shy if having breast exposed
Character is shy if having no panties
Character without bra when in hot tub

4) Exhibitionism at 50
Character is not shy if naked
Character without bra when in hot tub

5) Exhibitionism between 51 and 100
Character is not shy if naked
Character is fully naked in hot tub

In original story (0.8.8), most characters have Exhibitionism bellow 0, Vickie has 44 and Stephanie 100. But there is script that changes Amy and Vickie to 100, and Brittney to 40 or 100.

Note that hot tub behavior will be overridden if character already has underwear parts equipped in open (and visible). In that case, those parts of clothing will stay in hot tub, regardless of exhibitionist trait.
Last edited by peter980 on Sun Feb 25, 2018 1:30 am, edited 1 time in total.

erasmus
Posts: 927
Joined: Tue Feb 13, 2018 4:29 pm

Re: Guide: Converting CSC story to readable JSON and making it compotible with 0.8.8+

Post by erasmus » Sun Feb 25, 2018 1:29 am

Thanks!

Also bear in mind that http://jsbeautifier.org/ is another option for formatting the files to be purdy. There's also some behind the scenes stuff (read as "hard coded things or bugs") that may prevent characters from covering up or force them to cover up at times but this is a great starter summary.

If hand-editing files, the game version lines in the .story and .character files (usually at the bottom or top of each file) need to match the game version the user is running. Will look similar to "HousePartyVersion": "0.8.8". Pretty easy change, but in case anyone has purposefully decided to use a non-updated game version it might be handy to know. Also, as always, .story files, the folder that contains all your story and character files, and the "StoryName" data entry in each file need to be the exact same text.
Erasmus
Eek! Games LLC
Vice President, QA & UX

peter980
Posts: 774
Joined: Thu Feb 15, 2018 1:50 am

Re: Guide: Converting CSC story to readable JSON and making it compotible with 0.8.8+

Post by peter980 » Sun Feb 25, 2018 1:34 am

Interesting enough, those CSC converted to JSON have:

"HousePartyVersion": null,

So I assume that game defaults them to current version.
Another possibility is that binary headers and footers I removed during conversion had that data in binary (not sure).

erasmus
Posts: 927
Joined: Tue Feb 13, 2018 4:29 pm

Re: Guide: Converting CSC story to readable JSON and making it compotible with 0.8.8+

Post by erasmus » Sun Feb 25, 2018 1:40 am

peter980 wrote:
Sun Feb 25, 2018 1:34 am
Interesting enough, those CSC converted to JSON have:

"HousePartyVersion": null,

So I assume that game defaults them to current version.
Another possibility is that binary headers and footers I removed during conversion had that data in binary (not sure).
Yeah if you don't use the Apply to House Party (last time I checked the button was called this) and export tools the game will not actually apply your Custom Story to your currently installed version of House Party, and this info will be missing, EVEN if the rest of the file is formatted in a way that would be readable/usable by the game.

In case you or anyone else also misses my little tidbit about save files, REGARDLESS of save version, they are all here:

C:\Users\YOUR USERNAME\AppData\LocalLow\Eek\House Party\Saves

Might be some wiggle room for using them. I have yet to play with them myself, being low on time and all.
Erasmus
Eek! Games LLC
Vice President, QA & UX

peter980
Posts: 774
Joined: Thu Feb 15, 2018 1:50 am

Re: Guide: Converting CSC story to readable JSON and making it compotible with 0.8.8+

Post by peter980 » Sun Feb 25, 2018 1:52 am

Small correction on above. One of the stories I was using to test conversion had null for version in character files, but story file had 0.8.3 as version. Also character files where missing StoryName entry (these was some Name entry, but it was null also).

Was still running as is, but it would be good idea when converting to change to current version. :)


EDIT:
Actually scratch that. Changing null to 0.8.8 for character files has broken those files, making characters not working. :(

Changing version in story file is fine, and has no negative effect.

peter980
Posts: 774
Joined: Thu Feb 15, 2018 1:50 am

Re: Guide: Converting CSC story to readable JSON and making it compotible with 0.8.8+

Post by peter980 » Sun Feb 25, 2018 3:42 am

Here is one of the stories I've converted to 0.8.8, using these steps:
viewtopic.php?f=8&t=75&p=275#p275

peter980
Posts: 774
Joined: Thu Feb 15, 2018 1:50 am

Re: Guide: Converting CSC story to readable JSON and making it compotible with 0.8.8+

Post by peter980 » Sun Feb 25, 2018 3:50 am

peter980 wrote:
Sun Feb 25, 2018 12:34 am
1) Replace all references to:
"Type": "Roaming"

with:
"Type": "Roaming_Depreciated_Use_State_AbleToRoam",

2) Find any character file that has:
"Type": "EnableNPC",

And replace with:
"Type": null
Important:
When replacing, make sure to end with comma, if not last property in the section.
Always use some JSON validator tool (google it), to verify if data structure is correct. Otherwise file will not load correctly in the game.

Post Reply