Skip to content

CHANGELOG.md

Latest commit

 

History

History
199 lines (173 loc) · 6.38 KB

CHANGELOG.md

File metadata and controls

199 lines (173 loc) · 6.38 KB
Raw

RL2.API Changelog

v2.1.0

Additions

All content addition related APIs now expose a DeleteData hook (listed below), which is triggered on save file deletion

  • Modded Burdens!
    • Burdens.Register
    • Burdens.GetType
    • Burdens.SaveData
    • Burdens.DeleteData
    • Burdens.LoadData
    • Burdens.LoadContent
    • Burdens.ModifyData
    • Burdens.ExtendTypeArray
  • Modded Soul Shop upgrades!
    • SoulShop.Register
    • SoulShop.GetType
    • SoulShop.SaveData
    • SoulShop.LoadData
    • SoulShop.LoadContent
    • SoulShop.DeleteData
    • SoulShop.ModifyData
    • SoulShop.ModifyEntryArray
    • SoulShop.ModifyObj
    • SoulShop.OnOpen
    • SoulShop.OnClose
  • Player.HeirGeneration.ModifyCharacterData.Event_v2
    • Provides index of the Heir instead of lockedClass and lockedSpell booleans
  • Relics.DeleteData
  • Relics.SetSeen
    • Triggered when setting a Relic's seen status
  • Traits.DeleteData

Changes

  • RL2.API now attempts to load the mod's PDB (Portable DeBugging) file if present
    • This allows modders to use a debugger to set breakpoints in their mods, greatly enhancing their debugging capabilities

v2.0.0

Changes

  • All API endpoints are now accessed via (Container/s).(Name).Event
    • Example Player.Ability.ModifyData -> Player.Ability.ModifyData.Event

Additions

  • Modded Relics!
    • Relics.Register
    • Relics.GetType
    • Relics.SaveData
    • Relics.LoadData
    • Relics.LoadContent
    • Relics.ModifyData
    • Relics.ExtendTypeArray
    • Relics.ApplyEffect
    • Relics.StopEffect
  • Modded Traits!
    • Traits.Register
    • Traits.GetType
    • Traits.SaveData
    • Traits.LoadData
    • Traits.LoadContent
    • Traits.ModifyData
    • Traits.ModifyTraitObj
    • Traits.ExtendTypeArray
    • Traits.ApplyEffect
    • Traits.StopEffect
  • Scars.ModifySummonRules
  • Scars.RegisterCustomRule

Deletions

  • Player.(StatName) endpoints.
    • For stat modification use Player.PostUpdateStats.Event
    • We are aware this disallows modifying Strength and Intelligence, but we are working on readding access to modifying those
    • Health can be modified via Vitality

v1.1.2

Fixes:

  • Enemy.ModifyBehaviour now allows for completly replacing the values of aiScript and logicController_SO

v1.1.1

Fixes:

  • Bad method signature in register content hook

v1.1.0

Changes:

  • RL2.API now requires RL2.ModLoader v1.0.3
    • This is due to the fact that v1.0.3 introduced proper IDs for its Hook objects

Additions:

  • Mod.ModManifest property
    • Holds the ModManifest object related to the mod
  • RL2API.GetModInstance(string modName) method
    • Returns an instance of a mod with modName set as its name in its manifest, or null if not found
  • Mods can now specify which classes implementing IRegistrable belong to which mod
    • This is important in case one assembly contains multiple mods

v1.0.0

Architecture rework:

  • Instead of subclassing ModX and GlobalX classes, modders should now create their own classes implementing the IRegistrable interface.
  • Inside the IRegistrable.Register() method of their classes, they should subscribe to events such as Player.OnKill where their code will be executed

Changes:

  • Player related APIs

    • ModPlayer.OnSpawn override changed to

       Player.OnSpawn += (PlayerController player) => { }

    • ModPlayer.PreKill override changed to

       Player.PreKill += (PlayerController player, GameObject killer) => { 
 	return (bool)IfPlayerShouldDie;
 }

    • ModPlayer.OnKill override changed to

       Player.OnKill += (PlayerController player, GameObject killer) => { }

    • Player stat modification procedurue changed. Instead of changing Player.StatBonuses.{StatName}, modders should use

       Player.Stats.{StatName}Flat += (ref int/float additive) => { }

      for additive bonuses, and

       Player.Stats.{StatName}Multiplier += (ref float multiplier) => { }

      for stat scaling bonuses. Modify the passed in parameters to grant these bonuses

    • ModSystem.ModifyGeneratedCharacterData override changed to

       Player.HeirGeneration.ModifyCharacterData += (CharacterData data, bool classLocked, bool spellLocked) => { }

    • ModSystem.ModifyGeneratedCharacterLook override changed to

       Player.HeirGeneration.ModifyCharacterLook += (PlayerLookController lookData, CharacterData data) => { }

    • ModSystem.ModifyCharacterRandomization override changed to

       Player.HeirGeneration.ModifyCharacterRandomization += (CharacterData data) => { }

    • ModSystem.ModifyAbilityData override changed to

       Player.Ability.ModifyData += (AbilityType type, AbilityData data) => { }

  • Enemy related APIs

    • GlobalEnemy.OnSpawn override changed to

       Enemy.OnSpawn += (EnemyController enemy) => { }

    • GlobalEnemy.PreKill override changed to

       Enemy.PreKill += (EnemyController enemy, GameObject killer) => {
 	return (bool)IfEnemyShouldDie;
 }

    • GlobalEnemy.OnKill override changed to

       Enemy.OnKill += (EnemyController enemy, GameObject killer) => { }

    • ModSystem.ModifyEnemyData override changed to

       Enemy.ModifyData += (EnemyType type, EnemyRank rank, EnemyData data) => { }

    • ModSystem.ModifyenemyBehaviour override changed to

       Enemy.ModifyBehaviour += (EnemyType type, EnemyRank rank, BaseAIScript aiScript, LogicController_SO logicController_SO) => { }

  • Map related APIs

    • ModSystem.ModifyRoomIcon override changed to 
       World.Map.ModifyRoomIcon += (GridPointManager roomToCheck, bool getUsed, bool isMergeRoom) => { }

Deletions

  • ModClassData
    • Awaits new implemenataion, doesn't work at the moment

v0.2.0

Bug fixes:

  • StatBonuses.(Strength|StrengthMultiplier|Intelligence|IntelligenceMultilplier) no longer apply to enemies
  • RL2.API no longer tries to load mods that don't specify being loaded after it

Changes:

  • new-mod command is now called via rl2.api:new-mod

Additions:

  • ModSystem.ModifyAbilityData:
    • Allows modifying AbilityData depending on the provided AbilityType
  • ModSystem.ModifyEnemyData:
    • Allows modifying EnemyData depending on the provided EnemyType and EnemyRank
  • ModSystem.ModifyEnemyBehaviour:
    • Allows modifying the enemy AI script and logic controller depending on the provided EnemyType and EnemyRank (needs detailed documentation)