Category:Pluggy

Pluggy (latest version is Beta v30) is a plugin for OBSE that provides functions to create, store, and manipulate single-dimension arrays.

Download and Discussion Thread

Pluggy in the Bethesda Forums (Oblivion Mods)

What is an array?

You can think of a single-dimension array as an expandable piece of lined paper. Each line contains a bit of information. In Oblivion's case, the line can either be empty, a reference, an integer (long), or a float. Each line is called an index, and they start with 0.

An example array:

Where are the arrays stored?

• The arrays are stored in separate .pluggy files.
• A .pluggy file is created whenever the game is saved and there are arrays in use.
• Each .pluggy file corresponds to it's save game file.
• If all arrays are destroyed, or all mods that use the arrays are deactivated, the .pluggy file will be deleted.
• The files are incredibly small - only 9 bytes per non-empty array index.

How much space and memory do the arrays take?

• Memory (in-game) - 4 bytes per empty array index and 9 bytes per filled array index
• HDD space - 9 bytes per filled array index

How fast are the functions?

• Not fully tested, but running 900 Pluggy "Find" calls only took half a second while 900 GetInventoryObject calls took 10 seconds. In short, these are incredibly fast functions.

Some peculiarities (compared to other Oblivion functions)

• Most Pluggy functions can be used to both return and set a value. This is determined by an optional flag - if it's left empty the value will be returned and if it's filled the value will be set to that flag.
  • For example, ArraySize 0 will return the size of Array 0 while ArraySize 0 10 will set Array 0's size to 10 indexes.