Package com.planet_ink.coffee_mud.Libraries.interfaces

Interface ItemBalanceLibrary

All Superinterfaces:

java.lang.Cloneable, CMLibrary, CMObject, java.lang.Comparable<CMObject>

All Known Implementing Classes:

TimsLibrary

public interface ItemBalanceLibrary
extends CMLibrary

The setting of combat values on armor and weapons to the end of more balanced combat is managed here. Items can be increased or decreased in power level, altered to fit a level, etc.

Field Summary

Fields inherited from interface com.planet_ink.coffee_mud.core.interfaces.CMObject

idConverter

Method Summary

Modifier and Type	Method	Description
void	balanceItemByLevel(Item I)	Adjusts the mundane stats of the given armor or weapon item to reflect its present level.
int	calculateBaseValue(Item I)	Calculates the base value of this armor or weapon.
Item	enchant(Item I, int pct)	Given a percent change, this method MIGHT add an enchantment or cuse of various levels to the give armor, ammunition, or weapon piece.
java.util.List<Ability>	getTimsAdjResCast(Item I)	Returns a list of all the effects on the given item that contribute to its power level.
boolean	itemFix(Item I, int lvlOr0, boolean preferMagic, java.lang.StringBuffer changes)	Given an item and a new level or 0, this will adjust the stats of the given item to reflect the desired level or its existing one.
int	timsBaseLevel(Item I)	Returns the apparent power level of the item based entirely on basic mundane stats, even if some stats come from a property.
java.util.Map<java.lang.String,java.lang.String>	timsItemAdjustments(Item I, int level, int material, int hands, int wclass, int reach, long worndata)	Returns a map of key value pairs showing what various combat stats on the given item SHOULD be given the level and other particulars.
int	timsLevelCalculator(Item I)	Returns the full power level of the given armor, or weapon.
int	timsLevelCalculator(Item I, java.util.List<Ability> props)	Returns the full power level of the given armor, or weapon.
void	toneDownArmor(Armor A, Ability adjA)	Lowers the base armor of the give armor item based on its level and other characteristics.
boolean	toneDownValue(Item I)	Lowers the base gold value of the given armor or weapon item based on its level and other characteristics.
void	toneDownWeapon(Weapon W, Ability adjA)	Lowers the base attack and damage of the give weapon based on its level and other characteristics.

Methods inherited from interface com.planet_ink.coffee_mud.Libraries.interfaces.CMLibrary

activate, getServiceClient, L, propertiesLoaded, shutdown

Methods inherited from interface com.planet_ink.coffee_mud.core.interfaces.CMObject

copyOf, ID, initializeClass, name, newInstance

Methods inherited from interface java.lang.Comparable

compareTo

Method Detail

timsLevelCalculator

int timsLevelCalculator(Item I)

Returns the full power level of the given armor, or weapon. Will also inspect its affects.

Parameters:

I - the item to get the power level of

Returns:

the power level

timsLevelCalculator

int timsLevelCalculator(Item I,
                        java.util.List<Ability> props)

Returns the full power level of the given armor, or weapon.

Parameters:

I - the item to get the power level of

props - any power affecting effects

Returns:

the power level

toneDownWeapon

void toneDownWeapon(Weapon W,
                    Ability adjA)

Lowers the base attack and damage of the give weapon based on its level and other characteristics.

Parameters:

W - the weapon to adjust

adjA - any property that also impacts attack/dmg

toneDownArmor

void toneDownArmor(Armor A,
                   Ability adjA)

Lowers the base armor of the give armor item based on its level and other characteristics.

Parameters:

A - the armor to adjust

adjA - any property that also impacts armor

toneDownValue

boolean toneDownValue(Item I)

Lowers the base gold value of the given armor or weapon item based on its level and other characteristics. A balancing method.

Parameters:

I - the armor or weapon

Returns:

true if a change was made, false otherwise

timsBaseLevel

int timsBaseLevel(Item I)

Returns the apparent power level of the item based entirely on basic mundane stats, even if some stats come from a property.

Parameters:

I - the weapon or armor to inspect

Returns:

the mundane power level

balanceItemByLevel

void balanceItemByLevel(Item I)

Adjusts the mundane stats of the given armor or weapon item to reflect its present level.

Parameters:

I - the item to adjust for balance

calculateBaseValue

int calculateBaseValue(Item I)

Calculates the base value of this armor or weapon.

Parameters:

I - the armor or weapon

Returns:

the base value.

itemFix

boolean itemFix(Item I,
                int lvlOr0,
                boolean preferMagic,
                java.lang.StringBuffer changes)

Given an item and a new level or 0, this will adjust the stats of the given item to reflect the desired level or its existing one. It will return a description of the changes if you send a stringbuffer. Obviously, this only works on things like wands, ammunition, weapons, and armor.

Parameters:

I - the item to potentially modify

lvlOr0 - 0 to use the existing level, or a level to adjust the item to

preferMagic - true to prefer adding magical bonuses, false to stay mundane

changes - null, or a strinbuffer to put changes list into

Returns:

true if a change was made, false otherwise

getTimsAdjResCast

java.util.List<Ability> getTimsAdjResCast(Item I)

Returns a list of all the effects on the given item that contribute to its power level.

Parameters:

I - the item to inspect

Returns:

the effects that make it great

enchant

Item enchant(Item I,
             int pct)

Given a percent change, this method MIGHT add an enchantment or cuse of various levels to the give armor, ammunition, or weapon piece.

Parameters:

I - the item to possibly enchant

pct - the % chance to enchant

Returns:

the item again

timsItemAdjustments

java.util.Map<java.lang.String,java.lang.String> timsItemAdjustments(Item I,
                                                                     int level,
                                                                     int material,
                                                                     int hands,
                                                                     int wclass,
                                                                     int reach,
                                                                     long worndata)

Returns a map of key value pairs showing what various combat stats on the given item SHOULD be given the level and other particulars. Weapon key values: MINRANGE, MAXRANGE, DAMAGE, ATTACK, VALUE Armor key values: ARMOR, VALUE, WEIGHT

Parameters:

I - the item type to inspect

level - the level you want the item to be

material - the material of the item

hands - the number of hands for the item (weapon)

wclass - the weapon class

reach - the weapon max range

worndata - the proper worn location bitmap

Returns:

the map of fields