Cataclysm: Bright Nights Documentation

repository·main·Indexed 22 days ago

https://github.com/cataclysmbn/cataclysm-bn

Documentation for Cataclysm: Bright Nights, a sci-fi post-apocalyptic roguelike fork of Cataclysm: Dark Days Ahead. Includes guides on Lua modding, shared library imports, and detailed documentation for mods such as Aftershock (cyberpunk settings), Arcana (magic systems, essence types, and spellcasting), and the C.R.I.T. Mod.

Tokens
209.1K
Snippets
453
Records
856
Agent score
77%

What's inside Cataclysm: Bright Nights

  1. Overview of version 0.12.0 features

    main

    Stable version 0.12.0 introduced several major gameplay and engine improvements:

    • UI Overhaul: Improved construction blueprints and nested crafting categories.
    • NPC Crafting: A new interface allowing companions to craft using provided supplies.
    • Map Engine Overhaul: Added dynamic reality bubbles, chunk loading, and multi-dimension support, alongside performance optimizations for map loading and generation.
    • Expanded Vehicle Types: Added various aircraft (cargo/passenger planes, jets like F-35 and F-15E, wooden planes), hover vehicles, and heavy tanks (including tankers, hover tanks, and tankbots).
    • Vehicle Customization: Added painting and vehicle color features.
  2. Overview of The C.R.I.T. Mod

    main

    The C.R.I.T. Mod for Cataclysm: Bright Nights expands the game by adding new equipment, materials, and character professions. It focuses on high-end gear and specialized combat roles.

    Key Features:

    • New Equipment: Includes an armor set, a powerful gas mask, a transforming vest, various gun mods, and new melee/tool items.
    • New Materials: Introduces rubber as a new material, alongside the use of superalloy, hardsteel, and neoprene for high-end items.
    • New Professions: Adds specialized military-themed classes such as:
      • C.R.I.T. Medic
      • C.R.I.T. Commanding Officer
      • C.R.I.T. Automatic Rifleman
      • C.R.I.T. Grunt
      • C.R.I.T. NCO
      • C.R.I.T. ROTC member
      • C.R.I.T. Spec Ops (highly powerful/OP)
      • Juggernaught

    Known Limitations:

    • Toolmods may incorrectly attach to the transforming vest and gas mask. While this functions as a way to progress, these items still consume significant power.
  3. Overview of the Magical Nights mod

    main
    Magical Nights is a mod for Cataclysm: Bright Nights that builds upon the legacy Magiclysm content. It features significant rebalancing of Demon Spiders and nearly all spells, along with new content including a unique take on Goblins, new clothing (such as owlbear fur), and dragonbone weapons. The mod shifts the game's lore to a setting where magic has historically been hidden due to persecution, making magical sites like Mage towers and Magic Academies more common in the countryside than in urban centers.
  4. Overview of the Aftershock Mod

    main
    Aftershock is a mod for Cataclysm: Bright Nights that introduces parallel dimensions characterized by a cyberpunk and post-cyberpunk setting. Unlike the standard 'Cataclysm Prime' setting, Aftershock features worlds with advanced dimensional travel, solar colonization, and uplifted intelligent animals. The setting includes mega/hive cities with stratified social layers and nature preserves containing decaying towns. Key thematic elements include high-tech dystopias and corporate/military-driven technological advancement.
  5. Overview of DinoMod for Cataclysm: Bright Nights

    main

    DinoMod is a content addition mod for Cataclysm: Bright Nights (BN) that introduces dinosaurs into the game. Dinosaurs can be fought, befriended, or ridden. The mod is designed to be compatible with most vanilla-BN based mods, though it may not work with total conversion mods.

    Key features include:

    • Dinosaur Faction: Operates and interacts similarly to vanilla factions like the blob or the fungus.
    • Diverse Spawning: Dinosaurs spawn in various locations based on natural habitats and story progression.
    • New Locations: Introduces a new location outside of cities and adds variants to existing areas.
    • Dynamic Ecosystem: Dinosaurs lay eggs, and spawn patterns change seasonally and as the game progresses.
    • Taming and Riding: Some dinosaurs can be tamed and ridden.
    • High-Difficulty Encounters: Players can find more difficult encounters (often with better loot) in labs, along streams, and in swamps.
  6. Overview of the RPG System mod

    main
    The RPG System is a progression mod for Cataclysm: Bright Nights that implements a LitRPG-style experience system. It allows players to gain XP from combat, level up to a maximum of level 40, choose base and prestige classes, unlock traits, and assign free stat points. The mod is designed to be compatible with existing save files.
  7. Crafting and Construction updates in Stable 0.12.0

    main

    Stable 0.12.0 introduced new recipes and construction capabilities:

    New Recipes & Items:

    • Autolearn Recipes: Makeshift air filters, automotive filters, and drive belts now autolearn.
    • Construction: Added bathtub construction recipes.
    • Bionics: Added a bionics nanofab template and flight bionics to nanofab recipes.
    • Armor/Clothing: Added recipes for ghillie suits, sparkledog suits, and various helmet types (bucket helmet, steel combat helmet).
    • Industrial: Industrial freezers are now craftable and deconstructible.
  8. Understand the status of in-repo mods

    main

    Note: The current guideline for Cataclysm: Bright Nights (BN) favors removing in-repo mods. This documentation is maintained for historical purposes.

    Historically, BN shipped with several mods directly in the repository to provide visibility, use the official issue tracker for bug reporting, and ensure that mod-specific game features remained supported in the core engine. However, these mods are considered community content and do not come with guarantees of maintenance or sole authorship.

  9. Vehicle and aircraft features in Stable 0.12.0

    main

    Stable 0.12.0 expanded vehicle capabilities, including new types, construction options, and mechanics:

    New Vehicles:

    • Biplanes
    • Camper vans
    • Hazmat response vehicles
    • Seaplanes
    • JLTW (modern humvee-style military vehicle)
    • Coast guard cutter
    • Attack helicopters (with updated loadouts)
    • Harriers (VTOL aircraft)

    Vehicle Mechanics & Construction:

    • NBC Sealing: Vehicles can now have NBC (Nuclear, Biological, Chemical) sealing.
    • Autodrive: Added a per-vehicle autodrive speed option.
    • Fluid Converters: New vehicle fluid converters added.
    • Recoil: Vehicle gun recoil is now applied.
    • Construction: Sliding doors can now accept shutters; experimental vehicles are always locked by default.
  10. New professions and skill adjustments in Stable 0.12.0

    main

    Stable 0.12.0 introduced several new professions and adjusted existing ones to balance gameplay.

    New Professions:

    • Blackbelt
    • Mall Ninja
    • Mortician
    • Elite Operator
    • Fighter Pilot
    • Bionic Operator
    • IRS Agent

    Key Skill/Trait Changes:

    • Competitive Fencer: Now includes the Piercing Weapons skill.
    • Military Professions: Generally received increased ranged weapon skills.
    • Survivalist Jr.: Cost reduced to 1 point.
    • Starting Age: Professions now support a starting age setting.