Skip to content

mackysoft/Modiferty

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

30 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Modiferty - Property Modification

Created by Hiroya Aramaki (Makihiro)

Tests Build Release openupm

What is Modiferty ?

Modiferty is a great solution for making modifications to properties.

In games, there are often situations in which the status of characters, weapons, etc. temporarily change.

Modiferty can be used in the following situations.

  • Want to modify the in-game character status temporally.

Download any version from releases.

Releases: https://github.com/mackysoft/Modiferty/releases

Add "MackySoft.Modiferty" namespace into using area.

using MackySoft.Modiferty;

The following code implements a temporary increase the character attack power.

public class Character : MonoBehaviour {

	public int health = 3;
	public ModifiableInt attackPower = new ModifiableInt(baseValue: 1);

	public void Attack (Character target){
		target.health -= attackPower.Evaluate();
	}

}

public class PowerUpItem : MonoBehaviour {

	public AdditiveModifierInt additivePower = new AdditiveModifierInt(1);

	public void Modify (Character target){
		target.attackPower.Modifiers.Add(additivePower);

		// Same as below.
		// target.attackPower.AddModifier(additivePower);
	}

}

If you want to modify the value without using ModifiableProperty, use a ModifierList.

ModifierList<int> m_DamageModifiers = new ModifierList<int>;

// Add something modifiers.
m_DamageModifiers.Add(modifier);

// Evaluate the damage.
int evaluatedDamage = m_DamageModifiers.Evaluate(damage);

ModifiableList is also used in the ModifiableProperty implementation.

Basic operator modifiers are provided.

  • Additive Modifier
  • Subtractive Modifier
  • Multiply Modifier
  • Division Modifier

A variety of other unique modifiers are also available.

The given value ignored and the specified value returned.

var setModifier = new SetModifierInt(0);

character.attackPower.AddModifier(setModifier);

// result is always 0.
int result = character.attackPower.Evaluate();

The lambda formula allows you to improvise complex modifiers.

var createModifier = new CreateModifier<int>(value => {
	int result;

	// Do something process...

	return result;
});

Modiferty supports integration with some external assets.

Install UniRx and define MODIFERTY_UNIRX to enable integration with UniRx.

UniRx: https://github.com/neuecc/UniRx

The integration with UniRx mainly adds the following APIs to allow you to observe the values of Modiferty.

  • ReactiveModifierList<T>
  • ReactiveModifiableProperty<T>
using UnityEngine;
using UnityEngine.UI;
using MackySoft.Modiferty;
using UniRx;

public class Character : MonoBehaviour {

	// Define attackPower as ReactiveModifiableProperty.
	public ReactiveModifiableInt attackPower = new ReactiveModifiableInt(baseValue: 1);

	. . . . .

}

public class CharacterAttackPowerUI : MonoBehaviour {

	public Character character;
	public Text attackPowerTsxt;

	void Awake () {
		// You can observe changes BaseValue and Modifiers.
		character.attackPower.ObserveChanged().Subscribe(property => {

			// Apply the attackPower change to the text.
			attackPowerText.text = property.Evaluate();
		});
	}
}

Hiroya Aramaki is a indie game developer in Japan.

This library is under the MIT License.