Jump to content

1 Screenshot

About This File

This is NOT a mod

 

You can not "install" it as a mod and call it a thing. You will need to follow the instructions first. And understand what it does and what it does not.

Starting from version 0.1.0 you can install the files of it as a mod, it will properly place the tool into the Apropos folder. You will stil need to follow the instructions for getting PHP environment in case you don't have one.

 

Disclaimer

 

If you decide to use this software, you use it as is and to your own risk.

 

If you use this tool, like it and modified the config to your liking and want to support the community - please share your config.json!

 

Description

 

This is a simple script written in php. What it does? It allows you to filter unwanted animation phrases from Apropos. The filter works in two ways:

 

  • Based on a banned word. This filter will try to find a properly terminated word that is in the banned list and remove any phrases that contain these words.
  • Based on a synonym. This is very similar to words, but it will enclose the filtered word into the synonym braces and thus it's much safer to use

 

How To Install

 

You will need to have php environment in your system, place the script to the Apropos DB folder and run it. Again:

 

  • Go to PHP site.
  • Download the interpreter. Here's the link for the latest windows ones (7.4.2 at the moment of writing of this post).
  • Extract the zip to somewhere
  • Make sure to add PHP to your system PATH variable. This is important! Or else calling a script via "php" command will fail. Here's how to do it in Windows 10.
  • Install this mod via any mod manager
  • Open command line, you can do this with hitting Windows+R keys and then typing cmd command
  • Go to the Apropos DB installation path (use cd command in the terminal for that)
  • Run the script with php updater.php or double-click the updater.bat file

 

If you did everything correctly, you will see the script going through the database and modifying the files.

 

How To Customize

 

First thing first - this is a file I wrote for myself when I wanted to remove some of the stuff from Apropos DB. "Default" filters are done to my liking. You may or may not agree with it - that's not the point. You can easily modify the filters. There are a lot of comments I added before publishing the script and I might be not the best engineer, but I hope the comments are self-explanatory.

 

For filters you want to touch these config values:

 

"blacklist" : {
		"words": [...]
}

- for banned words, and

"blacklist" : {
		"synonyms": [...]
}

- for banned synonyms. See above what is the difference (and it is also mentioned in the script comments).

 

Another dimension of customization is to use file blacklisting. You can add files that you do not want to process into the filesToSkip config array. Initially it was created to skip global DB files like Synonyms.txt but will do the trick just fine for any other file. Example: if you want to remove bestiality references from non-bestiality animations phrases only, you can achieve it by adding bestiality-related keywords to the banned entries/synonyms and then also adding bestiality file names to the blacklist (this should also work on directories, so if you add a directory name then the entire file set under this directory will not be processed)

 

More?

 

Not much more to add. Just play with the variables and adjust them to your liking.

 

Why?

 

I like Apropos idea, but I do not like certain things, like bestiality, orgies, public sex etc etc - the list can go on, it's not the point. The point is that there are 2.2k+ files in apropos db and manually fixing them after every update would be impossible. And I needed to fix it every time because Apropos is not very well set by default. A virgin PC yells "you're better than those giants"? ... a scene in complete seclusion in an inner cell causes "the guys start to cheer on"? ... Huh? ...

 

So I let the software to do the trick.

 

Also, why php? I happen to have an interpreter installed already. I could've done in in java so that users can just double-click the precious .jar, but it takes some effort (and in java I then would probably need to add support for config files if I want to modify filters / anything else in the software and it's just too much hassle for such a simple task)


What's New in Version 0.5.0

Released

New requirement: PHP v8.1 or higher.

 

New functions in the form of:

 

Checking the files: You can now run the automated checker process to see if you are using any synonyms anywhere which do not exist in your database. Useful when you added or changed new synonyms. Synopsis:

 

php checker.php

 

Editing phrases: You can edit your DB in a CLI-based manner. It's supposed to be used for quick fixes; for anything serious you'll likely need to go with a normal editor. However it does have useful features like filtering out what you want to edit and so on. Synopsis:

php corrector.php [Mask]

 

The optional Mask (without brackets) will filter to only have the files which match the provided mask. Mask is the usual filename-based OS mask, for instance *Canine* will result in iterating through files which contain "Canine" in their file name. The option for editor look like this:

Spoiler
2022-04-17 21:27:11 : Processing file: 'FemaleActor_Male_Oral.txt'

> I feel it as you insert your cock into my sexy throat.
> [Enter] next / [F]inish session / [S]kip section / [R]etry synonyms / [E]dit phrase / [U]ndo edits / [D]elete phrase / [O]rigin display

 

The choice is provided by a single letter input. The menu options are:

  • Enter (hit "Enter" key with no input): write currently processed phrase and move to the next one
  • F: Finish the current session, write the remainder of the current file and exit
  • S: Skip current section. If it's the last section of the current file, move to the next file
  • R: Retry synonyms. This will simply regenerate the phrase according to its synonymization
  • E: Edit phrase. You will be given a prompt on the new phrase with the source of the old one provided for convenience. Editing will replace the current phrase you're working on but will not yet write it. To write it you'll need to move to the next phrase (hitting "Enter" as mentioned in the first menu option)
  • U: Undo current edits you made to the phrase. This will restore the phrase as it was when you first moved to it in the session. Only possible if you didn't write the phrase yet
  • D: Delete the phrase. You will be prompted to confirm and if you confirm, you can't undo it. You can still hit Ctrl+C preventing the script to write the file though.
  • O: Show the phrase origin. It will display it's raw form without replaced synonyms and also show which synonym replacements are available from your Synonyms.txt database

 

Note:

1. By default the corrector will only work with "1st Person" mode, you can edit this in the file (I didn't bother to add CLI to it as that would mean parsing the shell parameters because I already use the input for the mask). The file is corrector.php and the place is line#32 (it's the only place with that key so you won't miss it). You can set several keys at the same time.

2. Backup your database before using corrector! Your Data/Apropos/Db folder needs to be backed up just in case something malfunctions.

3. As with everything, you can re-define logger in your DI which is located in the main file. That is if you're unhappy that it spams into the command shell.


Other Files from Operand


×
×
  • Create New...

Important Information

We have placed cookies on your device to help make this website better. You can adjust your cookie settings, otherwise we'll assume you're okay to continue. For more information, see our Privacy Policy & Terms of Use