Skins: |

NWN2 SCRIPTS

- Jump to comments -

Name

KEMO Experience Award System

Author

KEMO

Submitted / Updated

08-15-2009 / 02-04-2010

Category

Creature Related

Type

Type - Rewards

Format

Code Only

ShowCode

//EXPLANATORY COMMENTS
/*
	The basic formula for KEMO-EAS is as follows:
	
	Multiplier = Base modifier + Party size modifier + Area modifer - Relative level modifier
	XP Awarded = Base XP Award * Multiplier
	
	The area modifier may be left unused (no variable set for the area). Its main purpose is to give a boost
	in low-level areas where the HD or CR of creatures is too low to be worthwhile.
	
	The party size modifier may be switched off (KEMO_PARTY_AWARD_SWITCH)
	The relative level modifier may be based on one of the following options:
		1) Difference between individual PC level and creature Challenge Rating (KEMO_DEFAULT_CREATURELEVEL_TYPE = 1)
		2) Difference between individual PC level and creature Hit Dice (KEMO_DEFAULT_CREATURELEVEL_TYPE = 0)
		3) Difference between individual PC level and killer's level (KEMO_USE_KILLER_SWITCH = 1)
		4) Difference between individual PC level and killer's party's average level (KEMO_USE_KILLER_SWITCH = 2)
		5) Difference between individual PC level and killer's party's highest level (KEMO_USE_KILLER_SWITCH = 3)
		6) Difference between individual PC level and killer's party's lowest level (KEMO_USE_KILLER_SWITCH = 4)
	PC level may ignore ECL (KEMO_PCLEVEL_TYPE_SWITCH = 0) or use ECL (KEMO_PCLEVEL_TYPE_SWITCH = 1)
	
	The base xp award may be set to one of 4 options:
		1) static value (KEMO_AWARD_BASE)
		2) static value plus/minus small random fluctuation (KEMO_AWARD_NOISE)
		3) killed creature level x a chosen amount (KEMO_AWARD_VARBASE)
		4) #3 with fluctuation
		
	The determination of who in a party may be given xp can be based on the distance from the PC to the creature
	or from the PC to the killer (KEMO_USE_CREATURE_SWITCH = 1). The maximum distance may be set as well
	(KEMO_MAX_AWARD_RANGE), or completely ignored (KEMO_MAX_AWARD_RANGE = 0.0f).
	This maximum distance is used when determining the following:
		1) whether the PC gets xp or not
		2) size of the party (only members in range are counted)
		3) average party level (only members in range are counted) -- only needed if KEMO_USE_KILLER_SWITCH = 2
		4) highest/lowest level party member (members in range counted) -- only needed if KEMO_USE_KILLER_SWITCH = 3 or 4
		
	Minimum and maximum awards (after multiplier) can be set with KEMO_AWARD_MULTIPLIER_MIN and KEMO_AWARD_MULTIPLIER_MAX.
	
	Finally, it is possible to use a system of xp tokens, which modify the xp award after the multiplier is applied.
These tokens (of which there may be any number of variations) are set to a multiplier and an xp range. If the PC is within the
xp range, the multiplier is applied.
	There are a few good uses for these tokens. Among these are:
		1) Force level limits apart from the server's primary limit --- for example, if you want to require that players
			complete a certain quest before they are permitted to reach a certain level, you would set the token multiplier
			to any negative float (e.g., -1.0f) and the xp range minimum to the xp value of one point below that level.
		2) Slow down or accelerate xp gain. (Use a value above 1.0f to accelerate, below 1.0f to slow down.)
		3) Prevent xp awards for PCs fighting in "death" areas (e.g., while the PC is dead and striving to return to life).
	
	As of 8/23/09 there are 4 different types of tokens:
	1) To create a level-based xp token, set the tag of any item to the string referred to by KEMO_XPTOKEN_TAG_LVL (see below). Then
		assign three variables: float XPMultiplier, int XPMinAllowed and int XPMaxRequired. The token will only operate if the PC's
		current xp is between XPMinAllowed and XPMaxRequired. Any negative multiplier results in an award of zero (when within range).
	2) To create a pool-based xp token (where each "use" drains the pool until there is nothing left), set the tag to the string
		referred to by KEMO_XPTOKEN_TAG_POOL. Then assign two variables: float XPMultiplier and int XPPool. If the XPMultiplier is set
		to anything below 1.0, the token will never discharge, since the pool is only drained by the amount of xp the PC gains above
		the un-multiplied award -- which would be zero if the multiplier is under 1.0.
	3) To create a count-based xp token (each "use" reduces the count by 1, until it reaches zero), set the tag to the string
		referred to by KEMO_XPTOKEN_TAG_COUNT. Then assign two variables: float XPMultiplier and int XPCount. The multiplier may be
		set to any number >= 0.0. The counter will go down regardless of the xp award given.
	4) To create a random xp token (similar to #3 but with a decreasing chance of effect), set the tag to the string referred to
		by KEMO_XPTOKEN_TAG_RND. Then assign four variables: float XPMultiplier, int XPDie, int XPCount and float XPMultiplierAdd.
		The token "rolls" Random(XPDie) + 1 and compares it to the current XPCount. If the roll is <= XPCount, the XPMultiplier is
		permanently increased by XPMultiplierAdd and then applied to the xp award. Once the counter reaches zero the token stops.
		The likelihood of the token being triggered goes down each time, but the award goes up whenever it is triggered. It is suggested
		that the XPMultiplierAdd float be 1% of the XPDie, so an XPDie = 10 gives XPMultiplierAdd = 0.1. This way the multiplier will
		never increase beyond 1.0 over the initial setting.
*/

Select All Text | View Code in separate window

Patch

1.23

NWN2Game

All

Description

The KEMO Experience Award System is meant to be a replacement for the standard xp awards that you gain from killing creatures. The standard system, which is based on Hit Dice, is fairly inflexible, and may not reflect the kinds of rewards you want to give your players.

To implement, do the following:
1) Add this script to your module.
2) Go into Module Properties and set XP Scale to 0.
3) Open the nw_c2_default7 script. Add near the top (before the main function):

#include "kemo_xpsystem"

And add near the bottom (before the if GetSpawnInCondition line):

if (GetLastKiller() != OBJECT_SELF) KEMOGiveKillAward(oKiller,OBJECT_SELF);

5) Go into the kemo_xpsystem script and set the parameters you want.
6) Compile nw_c2_default7.

The main "switch" you can flip goes between using a standard base award (default is 100) and using the creature's level to determine the base award.

The CODE section contains the main commented portion of the script, for ease of reading. It explains how to set up the parameters to have the xp system do what you want.

update Aug 18 2009:
*fixed problem with thresholds when creature level < KEMO_LEVEL_TIER_DIVISOR
*fixed some glitches in the relative level calculation

update Oct 11 2009:
* uploaded as a file
* some new settings (see the readme section within the script)
* the current settings within the file match those used in the Haven PW, so you can see what a "live" implementation looks like

update Oct 20 2009 (version 1.3):
* level blocker now fully functional: if KEMO_LEVELUP_XPBLOCK is set to 1, PCs must level up when possible in order to continue getting xp. Previously this function did not work with polymorphed or wildshaped PCs.

update Feb 4 2010:
* fixed error in setup instructions above

Files

Name	Type	Size	Downloads
kemo_xpsystem.zipkemo_xpsystem.zip Submitted: 08-15-2009 / Last Updated: 10-20-2009	zip	8.07Kb	336
(October 20, 2009)

SCORE OUT OF 10

10
6 votes
View Stats
Cast Your Vote!
Voting FAQ

PORTFOLIO

Add this entry to your portfolio so you can track it

Manage your existing portfolios or create a new one.

SCREENS

No Images

You Must Be Logged In to Participate.

Comments (11):

Posted by Deleverator at 2011-01-02 22:56:11 Voted 10.00 on 01/02/11

i-use-it-and-love-it

Posted by Kanbyen at 2010-11-24 14:09:00 Voted 10.00 on 11/24/10

I'm using this, works great. I had some issues with the number of includes in my script, I switched the order around a few times and restarted the toolset and it fixed it.

Great work. Thanks
_________________________
Eye of the World PW

Posted by SneakyBastid at 2010-05-09 22:50:19

Still Looking for that pdf "manual"??

Posted by kemo at 2010-02-04 17:28:43

Posted by Quadhund at 2010-02-01 16:23:57

Quick question: when I followed the directions to add this line ( if (GetLastKiller() != OBJECT_SELF) KEMOGiveKillAward(oKiller,oCreature); ) it returned with an error. I looked at it closer and oCreature was not defined, so I switched it to OBJECT_SELF. Will this have any ramifications for the script? (PS I edited nw_c2_default7 from the Storm of Zehir X2 version).

Posted by opiekun at 2009-10-18 11:37:56 Voted 9.00 on 10/18/09

Looks nice. If it was there the RP award (auto XP)system built in, should be really nice, coplitely finished thing for PW of any sort :)

Sinceraly!

Opiekun

Posted by KHart115 at 2009-09-25 23:04:04 Voted 10.00 on 09/25/09

I've tested this script extensively since its launch on the Haven persistent world.

Very ingenious, and very effective. 10 stars, and I would recommend it to anyone looking to add a heap of flexibility to their own modules experience system.
_________________________
nwnhaven.com

Posted by kemo at 2009-09-25 19:52:48

Posted by iotech at 2009-09-06 19:49:35 Voted 10.00 on 09/06/09

Very cool, just what I was looking for! Please continue to update this!

Posted by kemo at 2009-08-24 09:26:28

Sometime in the next few days I'm going to be putting together a cleaner package for this, with a PDF "manual" (with much clearer instructions) and an ERF with scripts, token items and an item-based conversation for DMs to create new tokens on the fly.
_________________________
KEMO Auctions | KEMO Beds and Tables | KEMO Bio | KEMO Custom Animations | KEMO Custom Chairs | KEMO Experience Award System | KEMO Jukebox | KEMO PC Scry | KEMO Storage System
Kingdom of Haven admin

Posted by nicethugbert at 2009-08-17 14:41:37 Voted 10.00 on 08/17/09

NEAT!
_________________________
NTB's Hills and Valleys Vol. 00

You must be Logged In to post comments in this section.

NWN2 Voting Standards

10 - A Masterpiece, Genuinely Groundbreaking
9 - Outstanding, a Must Have
8 - Excellent, Recommended to Anyone
7 - Very Good, Deserves a Look
6 - Good, Qualified Recommendation
5 - Fair, Solid yet Unremarkable
4 - Some Merit, Requires Improvements
3 - Poor Execution, Potential Unrealized
2 - Very Little Appeal
1 - Not Recommended to Anyone