Evolving Items¶
The evolving items system is only available on the Rain of Fear 2 (RoF2) Client.
- Allows for evolving item support for RoF2 only.
- Has a 30 sec timer after equipping an evolving item before it can start to evolve. Time is configurable with a Rule. XP gain is Rule configurable for raid, solo, and group xp.
- Enables the Evolving XP Transfer in Corathus Creep. This is limited at present as I have little information. It currently allows for xp transfer between items that have the same type, and subtype. I can and will update this as feedback comes in.
- PlayerEvent logging is enabled for various functions, namely progression of an item and xp transfer between items.
- Evolving item status remains with the item, and will transfer if an tradeable item is traded.
- There are two gm commands to monitor statis. #evolve target and #evolve item
The system is controlled using the following server rules:
| Category | Rule Name | Default | Description |
|---|---|---|---|
| EvolvingItems | PercentOfSoloExperience | 0.1 | Percentage of solo experience allocated to evolving items that require experience. Default is 0.1% |
| EvolvingItems | PercentOfGroupExperience | 0.1 | Percentage of group experience allocated to evolving items that require experience. Default is 0.1% |
| EvolvingItems | PercentOfRaidExperience | 0.1 | Percentage of solo experience allocated to evolving items that require experience. Default is 0.1% |
| EvolvingItems | DelayUponEquipping | 30000 | Delay in ms before an evolving item will earn rewards after equipping. Default is 30000ms or 30s. |
Installation¶
There are two tables utilized in the functionality.
character_evolving_items¶
This table contains character specific data surrounding the evolving items in the characters possession. If a character trades, deletes, sells, etc an evolving item the deleted_at column is updated. This allows for a history of items that the character has had. Rows are not deleted.
items_evolving_details¶
This table is sourced from the content database and contains the generic evolution data regarding an item. There are several generic columns, though there are three that should be understood:
type References the how the item evolves. Types are sourced in the namespace EvolvingItems::Types and are listed below. This list will be expanded as more is known about evolving items.
| Type | Description |
|---|---|
| 1 | Experience based evolution |
| 2 | Number of Kills |
| 3 | Specific Mob Race |
| 4 | Specific Zone ID |
| SubType | Description |
|---|---|
| 0 | When type = 1, use all experience |
| 1 | When type = 1, use only solo experience |
| 2 | When type = 1, use only group experience |
| 3 | When type = 1, use only raid experience |
| x | When type = 2, NOT YET IMPLEMENTED |
| x | When type = 3, the Mob Race ID of the kill |
| x | When type = 2, the Zone ID where the kill must occur |
| required_amount | Description |
|---|---|
| x | The amount required of the type/subtype combination to evolve that level of the item |
There are two items with presets to demonstrate
Evolution ID 1211 Level 1 is item id 85612 requiring 100,000 of experience from any source Level 2 is item id 85613 requiring 200,000 of experience from any source Level 3 is item id 85614 requiring 300,000 of experience from any source
Evolving ID 1066 Level 1 is item id 89550 requring 500 kills of race id 274 Level 2 is item id 89551 requring 1000 kills of race id 274 Level 3 is item id 89552 requring 2000 kills of race id 274
XP Transfer¶
There is an witch in Corathus Creep who will preform basic transfer of evolving item experience. The current implementation allows for the following:
- If sub_types are the same, the conversion rate is 100% otherwise it is 30%
- The current amount is the total of all the levels currently obtained
If there are any suggests, please create an issue and I can work to add more functionality.
Admin Commands¶
There are several admin commands to assist GMs.
-
#evolve item item_id
This allows the GM to query the details of an item. Example: #evolve item 85613 -
#evolve target
Please ensure to have a player targeted. This is used to display the evolving details for all items that the player has in their possession.
Player Event Logging¶
The following player events are available.
| Rule Name | Default | Retention |
|---|---|---|
| Evolve Item | Enabled | 7 days |
The playerevent has a status field which captures a more detailed explanation. Status messages such as: - Evolved Item due to obtaining progression - Old Evolve Item removed from inventory. - Evolved Item due to obtaining progression - New Evolve Item placed in inventory. - Transfer XP - Original FROM Evolve Item removed from inventory. - Transfer XP - Updated FROM item placed in inventory. - Transfer XP - Original TO Evolve Item removed from inventory. - Transfer XP - Updated TO Evolve item placed in inventory.
Known Issues¶
There are currently no known issues.