Caves of Qud

Caves of Qud

Not enough ratings
Hot 'n Spicy History!
   
Award
Favorite
Favorited
Unfavorite
Branch: Stable
Environment: Faction, Lore, World
Type: Library
File Size
Posted
Updated
321.841 KB
30 Dec, 2024 @ 9:25pm
11 Apr @ 8:08pm
7 Change Notes ( view )

Subscribe to download
Hot 'n Spicy History!

Description
As of Qud version 1.1.0, this mod's functionality is natively supported by Qud, so it is no longer necessary to install.

In these recent versions, if this mod is installed, it disables its merging feature. The only functionality this mod then provides is the Option to dump the merged history spice to Player.log during world generation, which may be helpful for mod development to verify that HistorySpice.json is merged as expected.



This mod adds no content on its own.

This is a library for modders to add history for their custom food/items/factions/content into Qud, by simply adding to their mod a HistorySpice.json file that uses the same format as Qud's HistorySpice.json.

Features
  • Merges your mod's HistorySpice.json into the base game's.
  • To verify the merge is correct, you can see the final result by enabling verbose logs in Options -> Debug -> Hot 'n Spicy History Verbose Logs

Usage
  1. In steam, on your workshop item's page, under the Owner Controls panel on the right, click Add/Remove Required Items. Add this mod to your mod's list so that steam will also download this mod when users download yours.
  2. Create a HistorySpice.json file in your mod. Fill it in using the same json structure as the base game's file.
    • This mod will merge your json into Qud's HistorySpice.json automatically.
    • A simple example is provided below.
    • Consult Qud's Steam/steamapps/common/Caves of Qud/CoQ_Data/StreamingAssets/Base/HistorySpice.json for additional info.
  3. You can verify your file was merged by enabling the Verbose Logs option described above in the Features section, restarting Qud, creating a new game, and looking at the Player log[wiki.cavesofqud.com] file. Any errors will be logged into Player.log as well.

HistorySpice.json Example
{ "spice": { "extradimensional": { "Disintegration": [ "*cult*, Aspect of the <^.void.!random>" ] }, "cooking": { "recipeNames": { "ingredients": { "Starapple Preserves": { "adj": [ "<^.adj1.!random>", "<^.adj2.!random>" ], "adj1": [ "apple", "apple juice", "starapple", "balsamic", "fruit", "tart" ], "adj2": [ "crisp", "balsamic", "fresh", "fruit", "tart", "sweet" ], "nounPlural": [ "apples", "starapples", "jam", "apple jam", "starapple jam" ], "noun": [ "apple", "starapple" ] }, "Pickled Mushrooms": { "adj": [ "<^.adj1.!random>", "<^.adj2.!random>" ], "adj1": [ "mushroom", "briny mushroom", "fungus" ], "adj2": [ "pickled", "briny", "salty", "<^.noun.!random>-<spice.cooking.recipeNames.suffix.!random>" ], "nounPlural": [ "pickled mushrooms", "mushrooms", "pickled mushroom water", "fungus" ], "noun": [ "brineshroom", "mushroom", "fungus" ] }, "lava": { "adj": [ "<^.adj1.!random>", "<^.adj2.!random>" ], "adj1": [ "lava", "fire-roasted", "flaming", "seared", "roasted", "hot" ], "adj2": [ "fire-roasted", "flaming", "seared", "roasted", "magmatic", "molten", "hot", "<^.noun.!random>-<spice.cooking.recipeNames.suffix.!random>" ], "nounPlural": [ "lava", "magma", "smoke" ], "noun": [ "lava", "magma", "smoke" ] } } } } } }