DyEcon

A lightweight Python library for building dynamic game economies with shared item values, local inventories, and adaptive pricing.

Concepts

DyEcon is built around two classes:

Economy

Stores the global base values for items.

economy = Economy({
	wood: 5,
	ore: 10,
})

SubEconomy

Stores local inventory quantities and price modifiers.

town = SubEconomy(economy)
merchant = SubEconomy(economy)

Each SubEconomy can have different quantities and prices for the same items.

---

Quick Start

from dyecon import Economy, SubEconomy

wood = "Wood"
ore = "Ore"

economy = Economy({
	wood: 5,
	ore: 10,
})

town = SubEconomy(economy)

town.add_item(wood, 50)
town.add_item(ore, 10)

town.change_modifier(wood, -20)
town.change_modifier(ore, 50)

print(town.get_quantity(wood))
print(town.get_value(wood))

print(town.get_quantity(ore))
print(town.get_value(ore))

Output:

50
4

10
15

---

Economy

Create an Economy

economy = Economy()

Create an Economy with Items

economy = Economy({
	wood: 5,
	ore: 10,
})

Set Base Value

economy.set_base_value(wood, 5)

Get Base Value

economy.get_base_value(wood)

Get Modified Value

economy.get_value(wood, modifier=25)

---

SubEconomy

Create a SubEconomy

town = SubEconomy(economy)

Set Quantity

town.set_quantity(wood, 100)

Get Quantity

town.get_quantity(wood)

Add Items

town.add_item(wood, 10)

Remove Items

town.remove_item(wood, 5)

Returns:

True

or

False

if insufficient quantity exists.

Check Inventory

town.has_item(wood, 10)

Returns:

True

or

False

Set Modifier

town.set_modifier(wood, 25)

Change Modifier

town.change_modifier(wood, -5)

Get Modifier

town.get_modifier(wood)

Get Item Value

town.get_value(wood)

This automatically applies the local modifier to the item's global base value.

Iterate Through Inventory

for item, quantity in town.get_items():
	print(item, quantity)

---

Example: Town Economy

from dyecon import Economy, SubEconomy

wood = "Wood"
ore = "Ore"

economy = Economy({
	wood: 5,
	ore: 10,
})

town = SubEconomy(economy)

town.add_item(wood, 100)
town.add_item(ore, 2)

town.change_modifier(wood, -20)
town.change_modifier(ore, 50)

print(f"Wood Price: {town.get_value(wood)}")
print(f"Ore Price: {town.get_value(ore)}")

Output:

Wood Price: 4
Ore Price: 15

---

Use Cases

DyEcon can be used for:

• Town economies
• Shops
• Traveling merchants
• Guild inventories
• Trading systems
• Resource management games
• RPG economies
• Simulation games

---

License

MIT License