Loot File Structure

Seealso

Learn how to use this file in 2. Adding new loot

Server/AnglersAlmanac/FishLootTable/Zone3/fish/Legendary_Frostgill.json

{  
  "ItemId": "Fish_Frostgill_Item",  
  "Category": [  
    "fish",  
    "freshwater",  
    "arctic"  
  ],  
  "Name": "Frostgill",  
  "Description": "A serrated terror of the arctic ice, this fish has scales like frosted glass and teeth which can bite through a frozen line. It doesn’t just live in the cold; it thrives in it, swimming in the slush like a ghost made of winter. Catching this fish is the true test of a fisherman’s mettle, as this fish has a temperament as sharp as its fins.",  
  "FamilyId": "Channichthyidae",  
  "Rarity": "Legendary",  
  "IsGlobal": false,  
  "Weight": 20,  
  "Size": 85,  
  "Habitats": {  
    "Zones": ["3"],  
    "Tiers": [],  
    "Regions": [],  
    "Biomes": [],  
    "Min_depth": 3,  
    "Height": {  
      "Min_y": 0,  
      "Max_y": -1  
    }  
  },  
  "Minigame_stats": {  
    "Difficulty": 14,  
    "Behavior": "aggressive",  
    "Stamina": 180  
  },  
  "Book_info": {  
    "Habitat_Info": "• Whisperfrost Frontiers"  
  }  
}

1. Identity & Data

• ItemId: Internal string ID for the item.
• FamilyId: Groups fish for specific mechanics or Almanac sorting.
• Weight: The base probability value (rolled against the total pool).
• IsGlobal: If true, the fish ignores Zone/Region/Biome requirements (but still respects environment checks like depth and height).

2. Habitat Requirements

The fish is eligible for the loot pool if it matches any of these (if defined):

• Zones: String array of IDs (e.g., ["1", "2", "3", "4", "Ocean"]).
• Tiers: Integer array. If a Zone matches, it must also match the Tier (if tiers are specified).
• Regions / Biomes: Specific world locations.
• Height:
  • Min_y: Lowest altitude.
  • Max_y: Highest altitude (-1 to disable the ceiling).

3. Environmental Checks

These must always return true, or the fish is removed from the pool:

• Time_of_day: ["dawn", "day", "dusk", "night"] or ["Any"].
• Required_weather: ["Any"]. (Not working atm)
• Moon_phase: Exact integer match. Use -1 to ignore.
• Min_depth: The water must be at least this many blocks deep.

4. The Exclusion & Multiplier System

This logic determines if a fish is “Rare” in a specific area or completely blocked. This bypasses IsGlobal

• Exclude_zones / Exclude_tiers / Exclude_biomes / Exclude_regions: If the player is in one of these areas, the Weight_multiplier is applied to the fish’s base Weight.
• Weight_multiplier: (Float)
  • 0.0: The fish is completely removed from the pool in excluded areas.
  • 0.5: The fish is twice as rare in excluded areas.
  • 2.0: The fish is twice as common in excluded areas.

5. Minigame Stats (WIP)

• Difficulty: Universal speed/timing multiplier.
• Behavior: AI movement pattern (e.g., normal, heavy, aggressive, darting).
• Stamina: The “health” of the fish; higher numbers mean a longer struggle.