ModCS.Arms
The ModCS.Arms class represents weapons that can be accessed from the inventory. The game has enough memory for 8 different weapons to be stored in the inventory.
A ModCS.Arms is userdata. You may access and edit the following values from it:
| Value | Type | Usage |
|---|---|---|
id |
Number (Casted to integer) | Type ID of the weapon. |
level |
Number (Casted to integer) | The weapon's level. |
exp |
Number (Casted to integer) | The weapon's exp. Resets to 0 after every level up. |
ammo |
Number (Casted to integer) | The weapon's current ammo count. |
max_ammo |
Number (Casted to integer) | The maximum ammo of the weapon. If this is set to 0 the weapon will not have an ammo requirement. |
ModCS.Arms.Add()
ModCS.Arms.Add(id, ammo)
Adds weapon of type id to the inventory. If a weapon of type id exists, update it.
ammo is an optional parameter. If specified, the added weapon will have maximum ammo ammo count.
ModCS.Arms.Remove()
ModCS.Arms.Remove(id)
Removes weapon of type id from the inventory.
ModCS.Arms.UseAmmo()
ModCS.Arms.UseAmmo(no)
no is an optional parameter, if not specified no will be set to 1.
Use no amount of ammo from the currently selected weapon. Returns false if the amount of ammo can't be used. Returns true otherwise.
ModCS.Arms.AddAmmo()
ModCS.Arms.AddAmmo(no)
Adds no amount of ammo to the currently selected weapon.
ModCS.Arms.SwitchNext()
ModCS.Arms.SwitchNext()
Switches the currently selected weapon to the next one.
ModCS.Arms.SwitchPrev()
ModCS.Arms.SwitchPrev()
Switches the currently selected weapon to the previous one.
ModCS.Arms.SwitchFirst()
ModCS.Arms.SwitchFirst()
Switches the currently selected weapon to the first weapon in the inventory.
ModCS.Arms.AddExp()
ModCS.Arms.AddExp(exp)
Adds exp amount of XP to the player.
ModCS.Arms.RemoveExp()
ModCS.Arms.RemoveExp(exp)
Removes exp amount of XP from the player.
ModCS.Arms.GetLevels()
ModCS.Arms.GetLevels(id)
Returns an array of the XP requirements for each level of weapon of type id. These values are read from the data/arms_level.tbl file.
ModCS.Arms.GetCurrent()
ModCS.Arms.GetCurrent()
Returns a ModCS.Arms of the currently selected weapon.
ModCS.Arms.GetCurrentInvPos()
ModCS.Arms.GetCurrentInvPos()
Returns the inventory position of the currently selected weapon.
ModCS.Arms.GetByID()
ModCS.Arms.GetByID(id)
Searched the inventory for a weapon with type ID id. If found, return a ModCS.Arms of that weapon. Otherwise return a nil value.
ModCS.Arms.GetByInvPos()
ModCS.Arms.GetByInvPos(pos)
Return a ModCS.Arms of the weapon at inventory position pos.
Weapon Shoot Code
The way Cave Story weapons work internally is a certain function runs on loop if the player is currently holding a certain type of weapon. ModCS allows you to override a weapon's shoot code. If a function in the ModCS.Arms.Shoot array is defined with the index X (where X is the Weapon Type ID you want to override) in your Lua script the game will run that function instead of the built-in shoot function.
Example
1 2 3 | |