[UNOFFICIAL] Party Installer - The custom story installer

*Come Here to Download Custom Stories!*
Here you can post and share any custom stories you have written with the House Party Custom Story Creator Tool.

Story creators: auto-pruning begins if a story post has not been posted to in 4 months, OR if there are no views of the post within 6 months. Most custom content will fail to work well before these limits, based on our update pace. This rule is in place to ensure that working stories are kept visible to users. It is easy to keep a topic alive, but do not needlessly bump story topics.
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.
puffdip
Posts: 45
Joined: Mon Jul 30, 2018 9:49 pm
Contact:

[UNOFFICIAL] Party Installer - The custom story installer

Post by puffdip » Thu Sep 26, 2019 4:57 pm

Hello,

I really would like to give something with the upcoming days, However I might not able to finish this project within two days. Therefor I've decided to share my work in progress and hopefully gain a community which is willing to provide input.

How does it works ?
You have to execute 3 steps in order to play a custom story
1) scroll through the available stories and choose one you are interested in
Image
2) click in the top left corner what version you would like to install
3) click the install button
Image

That is about it, enjoy!
Party Installer - The custom story installer.zip
(538.79 KiB) Downloaded 390 times
---------------------------------------

ORIGINAL POST

Hey again! Its me. And today I would like to announce a unofficial custom story installer.
First of all, I am not affiliated with Eek! Games and the software they make. This is a
thirdparty application which means Eek is not responsible for this program.
Therefor bugs and
issues can be posted in this thread.

NOTE
This program is a POC. (Proof Of Concept). A POC is usually made in less then a week time.
If I'm happy about the results the program produce I might write it into a full version.
All it needs to do right now is installing custom stories.

With that in mind, translations are listed as installable items but wont work through this client.

UI

Image
  • (1) The installer automatically tries to find the installation directory of House Party. if for some
    reason the client fails, then configure your application with this menu. Simply navigate to
    the "stories" folder located in "Documents" and click open.
  • (2) If you found a story you would like to install then click the install button next to the name
    of that story. A new UI will popup which I talk about later. The installation button is only
    enabled when the installation directory is set. *
  • (3) Information bar. This bar shows realtime information and is always visible.
  • (4) When opening this program all stories are collected through Eeks forum and displayed here. This list
    is 100% dynamic. So if you would like to list your own story in this client then read the section on how
    to do that instead. If you click on the name your default browser opens op (tested with chrome) and you
    get redirected to the forum page. This way you can read the actual topic. **
  • (5) Status Bar. The status bar shows usefull background information. Think of which installation path is
    selected and/or if the program is busy with installing or not.
* When a installation is complete the button will turn green, however it doesnt keep track on what is installed.
** For now the list is in a random order each time you open the client.

Image
  • (1) Even in the installation menu you will be able to re-configure your installation path.
  • (2) The name of the story selected
  • (3) If you have trouble installing a story through the client open up the forum. Most custom stories
    have installation instructions. If you follow those instructions you will be able to still play
    that story. Not everything is supported by this client. You can read more on this in the section
    on how to get my custom story in the client.
  • (4) The available downloads. When pressing one of those buttons the file will be downloaded in your
    installation path. This program doesnt remove files, therefor downloaded files will not be removed.
    After the download this client will extract the zip file and reorganize the folder structure
    so the results are playable in game.
  • (5) The forum button opens the default browser (Tested with Chrome) and redirect you to the forum page.
    The back button returns you to the custom story list.

How do I get my custom story in Party Installer?

For obvious step one, There is a nice guide on how to make your own stories on the Official website: http://games.eekllc.com/custom-story-creator/.
If you have created your own story simply upload it to the Official Custom Story Showcase: viewforum.php?f=8.
When uploading make sure the following rules apply to your upload:
  • *The forum rules.
  • **Follow the following format as title:
    • <Story Name> [House Party Game Version]|STATE| - {creators name}
    for example
    • Help Patrick find his forskin [1.14]|COMPLETE| - PuffDip
    • Yet another booze bottle [1.14]|INCOMPLETE| - PuffDip
  • Party Installer only supports zip files. You can totally upload a .rar or .7z.
    But the client wont install those. It still will download the file nomather what file extension it is.

* The forum rules apply, However the thread title is outdated since the HP Version and the CSC Version are now even.
** Creaters name is optional. However I might add this into the UI at some point to give the creators more credit.

Party Installer will automatically find your story once uploaded. You might want to restart Party Installer in order to refresh to story list

Last words
I hope this solves the issue of installing for a lot of people. This application is tested on a Windows machine and on a Linux Machine.
Translations are not available for install at this time. Besides client download this application is also open source. You can view the
source code at: https://github.com/0x78f1935/PartyInstaller.

WINDOWS
  • Start the exe which is the compiled version of the same application
    The reason why the windows version is bigger is because python is packed
    into the exe itself. This is because windows doesn't come nativly with
    python.
Linux
  • python3 -m pip install virtualenv
  • Navigate with a terminal to PartyInstaller Folder where the run.py file is located.
  • python3 -m virtualenv venv
  • source venv/bin/activate
  • pip install -r requirements.txt
  • python run.py
DOWNLOADS
Windows: https://github.com/0x78f1935/PartyInsta ... taller.zip
Linux: https://github.com/0x78f1935/PartyInsta ... ler.tar.xz
SourceCode: https://github.com/0x78f1935/PartyInsta ... ve/1.1.zip

Changelog
  • September 27 2019
    • Added the option to enable or disable censorship.
    • Added a additional error message if somehow the zip file is unable to decompress.
Last edited by puffdip on Fri Dec 27, 2019 11:35 am, edited 8 times in total.

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

Re: [UNOFFICIAL] Party Installer - The custom story installer

Post by peter980 » Thu Sep 26, 2019 11:19 pm

puffdip wrote:
Thu Sep 26, 2019 4:57 pm
[*] **Follow the following format as title:
I would suggest following actual forum rules for title format.

[<Story Status>] <Story Name> [<game version>] {<CSC version optional}

Although, not even all authors follow those. Some reorder these element or are missing some info.

Fetch author name from the starter of the thread.
Story version number is not part of the title for logistical reasons, but is usually included in the zip name by many authors.

For additional info, it may not be bad idea to create tag element we could add to our original topic post, which could be used to get fetch more info. But then, not all authors will start adding those.

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

Re: [UNOFFICIAL] Party Installer - The custom story installer

Post by peter980 » Thu Sep 26, 2019 11:25 pm

Actually, from pinned post:
Format your thread's title for your custom story as follows: <Story Name> [House Party Game Version] {CSC Version of Custom Story Creator used}
So an example would be (no quotes): "<Eek Loses Files in the Hot Tub? Aqua-Patrick to the Rescue!> [0.8.8] {CSC 5.0}"
What is weird that I'm pretty sure story status was in the rules (complete, incomplete, etc...) And that example should not have <> in title.

puffdip
Posts: 45
Joined: Mon Jul 30, 2018 9:49 pm
Contact:

Re: [UNOFFICIAL] Party Installer - The custom story installer

Post by puffdip » Fri Sep 27, 2019 12:33 pm

peter980 wrote:
Thu Sep 26, 2019 11:25 pm
Actually, from pinned post:
Format your thread's title for your custom story as follows: <Story Name> [House Party Game Version] {CSC Version of Custom Story Creator used}
So an example would be (no quotes): "<Eek Loses Files in the Hot Tub? Aqua-Patrick to the Rescue!> [0.8.8] {CSC 5.0}"
What is weird that I'm pretty sure story status was in the rules (complete, incomplete, etc...) And that example should not have <> in title.
For now it doesn't matter at all. But I might write this application again in another language. I want to do stuff with the title but right now everything is a bit on the way the poster wanted it. Which is fine with me. But all I'm saying if you would like to add your story the correct way to the unofficial client, then you might want to keep the format I said. CSC version is not needed if you post the HP version and visa versa. A couple of months back the versions were merged into one version number because it was to confusing or smth. (I forgot). Your name is optional, however I ask this because I'm kind of limited with the data I can provide. So if you want credits it would be a smart move on the creators side to actually add in the name.

Altho this all is just speculation since nothing in the code really does something with the name. But this might be on the roadmap. Therefor the "<>" around the name would be nice to have but is not necessary. However, the other characters for example the version "[]" are required. That way its easier for me to scrape the data. And to be honest. Most current stories already provide this information. Altho double versions numbers (CSC and HP) are again difficult to deal with. Especially most titles are unique to their creator.

The real struggle on my side is the name of the creator. (again optional).
That not all authors follow those rules is on them but I would like to point out that the forum rules still apply when uploading a story.
Eek above unofficial stuff.

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

Re: [UNOFFICIAL] Party Installer - The custom story installer

Post by peter980 » Fri Sep 27, 2019 2:12 pm

The forum rules are the reason I would avoid using format you suggested. Since is it your unofficial suggestion that does not match current rules.

Also you could make story for release X using older CSC from Y release. Like if you want something out right after patch, or you just did small edit to make story compatible with new patch with change that does not require export with new CSC. So there is value in this information.

But I do like idea of adding tag to first post, if your tool coul read it, with some format that we could stsndardize.

puffdip
Posts: 45
Joined: Mon Jul 30, 2018 9:49 pm
Contact:

Re: [UNOFFICIAL] Party Installer - The custom story installer

Post by puffdip » Fri Sep 27, 2019 3:24 pm

So let me elaborate, (good discussion tbh :D ).

The forum rules state the following:
Format your thread's title for your custom story as follows: <Story Name> [House Party Game Version] {CSC Version of Custom Story Creator used}
So an example would be (no quotes): "<Eek Loses Files in the Hot Tub? Aqua-Patrick to the Rescue!> [0.8.8] {CSC 5.0}"
Ignore the "<>" characters

This format is used almost everywhere which is a issue. I explain this later on. The format I suggest looks like this:
Help Patrick find his forskin [1.14]|COMPLEET| - PuffDip
Yet another booze bottle [1.14]|INCOMPLETE| - PuffDip
The format suggested includes the [story name and the csc/hp version]. Since the hp and csc versions are even. Therefor its nothing more then a extension on the existing rules. Now, to give answer on the suggestion you gave:
peter980 wrote:
Fri Sep 27, 2019 2:12 pm
Also you could make story for release X using older CSC from Y release. Like if you want something out right after patch, or you just did small edit to make story compatible with new patch with change that does not require export with new CSC. So there is value in this information.
Yes, I'm totally into this but here is the thing. In older versions where csc and hp where not even in version number most stories had two tags. Where one tag was obviously lower in value then the other tag. (higher or lower). Its hard to just base on the title currently which version is ment for csc and which is ment for hp. You basically don't now, This makes it hard to organize in two different tabs.

My ideal situation would be a setting page where you can set a filter. [COMPLETE, UNFINISHED, Version Number, a-z, z-a, popularity, creator]
(Looking to current posted stories)
- complete and unfinished are basically almost everywhere included
- Version Number is like i said a guess game. A formatted title would really help out.
- a-z z-a, filter on name
- popularity, filter on most views, (downloads would take to many requests which would result in a freezing UI until it is finished with all those requests)
- creator, could be in the title (just for me because i am lazy), and if you dont i prop need to regex it out of the page which should be possible. This is why it is optional but if you do you really make me happy.

Ultimately a search bar perhaps.

ttant
Posts: 452
Joined: Tue Feb 13, 2018 4:49 pm

Re: [UNOFFICIAL] Party Installer - The custom story installer

Post by ttant » Fri Sep 27, 2019 5:07 pm

puffdip wrote:
Fri Sep 27, 2019 3:24 pm
peter980 wrote:
Fri Sep 27, 2019 2:12 pm
Also you could make story for release X using older CSC from Y release. Like if you want something out right after patch, or you just did small edit to make story compatible with new patch with change that does not require export with new CSC. So there is value in this information.
Yes, I'm totally into this but here is the thing. In older versions where csc and hp where not even in version number most stories had two tags. Where one tag was obviously lower in value then the other tag. (higher or lower). Its hard to just base on the title currently which version is ment for csc and which is ment for hp. You basically don't now, This makes it hard to organize in two different tabs.
As you still can use CSC 0.14.4 to create CS compatible with 0.15.x, that why there what [HP game version] and {CSC version} with different character to better differentiate them apart.
Anyhow, if neede, i can rename few topic here so all CS thread use the same pattern as name.

puffdip
Posts: 45
Joined: Mon Jul 30, 2018 9:49 pm
Contact:

Re: [UNOFFICIAL] Party Installer - The custom story installer

Post by puffdip » Fri Sep 27, 2019 5:40 pm

ttant wrote:
Fri Sep 27, 2019 5:07 pm
As you still can use CSC 0.14.4 to create CS compatible with 0.15.x, that why there what [HP game version] and {CSC version} with different character to better differentiate them apart.
I do get this but programmatically its useless. Unless I can retrieve the current version of the game somewhere. I already fetch the version of csc, so If I can get the version of hp i could make a filter for stories with version number between csc and hp (aka supported versions).
ttant wrote:
Fri Sep 27, 2019 5:07 pm
Anyhow, if neede, i can rename few topic here so all CS thread use the same pattern as name.
You can do that however, that doesnt solve the issue. There is no form validation so there is not really a way to fix it for future posts. On the other hand, if the purge starts all those other stories with double tags are getting archived anyways. Cleans up too :) and for the information side, I might do something like "if authorname in title: do stuff". Otherwise it just wont show. If you use the default format your story will be picked up anyhow. Even if you typed in some random characters its not that big of a deal, however, to provide more features it is a nice to have thing.

haydn54
Posts: 4
Joined: Sat Apr 28, 2018 4:03 am

Re: [UNOFFICIAL] Party Installer - The custom story installer

Post by haydn54 » Sat Sep 28, 2019 3:17 pm

downloaded for windows but has no file format after unzipped

Teloric
Posts: 2
Joined: Wed Feb 14, 2018 11:39 pm

Re: [UNOFFICIAL] Party Installer - The custom story installer

Post by Teloric » Sat Sep 28, 2019 11:48 pm

Folder?

Post Reply