Rpg Maker Developers Group

Introduction
 ͞ ͞ ͞ ͞ ͞ ͞ ͞ ͞ ͞ ͞ ͞ ͞
 Adds a weight system to your inventory with the following features:
 → Weight capped.
 → Overweight ability with speed reduction.
 → Weight upgrade by script call.
 → Add Weight Bonus, adding weight to the base weight based on equipped equipment.
 → Ignore Weight, to ignore all weight calculations.
 → Ability to discard and use items.
 → Weight information display.

 All notetags are converted to lowercase for safety.

 Display Discard Window → Enables Discard without Weight.


 Features in Depth
 ͞ ͞ ͞ ͞ ͞ ͞ ͞ ͞ ͞ ͞ ͞ ͞ ͞ ͞ ͞ ͞ ͞
 Weight Capped:
    By default, weight is capped but can be toggled via script call:
    $gameSystem.setOverweight(true)  => enable overweight mode
    $gameSystem.setOverweight(false) => disable overweight mode

    When disabled (capped mode), new items are only added if enough
    capacity remains. If not enough space is available, only a partial
    amount is added (based on available weight), and the rest is skipped.

    Items are processed in the order they are gained, so if capacity runs out,
    later items in the same event may not be received. A warning message
    is shown in the console when this happens.


 Overweight:
    When overweight is enabled, player movement speed is dynamically reduced.
    If overweight reaches 0.5 (50%) above the base, Dash is disabled.
    If overweight reaches 1.5 (150%), the player cannot move.

    Overweight mode also automatically enables the discard window,
    which can be used directly and updates when using or discarding items.


 Weight Upgrade:
    You can upgrade the base weight via script call:
    $gameSystem.modInvWeight(5)   => add 5 to the base weight
    $gameSystem.modInvWeight(-5)  => subtract 5 from the base weight
   
    Note: the modified value can go below 0 relative to the base.


 Weight:
    Adding weight to items supports decimals (up to 2 places).
    <Weight: 0.05>  => adds 0.05 weight.
    If the value has 3 decimals (e.g., 1.322), it truncates to 1.32 (no rounding).

    A default weight can be set for all items in the parameters.


 Weight Bonus:
    Weight bonuses can be given to equipment using the tag:
    <Weight Bonus: value>  => changes inventory weight when equipped

    Example:
    <Weight Bonus: 5>   => adds +5 to base weight
    <Weight Bonus: -5>  => subtracts -5 from base weight
 

 Ignore Weight:
    You can create an item that grants a state to ignore all weight.
    Best used for a limited number of steps, allowing players to move
    or sell items without having to discard them immediately.


 Discard Items:
    You can discard items if the parameter is set to true, or if
    overweight mode is active. In either case, the discard option
    becomes available in the item menu.

    This window lets you confirm item use or choose how many to discard,
    depending on the selected command.

    The discard amount can be adjusted with the arrow keys:
    Arrow UP    = +1
    Arrow DOWN  = -1
    Arrow LEFT  = -10
    Arrow RIGHT = +10
    Press Enter or Z to confirm, X or ESC to cancel.

    Items with the tag <No Discard> cannot be discarded.

    Discard can also be used without the weight system if
    “Display Discard Window” is enabled.


 Weight Details:
    Weight details can be shown by holding the SHIFT key.
    This displays the following information:

    Base:  set in parameters
    Mod:   changed via script calls
    Bonus: added or removed from equipped gear
    Total: total carrying capacity
    Used:  current total weight used

    Useful for debugging or balancing purposes.