Name: VipCxj's Plungin Collection
Author: VipCxj


Requirement:
OBSE 0020b5 or above


Version 3.0
Noted: To use this version, you need to recompilie your script using the function of this plugin of earlier version.
1. Fix the bug of function "vcGetFilePath" on Win7 x64 and Nerhiom.
2. improve the function "vcAddMark".
3. Add the following function to the plugin.

function list:

1. vcGetValueNumeric
get the value of a numeric in the special ini
(nothing) vcGetValueNumeric filePath:formatString
The filePath include the value name and block name. The value name and the block name is contained within the format string, following path name and separated by a pipe character.
i.e.
GamePath\example.ini
[block1]
test1 = 1
test2 = 2
test3 = 3.3
[block2]
test1 = 4.1
test2 = 5
[block3]
test1 = 6
test2 = 7
test3 = 8
vcGetValueNumeric "example.ini|test1|block1" return 1
vcGetValueNumeric "example.ini|test1|block2" return 4.1
vcGetValueNumeric "example.ini|test3" return 3.3
vcGetValueNumeric "example.ini|test1" return 1


2. vcGetValueString
get the value of a string in the special ini
(nothing) vcGetValueString filePath:formatString
i.e.
GamePath\example.ini
[block1]
test1 = 1
test2 = 2
test3 = "string1"
[block2]
test1 = 4.1
test2 = "string2"
vcGetValueString "example.ini|test3|block1" return "string1"
vcGetValueString "example.ini|test2|block2" return "string2"
vcGetValueString "example.ini|test1|block1" return "1"


Version 2.0

1. Fix the CTD bug of function "vcGetFilePath" on WinXP. Noted that before use "vcGetFilePath", using "FileExists" to test the flie path.


Version 1.0

function list:

1. vcSetActorState
Set the state of the actor.
/************************************************************************/
/*                         Actor state type                             */
/************************************************************************/
/*
	OnGround = 0,
	Jumping = 1,
	InAir = 2,
	Climbing = 3,
	Flying = 4,
	Swimming = 5,
	Projectile = 6,
	UserState1,
	UserState2,	// 8
	UserState3,
	UserState4,
	UserState5,
*/
(nothing) reference.vcSetActorState state:int
This function is the core function of my mod "VipCxj's Air Fight System".


2. vcGetFilePath
get the path of special file. The condition string value is contained within the format string, following path name and separated by a pipe character, i.e. vcGetFilePath ("Data\Textures\Characters\vipcxj\hair|@_n|@_h" 4) find the file path of the .dds file under "Data\Textures\Characters\vipcxj\hair" and not include the "_n" and "_h" in the filename. "@"represent "not include".
/************************************************************************/
/*                            file type                                 */
/************************************************************************/
/*
	nif = 1,		//1
	kf  = 2,		//2
	dds = 4,		//4
	egm = 8,		//8
	egt = 16,		//16
	wav = 32,		//32
	mp3 = 64,		//64
*/
(path:array) vcGetFilePath path:formatString filetype:int
This function is the core function of my mod "VipCxj's Hair Eye Extend System".


3. vcPrintINI
print something into the file "Your game install path\VipCxj_Debug.ini". If the file doesn't exist, this function will create a new file.
This function is very useful for modder. The console can not contain much more message. So this function is very useful.
(nothing) vcPrintINI message::formatString


4. vcSetHairColor
set the color of actor's hair. you need use "update3D" to show the result.
/************************************************************************/
/*                            Which Color                               */
/************************************************************************/
/*
	0	red
	1	green
	2	blue
*/
(nothing) reference.vcSetHairColor value:int whichcolor:ini NPC:ref


5. vcSetHairColorRGB
set the color of actor's hair. you need use "update3D" to show the result. This function use the RGB value instead of a special color.
i.e player.vcSetHairColorRGB 0xffffff
(nothing) reference.vcSetHairColorRGB RGBvalue:int NPC:ref


6. vcSetHairColorRGB3P
set the color of actor's hair. you need use "update3D" to show the result.
i.e. "player.vcSetHairColorRGB3P 255 255 255" set the player's hair color to write. if the value doesn't range from 0 - 255, then this value will be ignored.
(nothing) reference.vcSetHairColorRGB3P Red:int Green:int Blue:int NPC:ref


7. vcGetHairColorRGB
get the color of actor's hair. i.e. if player's hair color is write, this function will return 0xFFFFFF
(RGB:int) reference.vcGetHairColorRGB NPC:ref


8. vcAddMark
add a mark, and then use function "vcIsMarked" to detect this mark. This is a very useful function. You can add mark in a esp, and then detect mark in another esp.
(nothing) reference.vcAddMark MarkName:formatString


9. vcIsMarked
Detect the mark added by special reference. This function will return true just once after the mark is added to some reference. It will return false until the mark is added again.
(result:bool) reference.vcIsMarked MarkName:formatString


Credit:
1. Bethesda
2. OBSE group