Skip to content
Snippets Groups Projects
Commit fb4f4be3 authored by x's avatar x
Browse files

Update readme to explain the vast majority of sanityCheck output

parent 4724a3dc
No related branches found
No related tags found
2 merge requests!2129Update readme to explain the vast majority of sanityCheck output,!2047RA rework
Common problems:
I want to report a sanityCheck issue.
-Great, however a large majority of the results are false postivies coming from those specific sections breing split over several lines in the name of readability and git grep's intentionally (http://git.661346.n2.nabble.com/bug-git-grep-P-and-multiline-mode-td7613900.html ) lacking support for multiline. An Attempt to add -Pzl (https://gitgud.io/pregmodfan/fc-pregmod/merge_requests/2108 ) created a sub condition black hole. What follows is the entire list of false positives that can safely be ignored;
[MissingClosingAngleBracket]src/art/vector/Generate_Stylesheet.tw:11:<<print "<style>."+_art_display_class+" {
[MissingOpeningBracket2]src/uncategorized/RESS.tw:1893: <<set _possibleDrugs.push({type: "dick", text: "peni<<s>> enhan<<c>>ement? I know I'm a <<s>>e<<x>> <<s>>lave and it'<<s>> my pla<<c>>e to get fucked, but when I do get to do a girl, <<Master>>, I want to <<if canSee($activeSlave)>><<s>>ee a little fear in her eye<<s>><<else>>feel her a<<ss>> clench in fear<</if>>."})>>
[MissingClosingBracket2]src/uncategorized/RESS.tw:1893: <<set _possibleDrugs.push({type: "dick", text: "peni<<s>> enhan<<c>>ement? I know I'm a <<s>>e<<x>> <<s>>lave and it'<<s>> my pla<<c>>e to get fucked, but when I do get to do a girl, <<Master>>, I want to <<if canSee($activeSlave)>><<s>>ee a little fear in her eye<<s>><<else>>feel her a<<ss>> clench in fear<</if>>."})>>
[MissingClosingAngleBrackets]src/init/setupVars.tw:1021:<<set _namePool =
[MissingClosingAngleBrackets]src/pregmod/widgets/economyWidgets.tw:10: <<run
[MissingClosingAngleBrackets]src/pregmod/widgets/economyWidgets.tw:116: <<run
[MissingClosingAngleBrackets]src/pregmod/widgets/economyWidgets.tw:222: <<run
[MissingClosingAngleBrackets]src/pregmod/widgets/economyWidgets.tw:307: <<run
[MissingClosingAngleBrackets]src/pregmod/widgets/marketWidgets.tw:13: <<set _widgets = _(Story.widgets)
[MissingClosingAngleBrackets]src/pregmod/widgets/pregmodWidgets.tw:1224:<<set _namePool =
[MissingClosingAngleBrackets]src/pregmod/widgets/pregmodWidgets.tw:1233: <<set _namePool =
[MissingClosingAngleBrackets]src/pregmod/widgets/pregmodWidgets.tw:1254:<<set $args[0].birthName =
[MissingClosingAngleBrackets]src/uncategorized/main.tw:37: <<= _($slaves)
[MissingClosingAngleBrackets]src/uncategorized/main.tw:59:<<set
[MissingClosingAngleBrackets]src/uncategorized/slaveSummary.tw:189: <<if (_Slave.assignment == "be your Head Girl")
[MissingClosingAngleBrackets]src/utility/slaveGenerationWidgets.tw:4:<<set $args[0].race
[MissingClosingAngleBrackets]src/utility/slaveGenerationWidgets.tw:9:<<set $args[0].birthName =
[MissingClosingAngleBrackets]src/utility/slaveGenerationWidgets.tw:13:<<set $args[0].birthSurname =
[OnlyUsedOnce]pregmod/widgets/pregmodWidgets.tw:340: <<set $Hers = capFirstChar($hers)>>
[OnlyUsedOnce]pregmod/widgets/pregmodWidgets.tw:342: <<set $Himself = capFirstChar($himself)>>
[OnlyUsedOnce]pregmod/widgets/pregmodWidgets.tw:343: <<set $Girl = capFirstChar($girl)>>
How do I start the game?
-Run the compile file, go to folder "bin", click the "FC_Pregmod" and play. (Recommendation: Drag it into incognito mode)
......@@ -16,32 +41,32 @@ How to mod (basic doc):
2. Special files and dir's:
- src/config - configuration of the story is here.
- src/config/start.tw - contains list of .tw passage files, regenerated automatic, by building scripts. Do not change by hands. (origial passage Start from pregmod renamed and moved to src/events/intro/introSummary.tw)
- src/js/storyJS.tw - special passage with [script] tag - contain all native JavaScript from pregmod.
- src/config/start.tw - contains list of .tw passage files, regenerated automatic, by building scripts. Do not change by hands. (origial passage Start from pregmod renamed and moved to src/events/intro/introSummary.tw)
- src/js/storyJS.tw - special passage with [script] tag - contain all native JavaScript from pregmod.
- devTools/tweeGo/targets/sugarcube-2/userlib.js - on original FC JS moved here (I deleted it after moving JS to storyJS.tw). Compare to storyJS.tw but do not copy file here. May conflict with src/js/storyJS.tw if copied.
- src/pregmod - I put all pregmod-only passages here.
- .gitignore - special file for git - to ignore some files. For example - compilation results.
3. Compilation:
3. Compilation:
Windows:
Run compile.bat - result will be file bin/FC_pregmod.html
Second run of compile.but will overwrite bin/FC_pregmod.html without prompt.
Linux:
Ensure executable permission on file "devTools/tweeGo/tweego" (not tweego.exe!)
Ensure executable permission on file "compile"
Ensure executable permission on file "compile"
In the root dir of sources (where you see src, devTools, bin...) run command "./compile" from console
compile-git will produce the same result file but with current commit hash in filename.
Mac:
Not supported directly (I don't have access to Mac for testing).
Mac:
Not supported directly (I don't have access to Mac for testing).
But you can use linux compilation script if you download tweego for mac from here: https://bitbucket.org/tmedwards/tweego/downloads/ and replace linux executable with mac executable in ./devTools/tweeGo/ folder. This is not tested though, so be warned.
4. Simple comparing and merging with original FC:
Use meld tool. Place folder FreeCities (original FC sources tree) near FreeCitiesPregmod (this sources tree) and use command:
meld FreeCities FreeCitiesPregmod
meld FreeCities FreeCitiesPregmod
or just select these folders in meld's GUI.
5. All modders will be very grateful if anyone who makes some changes to game with .html file also post his/her resulting src folder tree.
......@@ -50,13 +75,12 @@ How to mod (basic doc):
7. Git workflow:
- Master branch is pregmod-master. Only Pregmodder can add something to it directly. Always contain his last public changes.
- pregmod-dev - branch with experimental code mainly by pregmodfan.
- pregmod-dev - branch with experimental code mainly by pregmodfan.
- Any contributions will be placed in separate branches like pregmod-mod-<something> (if it's ready to merge with master complete feature/mod) or pregmod-contrib-<something> if it's partial work until contributions is reviewed.
Typical cycle with git:
1. Make account on gitgud if you don't have usable one.
2. Fork main repository through gitgud interface. (Or pull changes from main repo if you already have fork.)
3. Clone your fork to local machine with git client (Or pull changes if already cloned.)
4. Make you changes as you like, commit, and push result into your forked repository (with git client).
5. Make merge request through gitgud interface.
\ No newline at end of file
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment