nltp-ashes / Western-Goods

Western Goods is an addon for the game S.T.A.L.K.E.R. Anomaly.
https://discord.gg/7Z8S2qg
Other
9 stars 3 forks source link
addon anomaly stalker

WESTERN GOODS License

Latest Stable Build [Latest Test Build]() Total Downloads Latest Release Downloads


The Zone is host to people from various horizons. Overtime, the demand for goods imported from the west became such that some traders of the Zone couldn't overlook the potential profit anymore.


ABOUT

This addon was originally a minor addon that added a few drinks and snack from popular brands in western countries. Overtime, it evolved into a full-size game extension, adding new gameplay mechanics, consumables, readable magazines, trade items, devices, unique NPCs, and even a new set of storylines.

Feel free to suggest new items or ideas in general, I'll do my best to add it if it fits the addon.

Western Goods is fully modular, meaning you can pick and choose what you want from it.

CORE MODULE

This module contains all the core logic, and support for all functionalities of the addon. On its own, it does not add anything (think modded exes). It can even be used by other addons if they want features from Western Goods, but not the content of it. All the other modules of the addon require this one to work.

STORYLINES MODULE [REQUIRES NPCs MODULE]

This module adds 3 new storylines.

Helicopter Delivery

  • 3 missions - started in the Book Store, Pripyat Outskirts
  • Investigate the crash of a Mercenary helicopter carrying valuable goods.

Contract Work

  • 2 missions - started in the Mercenary base, Deadcity
  • After proving yourself, Dushman will get you in touch with a mysterious client, for a special contract.

The Chernenko Brothers

  • 4 missions - started at the Flea Market, Garbage
  • Help a former soldier turned Mercenary trader to find his missing brother.

DEVICES MODULE

This module adds brand-new devices to the game. From a GPS locator to help you find the nearest camp, a laser range finder to adjust your shot on your target, an electronic compass to help you navigate the harsh landscapes of The Zone, to a lighter to illuminate your surroundings in the cold nights, this module has you covered.

NPCs MODULE

This module adds new unique NPCs to game. On this own, this module won't have much to offer you, as NPCs will have nothing but a meet dialog. This module is meant to be used in conjunction with other modules, like the Flea Market, Procedural Guides, Currencies and Storylines modules.

FLEA MARKET MODULE [REQUIRES NPCs MODULE]

The flea market module adds a new feature to the game. At the Flea Market, at the Garbage, meet a new NPC that will offer you packages of randomized items at a discount. Be quick, offers aren't permanent and expire after some time!

PROCEDURAL GUIDES MODULE [REQUIRES NPCs MODULE]

This module will make Ashot (Jupiter), Professor Ozersky (Jupiter) and Peregrine (Yantar) be able to guide the player, using a brand-new system to dynamically make NPCs guides.

READABLES MODULE

The readables module uses one of the functionalities offered by the core module : the ability to read items, whether they would be magazines, or notes, and so on. The module adds different kinds of magazines. To limit the size of the archive, only the first page of each magazine is available by default. Download the Western Goods Readables Extended addon to get extra pages.

CURRENCIES MODULE

This module adds new currencies to the game, namely Euros and Dollars. You can exchange these currencies, and even make purchases with them if you have the NPCs module installed.

FOOD MODULE

The food module adds a variety of western branded consumables to the game. All of them come with custom icons, models, and textures. If you use the Food, drug and drinks animations addon, you'll also get animations for some of them.

DRINKS MODULE

Similar to the food module, this module adds various european and american drinks to the game. Again, they all come with custom icons, models and textures and FDDA animations if you use it.

Illustrations
Showcase Food New food/snacks Showcase Drinks New drinks Showcase Magazines New (and readable) magazines
Showcase GPS New device: GPS Locator Showcase Rangefinder New device: Rangefinder Showcase Garmin eTrex 10 New device: Garmin eTrex 10
Showcase Bic Lighter New device: BIC lighter Showcase Zippo lighter New device: Zippo lighter Showcase Flea Market New feature: Flea Market
Showcase Tasks New storylines Showcase NPCs New NPCs Showcase Procedural Guides New feature: Procedural guides

REQUIREMENTS

These addons are absolutely required in order for Western Goods to work :

  1. S.T.A.L.K.E.R. Anomaly 1.5.2;
  2. DLTX and DXML.

Western Goods natively integrates with the following addons, but they aren't required :

  1. Mod Configuration Menu (allows you to customize some options about the addon);
  2. Food, drug and drinks animations (enables use animations for some consumables);
  3. Anomaly Barter UI Framework (allows you to make EUR/USD/RUB currency exchanges);
  4. Pinup Collector (allows you to collect some magazine pages to your wallet);
  5. Device Selector Key (makes it easier to switch between various devices);
  6. New Levels (adds new levels to the game);
  7. Interactive PDA (adds more interactions with the world (and not only) via PDA);
  8. Western Goods Readables Extended (adds more pages to magazines in the addon).

These patches should be used when native compatibility with other addons cannot be achieved :

  1. Patch for Realistic Bodily Needs v3.8 (fixes food and drink statistics).
  2. Patch for vanilla Anomaly 1.5.2 devices (fixes a broken shader from Anomaly 1.5.2).
  3. Patch for Food Drugs and Drinks Animations v0.9 (fixes a broken animation from FDDA).

These addons can be used to enhance the experience, but aren't required :

  1. Cr3pis Icons (improves the quality of the inventory icons);
  2. Fair Fast Travel (better calculations for the time and money using a guides takes).

INSTALLATION

To install the addon :

  1. Download and install the requirements;
  2. Download this addon;
  3. Using MO2, click the "Install a mod from an archive" button;
  4. Follow the instructions.

To update the addon :

  1. In MO2, disable and delete the previous version of the addon;
  2. Make sure to update the requirements;
  3. Make sure to check the changelog for extra steps;
  4. Follow the installation instructions.

To uninstall the addon :

  1. Start your game and open the MCM settings;
  2. Enable the "Addon removal" option;
  3. Load your save-game. Once loaded, save again;
  4. Close your game, disable and delete the addon from MO2.

CHANGELOG

You can check out the changelog of the last update in the CHANGELOG.md file.

For past updates, please refer to the description of each release, in the releases tab.


FUTURE WORKS

You can find a GitHub board about the development of the addon by following this link.

If you would like to help development for future updates, you can :

  1. Contribute to the addon, either by getting in touch with me or creating a fork of the addon and creating a pull-request on the addon's GitHub repository;
  2. Help by play-testing updates by getting Release Candidates builds on the addon's GitHub repository.

KNOWN ISSUES

Note : If you have issues, check the list of common issues (and their associated solutions) on page 5 of the comments.

If you truly believe your problem is new, please open an issue on the addon's GitHub page.


SUPPORT & SUGGESTIONS

If you need help with anything, or if you have any suggestions, you can :


SPECIAL THANKS & CREDITS

Credit goes to these people for their work contained in this addon :

Name Motive License
Lizzardman Created a set of animations for the Zippo and Bic lighters Proprietary
Lizzardman, MFS team Ported food animations (MRE, chocolate bar & chocolate plate) from their mods Proprietary
Dead Air mod Ported a Zippo model, texture and animations from their mod Proprietary
Kyne's Peace Created a model and a set of animations for the BIC lighter Proprietary
_TheDJ Produced two sound effects for the lighter Proprietary
VodoXleb Translated the entire addon to Russian Proprietary
Barry Bogs Adapted the Rangefinder model on their set of animations Proprietary
Kyne's Peace Ported and prepared the Rangefinder model for X-Ray Proprietary
valterjherson1 Reused his 3D model of a SIG SAUER KILO5K Rangefinder CC BY 4.0
Barry Bogs Adapted the GPS locator model on Dosimeter animations Proprietary
GhenTuong Reused his xr_logic_ex script Proprietary
arti Reused his trader_autoinject script Proprietary
SvetkaDystopia Produced four models for consumables Proprietary
Feel_Fried Reused some files from his Food, drug and drinks animations PD 1.0
RavenAscendant Wrote the code that takes control of helicopters' combat AI Proprietary
lauta_ro Reused part of his More Guides addon Proprietary
HarukaSai Reused one of his script functions Proprietary
MrDemonized Reused multiple of his script functions Proprietary
Aoldri Reused icons from his Hideout Furniture addon Proprietary
SODAZ Adapted his fan film into an in-game task Proprietary
A.R.E.A. mod Ported some models from their mod Proprietary
Anomaly mod Provided such a good modding base, and for their assets used in this addon Proprietary
segaretro.org Provided the textures for the xbox magazines CC BY 4.0
archive.org Provided the textures for the men magazines CC BY-NC-ND 4.0
commons.wikimedia.org Provided various logos and resources used in textures PD 1.0
freepik.com Provided various logos and resources used in textures License

Special thanks to these people for their help in the making of this addon :

Name Motive
MrDemonized For allowing the use of a sound effect from one of his addons
lexus , L4U6H1N6-LUN4T1C, Lizzardman For providing help during the development of the Zippo lighter
Lucy For their continued help with explaining the most confusing problems when working with this game's engine
Crepis Replaced fake markings for real ones on the Garmin eTrex 10
RavenAscendant, MrDemonized, Catspaw, VodoXleb, L4U6H1N6-LUN4T1C For the help they provided during the development of the Garmin eTrex 10
Tosox For contributing to the addon, however small that contribution was, it is always appreciated!
Kyne's Peace For being such a homie 🥹
Rambito For voluntarily providing a compatibility patch with Realistic Bodily Needs
Lucy, MrDemonized For fixing the issue that caused 3D UIs to be transparent when not backed by another texture
Barry Bogs, Kyne's Peace For dedicating some of their free time to helping me with modeling/animation
RavenAscendant, Lucy Helped to mitigate an issue from vanilla Anomaly 1.5.2 that caused detectors displays to be transparent
__R3D For submitting such a well-presented idea that lead to the Flea Market system
NLTP_JODYE, Niko, NLTP_DEV, Sark, ItsErisContent For play-testing pre-release builds of the addon
RavenAscendant For providing help with adding native Pinup Collector integration
SvetkaDystopia For taking the time to make models for this addon, enormous thanks
xcvb, RavenAscendant Help for so many things it'd be too long to list. Huge thanks to these two
Starcry_, Rascal, lauta_ro Helped to mitigate a compatibility issue with DirectX 8
arti For making his Barter UI Framework
arti For having updated the barters config files to work with the newer version of his framework

LICENSE

Everything contained in Western Goods and made by me, NLTP_ASHES, is licensed under Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0).

This means you're allowed to redistribute and/or adapt the work, as long as you respect the following criteria :

For the work that wasn't made by me, unless a licence is specified in the Credits or in the files themselves, consider these works proprietary. If you want to reuse those, please get in touch with their original authors.