AktorEkuipReset

[kyonides]

AktorEkuipReset

XP + VX + ACE

by Kyonides

Introduction

You have always counted on the default event command to remove a hero's equipment. Normally, any piece would go straight to your corresponding party's bag.

 What if you could have a couple of extra options?

Now you can discard equipment by its index or store it in a game variable before discarding it.

Actually, you can also reset an actor's level and equipment with a single script call, guys! 

And yes, it is quite customizable, IMHO.

Instructions

Code:

# * AktorEkuipReset - Instructions * #

# NOTE:
# The EQUIP_VAR_MODE Constant defines the type of data stored in a given
# Game Variable, i.e. the ID, Name or Equipment itself.

# * Script Calls * #

# - First Step: Find an Actor!
#   actor = $game_actors[ActorID]
#   actor = $game_party.members[ActorIndex]
#   actor = $game_party.actors[ActorIndex] # For RMXP Only!

For RMXP

Code:

# - Reset the Actor's Stats & Other Features
#  actor.reset(NewLevel)
#  actor.reset(NewLevel, :option1 => "feature1", etc.)

# Examples:
#  actor.reset(1)
#  actor.reset(1, :name => "New Name")
#  actor.reset(1, :nickname => "New Nickname")
#  actor.reset(1, :class_id => 3)
#  actor.reset(1, :init_equips => true)
#  actor.reset(1, :equips => [1,41,6,0,0])
#  actor.reset(1, :equips => [1,41,6,0,0], send2bag => true)

# - Discard Equipment By Index (SlotID)
#  actor.discard_equip_pos(SlotID)

# - Discard Many of Them By Indexes (SlotIDs)
#  actor.discard_equip_slots(SlotID1, etc.)

# - Discard Equipment By Index (SlotID) and Store it in a Game Variable
#  actor.store_discard_equip_pos(VarID, SlotID)

# - Discard Many of Them By Indexes (SlotIDs)
#  -> It will store them in consecutive Game Variables!
#  actor.store_discard_equip_slots(VarID, SlotID1, etc.)

For RMVX

Code:

# - Reset the Actor's Stats & Other Features
#   actor.reset(NewLevel)
#   actor.reset(NewLevel, :option1 => "feature1", etc.)

# Examples:
#   actor.reset(1)
#   actor.reset(1, :name => "New Name")
#   actor.reset(1, :nickname => "New Nickname")
#   actor.reset(1, :class_id => 3)
#   actor.reset(1, :init_equips => true)
#   actor.reset(1, :equips => [1,41,6,0,0])
#   actor.reset(1, :equips => [1,41,6,0,0], :send2bag => true)

# - Discard Equipment By Index (SlotID)
#   actor.discard_equip_by_index(SlotID)

# - Discard Many of Them By Indexes (SlotIDs)
#   actor.discard_equip_by_indexes(SlotID1, etc.)

# - Discard Equipment By Index (SlotID) and Store it in a Game Variable
#   actor.store_discarded_equip_by_index(VarID, SlotID)

# - Discard Many of Them By Indexes (SlotIDs)
#   -> It will store them in consecutive Game Variables!
#   actor.store_discarded_equip_by_indexes(VarID, SlotID1, etc.)

For RMVX ACE

Code:

# - Reset the Actor's Stats & Other Features
#   actor.reset(NewLevel)
#   actor.reset(NewLevel, option1: "feature1", etc.)

# Examples:
#   actor.reset(1)
#   actor.reset(1, name: "New Name")
#   actor.reset(1, nickname: "New Nickname")
#   actor.reset(1, class_id: 3)
#   actor.reset(1, init_equips: true)
#   actor.reset(1, equips: [1,41,6,0,0])
#   actor.reset(1, equips: [1,41,6,0,0], send2bag: true)

# - Discard Equipment By Index (SlotID)
#   actor.discard_equip_by_index(SlotID)

# - Discard Many of Them By Indexes (SlotIDs)
#   actor.discard_equip_by_indexes(SlotID1, etc.)

# - Discard Equipment By Index (SlotID) and Store it in a Game Variable
#   actor.store_discarded_equip_by_index(VarID, SlotID)

# - Discard Many of Them By Indexes (SlotIDs)
#   -> It will store them in consecutive Game Variables!
#   actor.store_discarded_equip_by_indexes(VarID, SlotID1, etc.)

DOWNLOAD DEMOS

Terms & Conditions

Free for use in any game.
Include my nickname in your game credits!
Yeah, even overcaffeinated elves and squirrels can get a copy of this demo! 
That's it!