Item Acquisition

Version 4.1 by Alexandros Mloukie on 2025/12/11 15:52

0 - Introduction
- 0.1 - Disclaimer
- 0.2 - Terminology
1 - Sources of Items
- 1.1 - Acquisition Mechanics
  - 1.1.1 - Looting
- 1.1.2 - Foraging

0 - Introduction

This document defines the sources of items within the game, as well as their respective methods of acquisition. It outlines:

The sources through which items are acquired
The acquisition mechanic involved
Details about the technical implementation of systems necessary for the correct function of the gameplay as a whole

0.1 - Disclaimer

This is a living document, and any specifics pertaining to the mechanics, numbers, and more, are subject to change. The assignee of this task is free to apply any values, effects, and other unspecified elements, or contact Adam Janus or @Alexandros Mloukie to get further guidelines.

0.2 - Terminology

Term	Meaning
PC	Player Character

1 - Sources of Items

There are multiple sources of items in-game, though they can be broadly split into 3 distinct categories:

Category	Definition
Entities	This includes collecting items via Looting enemy corpses, as well as collecting resources from neutral/friendly creatures
Environment	This includes Mining, and Foraging resources from inanimate sources
Exploration	This includes item pickups, as well as chests found by exploring the world, or completing quests

Note: These are for items acquired from the environment, and do not include crafting or other processing methods

1.1 - Acquisition Mechanics

1.1.1 - Looting

Looting involves the player obtaining items through an interaction with an actor that can provide a UI. Looting relies on 2 things:

Element	Description
Loot Data Table Entry	An entry in the Loot Data Table, that will define the items, quantities, and weights
Loot Component	A custom component that defines the type and entry used for the loot, as well as allowing the player to interact with the target for Looting

Once these elements have been set up, the process of Looting a target follows these steps:

Calculation
The game calculates the loot based on the target's loot table and the PC's Looting level. These items are added to the Loot Inventory.
Display
The Loot UI and the PC's Inventory UI are both displayed.
Transfer
The player moves items from the Loot Inventory to the PC's Inventory. The opposite can also be done.
Completion
When the player is done, the UI can be closed. If there are still items left within the Loot Inventory, then the actor can persist. Otherwise, depending on type, it can be made to instantly de-spawn.