[1.5.1/1.5.2] Banjaji's Crafting system improvements v4.4 addon

Features

• Full remake/improvement of v3.x. You need to do clean install (fully uninstall everything from v3.x and install v4.x). v3.x recipe format is incompatible with the new format, so other mods need to catch up. Meanwhile you can use v3.2.

For players:

• Framework for more complex crafting mods
  • Drag-drop recipes take only one use from multi-use items and bullets
  • Crafting statistic increases with drag-drop crafting
  • Crafting window stays open after crafting (inspiration from TheMrDemonized but implemented differently).
• New UI related to crafting:
  • New workshop crafting window UI. This is redesigned to accommodate infinite components, tools and results. Window tip says which notes need to be read to unlock a recipe.

• • New note reading UI. You can read note text on old paper UI immediately after reading the note. The note has all unlocked recipes listed under the text and these are clickable (grey items require more notes). Clicking on recipe shows its recipe like in workshop. Escape key closes the UI, right mouse button goes back/closes the UI.

• • PDA encyclopedia (guide) shows unlocked recipes under the note that unlocked them. Added page numbers to note article recipes.
  • PDA encyclopedia (guide) has new article "Known recipes" that lists all at least partially unlocked recipes and draws a table of contents and page numbers for finding a certain recipe category. If at least one required note is read then the recipe shows.

• MCM options for minimum crafting item condition and whether to delete note after reading (default is no).

For modders:

• A lot of freedom with crafting recipes.
• New recipe format (again!) that allows any (0 to infinity) number of different items. That is any number of different components and tools and resulting items and notes required to unlock the recipe. This way you can e.g. make a recipe that doesn't require anything (free spawner) or you can have cooking in crafting window since field cooker is used as tool kit.
• Each item can also have any number required/output. Minimum input is 1 use (multiuse items), 1 bullet (bullet box) or 1 normal item. Previously you couldn't deal in individual bullets, but only in bullet boxes.
• Items can be output with below 100% condition.
• Any note can be used for unlocking recipes. That is e.g. monolith prayer note can be used as a note that's required for some recipes.
• Tool kit can be any item in the game. Smash scrap metal into roubles with your rpk or cook stuff with a field cooker, scrap and boar tusks.
• Any item can be shown as recipe icon, name and description. If you create a new item then you can have custom icon, name and description.
• One function to rule them all! Made a centralized script aa_load_recipes_Banjaji.script that reads recipes and prepares them. Everything else should access that one, so no more duplicate code. The script is written with other scripts accessing it in mind.
• Code is less hardcoded and more forgiving to sloppy crafting recipe format in LTX.
• You can make quick recipes like "a_detector_geiger = detector_geiger" (won't need anything to craft).
• craft.ltx includes all associated files "craft_*.ltx" similarly to new item files. This means every modder can have his own file and his own recipe sections.
• A new recipe section (square brackets) can have any number from -10 000 to 10 000 (-500, -400, ..., 0 are original recipes now) instead of just next number from last one. Now we aren't competing for the 7th section (original sections were 1-6).

Conflicts

• Ahuyn's Workshop Autoinject ( Github.com ). My mod makes it easy to add new recipes and to modify them through scripts, so Workshop Autoinject is redundant.

Goes well with

• Banjaji's Disassembler's dream ( Moddb.com ) - possibility to disassemble everything

Some addons

• For v3.2:
  • Real_reaper's Readable recipes for Banjaji's Crafting system improvements ( Moddb.com )
  • Real_reaper's Banjaji's Crafting system improvements + artifex's addons compatibility v1.1.0 ( Moddb.com )
• Unwary's Hunter Survival Crafting 0.7d ( Moddb.com )
• Hiipandanaserver's {1.5.1} Multi-Cook Low Tier Meat with BANJAJI'S CSI v2 ( Moddb.com )

Instructions for making recipes

• Specific instructions are in craft.ltx. In short you can still use vanilla format but with its limitations. Otherwise there are 4 categories (and identificator on left side of the equation): results, notes, tools and components, spearated by "\".
• To modify original recipes modify craft_vanilla.ltx directly or use DLTX. DLTX is in modded exes: Github.com
• You can make a new file that defines your new recipe sections and is named "craft_*.ltx" where "*" can be anything without "_" character ("craft_mine.ltx" is okay but "craft_mine_craft.ltx" will crash the game).
• It will be automatically included and won't be overwritten by other mods that add recipes (unless they do it by scripts on purpose).
• Under each section add a variable for the tab name eg. like in the original "title = st_ui_craft_device". If no such variable exists in xml files then the variable name itself gets written.
• You can create a new recipe tab by creating a new section in any craft_*.ltx file. the section name needs to be craft_x, where x is a number between -10000 and 10000. Original sections are now -500, -400, ..., 0. The tabs are ordered in the ascending number order.
• When creating a new section USE A RANDOM NUMBER GENERATOR!! That minimizes the chance that your number is the same as in some other mod. You can't have 2 sections with the same name or xray crashes.
• Note that in debug mode you need to reload ini and reload the game for the effects to apply. Otherwise you need to restart the game (the whole program). Mod Organizer 2 doesn't register new files after it has been launched. So, you might have to restart MO2 too when adding new files.
• After creating a new file, section and/or recipes, the new recipes will appear under the tabs in the recipe book. If there are no new recipes then you probably did something wrong in the previous steps.
  
  

How did I do it?

I rewrote almost the entire ui_workshop.script's crafting part. I also almost fully rewrote ui_pda_encyclopedia_tab.script's part where it shows unlocked recipes. I also almost fully rewrote item_recipe.script. I added aa_load_recipes_Banjaji_CSI.script as the central recipe loading script. I messed around for weeks with the UI elements. (UICellContainer and CUIScrollView classes can go fuck themselves!) If you want to know what and how then read my comments in the monkeypatch script. Also I wrote "#include "craft_*.ltx"" into the original LTX file so that new recipes can be added easily from new files and I moved vanilla recipes to craft_vanilla.ltx.

Installation

Use mod manager or drop and merge gamedata folder to Anomaly main folder. Delete the files to revert back to vanilla. Or simply disable the mod in Mod Organizer 2.

1. Uninstall everything from this mod you had previously.
2. Install dependencies. Install MCM ( Moddb.com ) and Modded EXEs ( Github.com ). Without those the mod won't crash and recipe system keeps working but you will lose some decorative features and gain some bugs.
3. Install main mod. Drop the gamedata folder from mod's main folder into Anomaly's main folder or enable it from the Mod Organizer 2. Give it low priority, so that other mods overwrite CSI.
4. Install patches. After installing the parent mods drop the gamedata folder from mod's patch folder into Anomaly's main folder or enable it from the Mod Organizer 2.
5. Check the test/example. Drop the gamedata folder from test folder into Anomaly's main folder or enable it from the Mod Organizer 2. If all went well then two recipe tabs show up in the recipe book just like in the preview image. Uninstall the test.
6. Check the test/example drag-drop. Drop the gamedata folder from test folder into Anomaly's main folder or enable it from the Mod Organizer 2. If all went well then you can drag-drop Mil-spec textiles onto Nemiroff vodka and vice versa to craft bandages.
7. Uninstall. Delete the files to revert it back to vanilla. Or simply disable the mod in Mod Organizer 2.

Final words

You can modify my changes or ideas in any way you want. However if your work is based largely on my ideas then please give credit! In case you find bugs please let me know! This was a massive project and I already tested this for weeks but certainly some slipped through.

Changelog

v1.1

• More freedom in defining recipe sections (numbers 1 to 1000)
• Recipes take at least 1 component instead of at least 2.
• Changed "craft.ltx" file so that original contents are now in 8 files (6 recipe sections, basic item combinations and itself). "craft.ltx" includes contents from all "craft_*.ltx" files in that folder.

v2.0

• Added option to craft without toolkits
• Added Thisisntmysteamid's mod "Fixed Crafting With Multi-Use Items v2.5" main file

v3.2

• Full remake/improvement of the mod to the extent that I renamed it. Introduced monkeypatches and craft.ltx modified for the new system.
• Updated for Anomaly v1.5.2.
• Changed ui_workshop.script into vanilla file to indicate this mod changes something there and added a monkeypatch in a separate script. This is for different mod compatibility.
• Crafting tab index ranges now from -10 000 to 10 000. Vanilla sections are now -500, -400, ..., 0.
• Changed crafting section names from eg. [1] into more specific [craft_1].
• Crafting window stays open after crafting. I got inspiration from TheMrDemonized's Keep Crafting Windows Opened but in the end implemented it differently.
• Made the vanilla code less hardcoded and more forgiving to sloppy format of crafting recipes in LTX.
• For the crafting recipe layout in LTX see the test file. I commented everything there.
• Added a possibility to craft multiple items in one crafting.
• Added a possibility to craft items without resulting amount, tool kits, recipe books and/or components.
• Any item can be used instead of a tool kit. That item won't get used up when crafting. You can cook with 4 components now.
• You can have infinite amount of components for future updates of Anomaly/this mod but only the first 4 are considered. Adding more requires tinkering with GUI elements (little did he know, when he was writing this, that in the future update GUIs would become his biggest enemies).

v4.0

• HUGE update
• Changes crafting recipe format (again!). You need to uninstall previous version and then install this one. v3.x crafting format is incompatible with v4.x crafting format.
• New workshop crafting window UI. This is redesigned to acommodate infinite components, tools and results. Window tip says which notes need to be read to unlock a recipe.
• New note reading UI. The note has all unlocked recipes listed under the text and these are clickable (grey items require more notes). Clicking on recipe shows its recipe like in workshop.
• PDA encyclopedia (guide) shows unlocked recipes under the note that unlocked them. Added page numbers to note article recipes.
• PDA encyclopedia (guide) has new article "Known recipes" that lists all at least partially unlocked recipes and draws a table of contents and page numbers for finding a certain recipe category.
• MCM options for minimum crafting item condition and whether to delete note after reading.
• New recipe format allows any (0 to infinity) number of different items. That is any number of different components and tools and resulting items and notes required to unlock the recipe.
• Possibility to require/give partial uses (not full uses item) and single bullets (not bullet boxes).
• Possibility to give item with below 100% condition.
• Any note can be used for unlocking recipes. That is e.g. monolith prayer note can be used as a note that's required for some recipes.
• Any item can be shown as recipe icon, name and description. If you create a new item then you can have custom icon, name and description.
• New patch: Utjan's Crafting Info in Tooltips: ( Moddb.com )
• Removed patch for HarukaSai's Fillable canteens. v2.0 doesn't need it anymore ( Moddb.com ).
• Changed patch for TheMrDemonized's Keep Crafting Windows Opened (need to do clean update including patches).
• Removed Thisisntmysteamid from credits because I rewrote the whole script and didn't include his edits anymore.
• One function to rule them all! Made a centralized script aa_load_recipes_Banjaji.script that reads recipes and prepares them. Everything else should access that one, so no more duplicate code. The script is written with other scripts accessing it in mind.
• Took recipe sections from craft.ltx and put them into craft_vanilla.ltx.
• Removed DLTX version. It simply didn't have a good reason to exist. Shoutout to Real_leaper for discussing these things in the comments (Jun 9 2023).
• Removed unmodified vanilla scripts from the mod files. In the end there weren't enough plusses for keeping them.
• Wrote code, so that it could be monkeypatched in the future.
• UICellContainer and CUIScrollView classes can go fuck themselves!

v4.1

• Wrote code more monkeypatchable (more functions), sent more callbacks. Monkeypatched only the ui_workshop functions I had to, lobotomized others.
• Lowest condtition items are used first in crafting (inspiration from Utjan's QoL mod)
• Patch for Orleon's Experience Framework Moddb.com
• Patch for Arti's Anomaly Ballistics: Github.com

v4.2

• Fixed lobotomized function calls and some potential crashes. Fixed a bug in Arti's Ballistics patch.
• Added some checks to prevent crashes regarding recipes. Otherwise users blame me for bad recipes from other addons.

v4.3

• Updated patch for Experience Framework v2.1

v4.4

• Drag-drop recipes take only one use from multi-use items and bullets
• Crafting statistic increases with drag-drop crafting
• Modders can define (or modify through scripts) whether recipe gives one use or full item and whether recipe takes one use or full item
• Callbacks for drag-drop start and end