AktorEkuip XP

[kyonides]

AktorEkuip XP

Version 1.2.0

by Kyonides

Introduction

My scriptlet allows you to add more weapons or armors to a Hero's official lists during gameplay.
This can be enabled from the very beginning as well.

You see, there are 2 Constants defined in the AktorEkuip module below that will let you set a list of Actors that might get Extra Equippable Weapons or Armors from the very beginning.

It does not specify which Weapons or Armors at all. That will be setup dynamically during your game session.

It also features 2 special flags or Script Calls to enable or disable those lists for any given Actor at any time during gameplay.

Side Note

This scriptlet could be considered the RMXP or RMVX port of EkuipFeatures ACE, even if both systems have pretty much nothing in common. That's true for RGSS 1 and 2 because they have no features array to handle it the strange way RGSS 3 does.

Settings

There are 2 Constants in the AktorEkuip module, namely:

• ACTORS_WITH_EXTRA_WEAPONS
  
• ACTORS_WITH_EXTRA_ARMORS
  

Just add Actor ID's to any of them as deemed necessary and that's it!

What happens to all the other actors?
Nothing at all, guys!

Code:

module AktorEkuip
  # some comment here
  ACTORS_WITH_EXTRA_WEAPONS = []
  ACTORS_WITH_EXTRA_ARMORS  = []

List of Script Calls

Original Calls

Code:

# - First find an Actor - 2 Methods:
# actor = $game_party.actors[Index] or $game_party.members[Index]
# actor = $game_actors[ActorID]

# - Enable or Disable an Actor's Ability to Equip more Weapons or Armors
# actor.enable_weapons = true  or  false
# actor.enable_armors = true  or  false

# - Weapons List - Add or Remove or Clear a WeaponID
# actor.increase_weapon_list(WeaponID)
# actor.reduce_weapon_list(WeaponID)
# actor.clear_weapon_list!

# - Armors List  - Add or Remove or Clear a ArmorID
# actor.increase_armor_list(ArmorID)
# actor.reduce_armor_list(ArmorID)
# actor.clear_armor_list!

New Calls

Code:

# - Delist a Hero's Class Weapon or Armor
# actor.delist_weapon(WeaponID)
# actor.delist_armor(WeaponID)

# - Delist All of the Hero's Class Weapon or Armor
# actor.delist_weapons!
# actor.delist_armors!

# - Restore a Hero's Class Weaponset or Armorset or Both of them
# actor.restore_weapon_set!
# actor.restore_armor_set!
# actor.restore_class_sets!

Newer Calls

Code:

# - Create Custom Class Weapons or Armors Exclusions
# actor.add_exclude_weapons(WeaponID1, etc.)
# actor.add_exclude_armors(ArmorsID1, etc.)

# - Clear Custom Class Weapons or Armors Exclusions
# actor.clear_exclude_weapons!
# actor.clear_exclude_armors!

Newest Calls

Code:

# - Bless or Don't Bless an Actor!
# actor.increase_bless(Number)
# actor.decrease_bless(Number)

# - Add Blessed Weapon(s) or Armor(s)
# actor.bless_weapons(WeaponID1, etc.)
# actor.bless_armors(ArmorID, etc.)

# - Remove Blessed Weapon or Armor
# actor.unbless_weapon(WeaponID)
# actor.unbless_armor(ArmorID)

# - Set Bless HP Loss or SP/MP Loss per BlessPoints
# actor.set_bless_rate(:hp, HP, BlessPoints)
# actor.set_bless_rate(:sp, SP, BlessPoints)
# actor.set_bless_rate(:mp, MP, BlessPoints)

DOWNLOAD DEMO

Terms & Conditions

Free for use in any game.
Include my nickname in your game credits.
Don't adopt stay cats.
That's it!

[DerVVulfman]

Interesting concept. Actually permitting an Actor to use a weapon or armor piece that his Database Class (Fighter/Lancer/Mage) doesn't have enabled at game start. And done light-weight without actively going through the RPG::Class class itself, but accessing the weapon_set & armor_set attributes alone.

I see the additional weapons and armors may be removed. But would it that you may later 'remove' and disallow an already existing class-defined weapon or armor from a punished hero?

[kyonides]

Err, wouldn't it be way easier to do that by changing the hero's class to something like Peasant than adding more stuff to my script?
Just the lazy me speaking here.

[kyonides]

Interesting Script Update!

After considering a certain  Wulfo's suggestion, one that seasoned heroes     might deeply hate for sure, it is now possible to make a hero lose their inherent ability to equip a current class weapon or armor all of a sudden.

The hero could also lose the ability to wield ALL of those weapons or armors at a given time.
 It is not a good day to be a hero indeed.  

Heroes, listen to me now!  

Behave decently or face the consequences of your actions in no time!  

Guys, it is also possible to restore them at any given time.

List of New Script Calls

Code:

# - Delist a Hero's Class Weapon or Armor
# actor.delist_weapon(WeaponID)
# actor.delist_armor(WeaponID)

# - Delist All of the Hero's Class Weapon or Armor
# actor.delist_weapons!
# actor.delist_armors!

# - Restore a Hero's Class Weaponset or Armorset or Both of them
# actor.restore_weapon_set!
# actor.restore_armor_set!
# actor.restore_class_sets!

Happy Open Werewolf Hunting Season!

[kyonides]

Just Another Script Update!

From now on, users can call some other script calls to exclude initial weapons or armors from the original lists only.
Don't worry, my friends! This can be easily reverted by simply calling the clear exclusions methods.

Code:

# - Create Custom Class Weapons or Armors Exclusions
# actor.add_exclude_weapons(WeaponID1, etc.)
# actor.add_exclude_armors(ArmorsID1, etc.)

# - Clear Custom Class Weapons or Armors Exclusions
# actor.clear_exclude_weapons!
# actor.clear_exclude_armors!

Those calls won't affect the custom weapons or armors the hero can equip at all.

[kyonides]

Yet Another Script Update!

This time I came back to add a new feature, the Blessed Weapons or Armors!

This means that now you could add extra weapons or armors as long as your hero has got enough Bless Points to wield or wear it. :O

Of course, it's possible to earn or lose Bless Points.

You can even exchange some HP or SP or MP for some Bless Points! :O

List of New Script Calls

Code:

# - Bless or Don't Bless an Actor!
# actor.increase_bless(Number)
# actor.decrease_bless(Number)

# - Add Blessed Weapon(s) or Armor(s)
# actor.bless_weapons(WeaponID1, etc.)
# actor.bless_armors(ArmorID, etc.)

# - Remove Blessed Weapon or Armor
# actor.unbless_weapon(WeaponID)
# actor.unbless_armor(ArmorID)

# - Set Bless HP Loss or SP/MP Loss per BlessPoints
# actor.set_bless_rate(:hp, HP, BlessPoints)
# actor.set_bless_rate(:sp, SP, BlessPoints)
# actor.set_bless_rate(:mp, MP, BlessPoints)

Obviously, the demo has been updated to include more events that will show you how to use the new script calls in real life scenarios.