Hideout Furniture (HF) v2.2.1 addon - S.T.A.L.K.E.R. Anomaly mod for S.T.A.L.K.E.R.: Call of Pripyat

Prerequisites

• Latest version of modified exes by Demonized
  • Find the .zip in the Github repo and unpack directly into the Anomaly game folder.
  • Minimum version: 2023.05.22
• Anomaly Mod Configuration Menu

Optional

• Anomaly Radio Extended
• Igi's Weird Task Framework
• Anomaly Popup Messages

Installation

1. Use Mod Organiser 2
2. Install the zip as a FOMOD

This bundles in various dependencies that can be omitted if you already have the latest versions in your load order. I highly suggest you isolate these dependencies and update them as their own mods to ensure the latest versions of the scripts are used.

New versions (as of v2.1.0) should automatically migrate any saves using an old version of HF.

Features

Lights

There are three light sources: metal torches, gas lamps, and a psi light.

Each have their own required fuels and different durations. The metal torch can be crafted.

With WTF, the psi light can be obtained through an artefact hunting mission from Sakharov after turning off the Miracle Machine. Without WTF, it can be obtained by Ecologist or Monolith traders at a high goodwill.

Stashes

Four different stashes: a small sack, an empty repair kit, a gun case, and a metal box.

The small sack can be crafted from small sheets and a sewing kit (drag n' drop in inventory), while the others need to be purchased from a trader. The larger stashes, like the gun case and metal box will require a higher goodwill with the faction. An optional file is included to make the different stashes meaningfully different from each other by adding capacities to each in ascending order.

The new stashes can be picked up by clicking 'Take All' when the stash is empty.

Radio

Broken radios can now be repaired through crafting recipes and play music. Currently, it uses the PDA's radio stations, but can be expanded to include other playlists (see 'configs\plugins\placeable_radio\')

Portable Workshop

This workshop can be moved around and placed wherever, allowing for the use of toolkits away from faction bases.

It includes an integrated stash, which moves its items into the player's inventory during crafting and repair, and back into the stash once finished.

With WTF, this is obtained by completing a repair task from a technician, after giving away all three tiers of toolkits. Note that, in this task, the weapon must be completely repaired - including its internal parts.

This can also be obtained by trading with traders at a high goodwill (supply level 3).

Playable Piano

This piano can be played using the keyboard. Each button on the keyboard corresponds to a note on the keyboard, and is arranged with respect to the QWERTY keyboard.

There are additional options for selecting and filtering different sheets included in this addon, and for changing aspects of the piano itself, including transpose, volume, and instruments. New sheets can be added by looking into 'configs/plugins/playable_piano/sheets'.

The notation for the sheets are as follows (pretty much following the virtualpiano.net notation):

• Wholenote delay: 'g|g|g|g'
• Halfnote delay: 'g g g g'
• Quarternote delay: 'gggg'
• Eighthnote delay: '[g g g g]'
• Play 'ad' and 'sf' at the same time: '[ad] [sf]' (halfnote delay)
• Play 'ad' and 'sf' at the same time: '[ad sf]' (eighthnote delay)

Sheets can be found in communities that use this same notation, including virtualpiano.net, r/virtualpiano, and Tower Unite.

This is obtained by trading with Loner or Bandit traders at a high goodwill (supply level 3).

Changelog

See the full changelog on Github!

2.2.1

Bug Fixes

• Fixed crash when loading old saves (Thanks Rambito!)

2.2.0

Update your modded exes!

Features

• Add popup to show available controls during placement
• Spawn world objects per-entry, instead of once per save
• Add human-readable ltx files for spawning objects (see configs/world_objects/spawns.ltx)
• Register world objects' story id

Bug Fixes

• Continue spawning world objects even if one fails
• Disabled movement during advanced placement
• Fixed crash when dropping weapon displays (Thanks Rage4556!)

2.1.1

Bug Fixes

• Fix loner traders not having loner-specific items
• Fix crashing on 4:3 resolutions when opening radial menu

2.1.0

Features

• Create save game migration system
  • Old saves using 1.1.4 should now just work™

Bug Fixes

• Remove debug prints in WTF module

Code Refactoring

• Remove deprecated callbacks

Builds

• Tick default options in fomod

2.1.1

Bug Fixes

• Fix loner traders not having loner-specific items (Thanks Rambito!)
• Fix crashing on 4:3 resolutions when opening radial menu

2.0.0

Breaking Changes

• This update requires 1.5.2 modded exes
• Significantly refactored code, including script binders which means any third-party furniture will need to be updated for this version

New Features

• Added a mode to placement system: Automatic Surface Alignment
• Added a mode to placement system: Intuitive Controls
• Created a primitive data store for furniture (e.g. fuel)
• Added 'World Objects': Ability to add objects that spawn once in the world
  • Lights will have infinite duration
  • Objects cannot be picked up
  • See guide for how to add world objects
• Added 'Creative Mode': Ability to select and place objects without needing to use their item variant
• Enabled Autoplay on the piano to continue outside of the UI
• Added Quick Use on single tap and a generic Radial Menu on hold when using the interact key on furniture

New Objects

• Weapon Displays, by Utjan

Bugfixes

• Fixed supply level 3 overriding supply level 2 for renegades
• Fixed bounding box not detecting dynamic objects

Other

• Restructured the mod into the FOMOD format, placing various objects into distinct thematic modules
• Restructured MCM settings into categories, which will probably revert settings from previous versions

Video Demo

The Future

• Need to see demand for binding different notes to different keys for non-standard keyboard formats
• Russian translation may need touching up, as it was done via DeepL. Largely done by VortexBomb!
• May add new piano sheets from existing communities
• Open to anyone wanting to make better models
• Open to suggestions of furniture with functionality (no decorative objects for scenery - this includes tables and chairs)
• Plan to implement automatic alignment of objects to surfaces, for ground, walls, and ceilings (require 1.5.2) Complete as of 2.0.0
• Plan to add system for interaction between furniture objects, including traps and triggers.
• Plan to add system for enhancing/upgrading furniture, including camp beds.
• Plan to add hacking minigame similar to Eve for looted PDAs, and include additional possible rewards.
• Looking into (but not guaranteed) emission detectors, message broadcasters, shooting targets, dummy cardboard cutouts, and artefact research stations (passive money generator).

FAQ

• "My game crashes with the error: 'Can't open section 'tch_junk''!"
  • You need a modified .exe that implements DLTX, available here: Github.com
• My game crashes with the error: "attempt to call field 'get_real_community' (a nil value)!"
  • You have an outdated version of trader_autoinject.script - hide it through MO2, make sure HF is winning the conflicts, or make a separate mod containing dependencies from Arti ( Github.com ) and give it the highest priority.
• I can pick up guns from the weapon rack and it duplicates the guns!
  • A few things: Update modded exes since it contains a fix for the relevant callback; This error isn't present in an otherwise vanilla install; Other mods misusing the callback can cause this bug to happen.
  • So far, the main culprit is FDDA so yell at them to respect the flag set by the actor_on_item_before_pickup callback

• "How do I pick up stashes?"
  • Press the "Take all" button when the stash is empty.
• "Can you add tables / chairs / [Insert other decoration]"
  • No. If you want to make some yourself, see the guides I have made.

Comments

• If you want to make your furniture or placeable objects, you can refer to my set of online guides.
• Version naming should follow Semantic Versioning as of v2.0.0
• If you have a reproducible bug, report it on here or on the Anomaly Discord (preferably the latter). Please include clear instructions on how to replicate it, alongside your error log. Brownie points if you submit an issue on the Github.

Credits

Thanks to Utjan for creating the Weapon Displays.

Thanks to VortexBomb for improving the Russian translation to be closer to base Anomaly localisation.

Many thanks to ShabbyPirate, Apathy_Knight, BarryBogs, and others in the Testudo Cohort for playtesting in game.